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"
}
]
}
```
+ **akzeptiert QueryCount** — Die Anzahl der Abfragen, die akzeptiert, aber noch nicht abgeschlossen wurden, einschließlich Abfragen in der Warteschlange.
+ **laufend QueryCount** — 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 unter [list-gremlin-queries](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/list-gremlin-queries.html) in der Befehlsreferenz. 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.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, um eine sichere Verbindung zu einem DB-Cluster mit aktivierter IAM-Authentifizierung herzustellen](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.
+ **query EvalStats** — Statistiken für die Abfrage, einschließlich `waited` (Wartezeit in Millisekunden), `elapsed` (Laufzeit in Millisekunden), (ob die Abfrage abgebrochen wurde) und `cancelled` (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 unter get-gremlin-query-status in der Befehlsreferenz.](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, um eine sichere Verbindung zu einem DB-Cluster mit aktivierter IAM-Authentifizierung herzustellen](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
}
}
```