GetEngineStatus
Retrieves the status of the graph database on the host.
When invoking this operation in a Neptune cluster that has IAM authentication enabled, the IAM user or role making the request must have a policy attached that allows the neptune-db:GetEngineStatus IAM action in that cluster.
Request Syntax
GET /status HTTP/1.1
URI Request Parameters
The request does not use any URI parameters.
Request Body
The request does not have a request body.
Response Syntax
HTTP/1.1 200
Content-type: application/json
{
"dbEngineVersion": "string",
"dfeQueryEngine": "string",
"features": {
"string" : JSON value
},
"gremlin": {
"version": "string"
},
"labMode": {
"string" : "string"
},
"opencypher": {
"version": "string"
},
"role": "string",
"rollingBackTrxCount": number,
"rollingBackTrxEarliestStartTime": "string",
"settings": {
"string" : "string"
},
"sparql": {
"version": "string"
},
"startTime": "string",
"status": "string"
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- dbEngineVersion
-
Set to the Neptune engine version running on your DB cluster. If this engine version has been manually patched since it was released, the version number is prefixed by
Patch-
.Type: String
- dfeQueryEngine
-
Set to
enabled
if the DFE engine is fully enabled, or toviaQueryHint
(the default) if the DFE engine is only used with queries that have theuseDFE
query hint set totrue
.Type: String
- features
-
Contains status information about the features enabled on your DB cluster.
Type: String to JSON value map
- gremlin
-
Contains information about the Gremlin query language available on your cluster. Specifically, it contains a version field that specifies the current TinkerPop version being used by the engine.
Type: QueryLanguageVersion object
- labMode
-
Contains Lab Mode settings being used by the engine.
Type: String to string map
- opencypher
-
Contains information about the openCypher query language available on your cluster. Specifically, it contains a version field that specifies the current operCypher version being used by the engine.
Type: QueryLanguageVersion object
- role
-
Set to
reader
if the instance is a read-replica, or towriter
if the instance is the primary instance.Type: String
- rollingBackTrxCount
-
If there are transactions being rolled back, this field is set to the number of such transactions. If there are none, the field doesn't appear at all.
Type: Integer
- rollingBackTrxEarliestStartTime
-
Set to the start time of the earliest transaction being rolled back. If no transactions are being rolled back, the field doesn't appear at all.
Type: String
- settings
-
Contains information about the current settings on your DB cluster. For example, contains the current cluster query timeout setting (
clusterQueryTimeoutInMs
).Type: String to string map
- sparql
-
Contains information about the SPARQL query language available on your cluster. Specifically, it contains a version field that specifies the current SPARQL version being used by the engine.
Type: QueryLanguageVersion object
- startTime
-
Set to the UTC time at which the current server process started.
Type: String
- status
-
Set to
healthy
if the instance is not experiencing problems. If the instance is recovering from a crash or from being rebooted and there are active transactions running from the latest server shutdown, status is set torecovery
.Type: String
Errors
For information about the errors that are common to all actions, see Common Errors.
- ClientTimeoutException
-
Raised when a request timed out in the client.
HTTP Status Code: 408
- ConstraintViolationException
-
Raised when a value in a request field did not satisfy required constraints.
HTTP Status Code: 400
- IllegalArgumentException
-
Raised when an argument in a request is not supported.
HTTP Status Code: 400
- InternalFailureException
-
Raised when the processing of the request failed unexpectedly.
HTTP Status Code: 500
- InvalidArgumentException
-
Raised when an argument in a request has an invalid value.
HTTP Status Code: 400
- PreconditionsFailedException
-
Raised when a precondition for processing a request is not satisfied.
HTTP Status Code: 400
- TooManyRequestsException
-
Raised when the number of requests being processed exceeds the limit.
HTTP Status Code: 429
- UnsupportedOperationException
-
Raised when a request attempts to initiate an operation that is not supported.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: