Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Gremlin-Abfragestatus-API
Sie können alle aktiven Gremlin-Abfragen auflisten oder den Status einer bestimmten Abfrage abrufen. Der zugrunde liegende HTTP-Endpunkt für beide Operationen ist. `https://your-neptune-endpoint:port/gremlin/status`
## Liste der aktiven Gremlin-Abfragen
Um alle aktiven Gremlin-Abfragen aufzulisten, rufen Sie den Endpunkt ohne `queryId` Parameter auf.
### Anforderungsparameter
+ **includeWaiting** (*optional*) — Wenn auf gesetzt`TRUE`, umfasst die Antwort neben laufenden Abfragen auch wartende Abfragen.
### Antwortsyntax
```
{
"acceptedQueryCount": integer,
"runningQueryCount": integer,
"queries": [
{
"queryId": "guid",
"queryEvalStats": {
"waited": integer,
"elapsed": integer,
"cancelled": boolean
},
"queryString": "string"
}
]
}
```
+ **acceptedQueryCount**— Die Anzahl der Abfragen, die akzeptiert, aber noch nicht abgeschlossen wurden, einschließlich Abfragen in der Warteschlange.
+ **runningQueryCount**— Die Anzahl der aktuell laufenden Gremlin-Abfragen.
+ **queries** – Eine Liste der aktuellen Gremlin-Abfragen.
### Beispiel
------
#### [ AWS CLI ]
```
aws neptunedata list-gremlin-queries \
--endpoint-url https://your-neptune-endpoint:port
```
Weitere Informationen finden Sie [list-gremlin-queries](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/list-gremlin-queries.html)in der AWS CLI Befehlsreferenz.
------
#### [ SDK ]
```
import boto3
from botocore.config import Config
client = boto3.client(
'neptunedata',
endpoint_url='https://your-neptune-endpoint:port',
config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)
response = client.list_gremlin_queries()
print(response)
```
AWS SDK-Beispiele in anderen Sprachen wie Java, .NET und mehr finden Sie unter[AWS SDK](access-graph-gremlin-sdk.md).
------
#### [ awscurl ]
```
awscurl https://your-neptune-endpoint:port/gremlin/status \
--region us-east-1 \
--service neptune-db
```
**Anmerkung**
In diesem Beispiel wird davon ausgegangen, dass Ihre AWS Anmeldeinformationen in Ihrer Umgebung konfiguriert sind. Ersetze es *us-east-1* durch die Region deines Neptun-Clusters.
Weitere Informationen zur Verwendung **awscurl** mit der IAM-Authentifizierung finden Sie unter. [Verwenden von `awscurl` mit temporären Anmeldeinformationen für sichere Verbindungen zu DB-Clustern mit aktivierter IAM-Authentifizierung](iam-auth-connect-command-line.md#iam-auth-connect-awscurl)
------
#### [ curl ]
```
curl https://your-neptune-endpoint:port/gremlin/status
```
------
Die folgende Ausgabe zeigt eine einzelne laufende Abfrage.
```
{
"acceptedQueryCount": 9,
"runningQueryCount": 1,
"queries": [
{
"queryId": "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
"queryEvalStats": {
"waited": 0,
"elapsed": 23,
"cancelled": false
},
"queryString": "g.V().out().count()"
}
]
}
```
## Den Status einer bestimmten Gremlin-Abfrage abrufen
Um den Status einer bestimmten Gremlin-Abfrage abzurufen, geben Sie den Parameter an`queryId`.
### Anforderungsparameter
+ **queryId** (*erforderlich*) — Die ID der Gremlin-Abfrage. Neptune weist diesen ID-Wert automatisch jeder Abfrage zu, oder Sie können Ihre eigene ID zuweisen (siehe). [Einfügen einer benutzerdefinierten ID in eine Neptune-Gremlin- oder -SPARQL-Abfrage](features-query-id.md)
### Antwortsyntax
```
{
"queryId": "guid",
"queryString": "string",
"queryEvalStats": {
"waited": integer,
"elapsed": integer,
"cancelled": boolean,
"subqueries": document
}
}
```
+ **queryId** — Die ID der Abfrage.
+ **queryString** – Die übermittelte Abfrage. Die Abfrage wird nach 1024 Zeichen abgeschnitten, wenn sie länger ist.
+ **queryEvalStats**— Statistiken für die Abfrage, einschließlich `waited` (Wartezeit in Millisekunden), `elapsed` (Laufzeit in Millisekunden), `cancelled` (ob die Abfrage abgebrochen wurde) und (Anzahl der Unterabfragen). `subqueries`
### Beispiel
------
#### [ AWS CLI ]
```
aws neptunedata get-gremlin-query-status \
--endpoint-url https://your-neptune-endpoint:port \
--query-id "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f"
```
Weitere Informationen finden Sie in der Befehlsreferenz. [get-gremlin-query-status](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/get-gremlin-query-status.html) AWS CLI
------
#### [ SDK ]
```
import boto3
from botocore.config import Config
client = boto3.client(
'neptunedata',
endpoint_url='https://your-neptune-endpoint:port',
config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)
response = client.get_gremlin_query_status(
queryId='fb34cd3e-f37c-4d12-9cf2-03bb741bf54f'
)
print(response)
```
AWS SDK-Beispiele in anderen Sprachen wie Java, .NET und mehr finden Sie unter[AWS SDK](access-graph-gremlin-sdk.md).
------
#### [ awscurl ]
```
awscurl https://your-neptune-endpoint:port/gremlin/status/fb34cd3e-f37c-4d12-9cf2-03bb741bf54f \
--region us-east-1 \
--service neptune-db
```
**Anmerkung**
In diesem Beispiel wird davon ausgegangen, dass Ihre AWS Anmeldeinformationen in Ihrer Umgebung konfiguriert sind. Ersetze es *us-east-1* durch die Region deines Neptun-Clusters.
Weitere Informationen zur Verwendung **awscurl** mit der IAM-Authentifizierung finden Sie unter. [Verwenden von `awscurl` mit temporären Anmeldeinformationen für sichere Verbindungen zu DB-Clustern mit aktivierter IAM-Authentifizierung](iam-auth-connect-command-line.md#iam-auth-connect-awscurl)
------
#### [ curl ]
```
curl https://your-neptune-endpoint:port/gremlin/status/fb34cd3e-f37c-4d12-9cf2-03bb741bf54f
```
------
Nachfolgend finden Sie eine Beispielantwort.
```
{
"queryId": "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
"queryString": "g.V().out().count()",
"queryEvalStats": {
"waited": 0,
"elapsed": 23,
"cancelled": false
}
}
```