Amazon Neptune
User Guide (API Version 2017-11-29)

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

The Gremlin Query Status API

To get the status of Gremlin queries, use HTTP GET or POST to make a request to the https://your-neptune-endpoint:port/gremlin/status endpoint.

Gremlin Query Status Request Parameters

queryId (optional)

The ID of a running Gremlin query. Only displays the status of the specified query.

includeWaiting (optional)

Normally, only running queries are included in the response. When the includeWaiting parameter is specified, the status of all waiting queries is also returned.

Gremlin Query Status Response Syntax

{ "acceptedQueryCount": integer, "runningQueryCount": integer, "queries": [ { "queryId":"guid", "queryEvalStats": { "waited": integer, "elapsed": integer, "cancelled": boolean }, "queryString": "string" } ] }

Gremlin Query Status Response Values

acceptedQueryCount

The number of queries successfully submitted.

runningQueryCount

The number of currently running Gremlin queries.

queries

A list of the current Gremlin queries.

queryId

A GUID id for the query.

queryEvalStats

Statistics for this query.

subqueries

Number of subqueries in this query.

elapsed

The number of milliseconds the query has been running so far.

cancelled

True indicates that the query was cancelled.

queryString

The submitted query. This is truncated to 1024 characters if it is longer than that.

waited

Indicates how long the query waited, in microseconds.

Gremlin Query Status Example

The following is an example of the status command using curl and HTTP GET.

curl https://your-neptune-endpoint:port/gremlin/status

This output shows a single running query.

{ "acceptedQueryCount":9, "runningQueryCount":1, "queries": [ { "queryId":"fb34cd3e-f37c-4d12-9cf2-03bb741bf54f", "queryEvalStats": { "waited": 0, "elapsed": 23, "cancelled": false }, "queryString": "g.V().addV()" } ] }