asterixdb-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ima...@apache.org
Subject incubator-asterixdb git commit: Doc updates to HTTP API
Date Wed, 29 Jul 2015 19:02:13 GMT
Repository: incubator-asterixdb
Updated Branches:
  refs/heads/master f41b34b6b -> ce91b9a6b


Doc updates to HTTP API

-Rename "REST" API to HTTP API
-Minor documentation for /aql endpoint

Change-Id: I5c6520495752da312f4db7641fcfd14f7d63c829
Reviewed-on: https://asterix-gerrit.ics.uci.edu/331
Tested-by: Jenkins <jenkins@fulliautomatix.ics.uci.edu>
Reviewed-by: Chris Hillery <ceej@lambda.nu>


Project: http://git-wip-us.apache.org/repos/asf/incubator-asterixdb/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-asterixdb/commit/ce91b9a6
Tree: http://git-wip-us.apache.org/repos/asf/incubator-asterixdb/tree/ce91b9a6
Diff: http://git-wip-us.apache.org/repos/asf/incubator-asterixdb/diff/ce91b9a6

Branch: refs/heads/master
Commit: ce91b9a6b8e48998e2df1ac082b1f7671929be8d
Parents: f41b34b
Author: Ian Maxon <imaxon@apache.org>
Authored: Tue Jul 28 18:03:46 2015 -0700
Committer: Chris Hillery <ceej@lambda.nu>
Committed: Tue Jul 28 18:54:07 2015 -0700

----------------------------------------------------------------------
 asterix-doc/src/site/markdown/api.md | 32 ++++++++++++++++++++++++++++++-
 asterix-doc/src/site/site.xml        |  2 +-
 2 files changed, 32 insertions(+), 2 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-asterixdb/blob/ce91b9a6/asterix-doc/src/site/markdown/api.md
----------------------------------------------------------------------
diff --git a/asterix-doc/src/site/markdown/api.md b/asterix-doc/src/site/markdown/api.md
index 4d6edd2..4f7aca2 100644
--- a/asterix-doc/src/site/markdown/api.md
+++ b/asterix-doc/src/site/markdown/api.md
@@ -1,10 +1,11 @@
-# REST API to AsterixDB #
+# HTTP API to AsterixDB #
 
 ## <a id="toc">Table of Contents</a>
 
 * [DDL API](#DdlApi)
 * [Update API](#UpdateApi)
 * [Query API](#QueryApi)
+* [Mixed API](#AnyApi)
 * [Asynchronous Result API](#AsynchronousResultApi)
 * [Query Status API](#QueryStatusApi)
 * [Error Codes](#ErrorCodes)
@@ -179,6 +180,35 @@ Payload
         }
 
 
+## <a id="AnyApi">Mixed API</a> <font size="4"><a href="#toc">[Back
to TOC]</a></font> ##
+
+*End point for any/mixed statement*
+
+Endpoint: _/aql_
+
+Parameters:
+
+<table>
+<tr>
+  <td>Parameter</td>
+  <td>Description</td>
+  <td>Required?</td>
+</tr>
+<tr>
+  <td>query</td>
+  <td>Query string to pass to ASTERIX for execution</td>
+  <td>Yes</td>
+</tr>
+<tr>
+  <td>mode</td>
+  <td>Indicate if call should be synchronous or asynchronous. mode = synchronous blocks
the call until results are available; mode = asynchronous returns immediately with a handle
that can be used later to check the query’s status and to fetch results when available</td>
+  <td>No. default mode = synchronous</td>
+</tr>
+</table>
+
+Similar to *_/update_* but allows any arbitrary AQL statement rather than only modifications.
+
+
 ## <a id="AsynchronousResultApi">Asynchronous Result API</a> <font size="4"><a
href="#toc">[Back to TOC]</a></font> ##
 
 *End point to fetch the results of an asynchronous query*

http://git-wip-us.apache.org/repos/asf/incubator-asterixdb/blob/ce91b9a6/asterix-doc/src/site/site.xml
----------------------------------------------------------------------
diff --git a/asterix-doc/src/site/site.xml b/asterix-doc/src/site/site.xml
index 3e81a25..aaa73fc 100644
--- a/asterix-doc/src/site/site.xml
+++ b/asterix-doc/src/site/site.xml
@@ -81,7 +81,7 @@
       <item name="AQL Support of Similarity Queries" href="aql/similarity.html"/>
       <item name="Accessing External Data" href="aql/externaldata.html"/>
       <item name="Filter-Based LSM Index Acceleration" href="aql/filters.html"/>
-      <item name="REST API to AsterixDB" href="api.html"/>
+      <item name="HTTP API to AsterixDB" href="api.html"/>
     </menu>
 
     <menu ref="reports"/>


Mime
View raw message