Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# API de statut des requêtes Gremlin
Vous pouvez répertorier toutes les requêtes Gremlin actives ou obtenir le statut d'une requête spécifique. Le point de terminaison HTTP sous-jacent pour les deux opérations est`https://your-neptune-endpoint:port/gremlin/status`.
## Répertorier les requêtes Gremlin actives
Pour répertorier toutes les requêtes Gremlin actives, appelez le point de terminaison sans `queryId` paramètre.
### Paramètres de demande
+ **IncludeWaiting** (*facultatif*) — Si cette valeur est définie sur`TRUE`, la réponse inclut les requêtes en attente en plus des requêtes en cours d'exécution.
### Syntaxe de réponse
```
{
"acceptedQueryCount": integer,
"runningQueryCount": integer,
"queries": [
{
"queryId": "guid",
"queryEvalStats": {
"waited": integer,
"elapsed": integer,
"cancelled": boolean
},
"queryString": "string"
}
]
}
```
+ **acceptedQueryCount**— Le nombre de requêtes acceptées mais non encore terminées, y compris les requêtes dans la file d'attente.
+ **runningQueryCount**— Le nombre de requêtes Gremlin en cours d'exécution.
+ **queries** : requêtes Gremlin actuelles.
### Exemple
------
#### [ AWS CLI ]
```
aws neptunedata list-gremlin-queries \
--endpoint-url https://your-neptune-endpoint:port
```
Pour plus d'informations, consultez [list-gremlin-queries](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/list-gremlin-queries.html)le manuel de référence des AWS CLI commandes.
------
#### [ 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)
```
Pour des exemples de AWS SDK dans d'autres langages tels que Java, .NET, etc., consultez[AWS SDK](access-graph-gremlin-sdk.md).
------
#### [ awscurl ]
```
awscurl https://your-neptune-endpoint:port/gremlin/status \
--region us-east-1 \
--service neptune-db
```
**Note**
Cet exemple suppose que vos AWS informations d'identification sont configurées dans votre environnement. Remplacez *us-east-1* par la région de votre cluster Neptune.
Pour plus d'informations sur l'utilisation **awscurl** de l'authentification IAM, consultez[Utilisation d'informations d'identification temporaires `awscurl` pour se connecter en toute sécurité à un cluster de bases de données avec l'authentification IAM activée](iam-auth-connect-command-line.md#iam-auth-connect-awscurl).
------
#### [ curl ]
```
curl https://your-neptune-endpoint:port/gremlin/status
```
------
Le résultat suivant montre une seule requête en cours d'exécution.
```
{
"acceptedQueryCount": 9,
"runningQueryCount": 1,
"queries": [
{
"queryId": "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
"queryEvalStats": {
"waited": 0,
"elapsed": 23,
"cancelled": false
},
"queryString": "g.V().out().count()"
}
]
}
```
## Obtenir le statut d'une requête Gremlin spécifique
Pour obtenir le statut d'une requête Gremlin spécifique, indiquez le `queryId` paramètre.
### Paramètres de demande
+ **queryID** *(*obligatoire) — L'ID de la requête Gremlin. Neptune attribue automatiquement cette valeur d'identifiant à chaque requête, ou vous pouvez attribuer votre propre identifiant (voir). [Injection d'un ID personnalisé dans une requête Neptune Gremlin ou SPARQL](features-query-id.md)
### Syntaxe de réponse
```
{
"queryId": "guid",
"queryString": "string",
"queryEvalStats": {
"waited": integer,
"elapsed": integer,
"cancelled": boolean,
"subqueries": document
}
}
```
+ **queryID** — L'ID de la requête.
+ **queryString** : requête soumise. Celle-ci est tronquée à 1 024 caractères si elle est plus longue que cela.
+ **queryEvalStats**— Statistiques relatives à la requête, notamment `waited` (temps d'attente en millisecondes), `elapsed` (temps d'exécution en millisecondes), `cancelled` (si la requête a été annulée) et `subqueries` (nombre de sous-requêtes).
### Exemple
------
#### [ AWS CLI ]
```
aws neptunedata get-gremlin-query-status \
--endpoint-url https://your-neptune-endpoint:port \
--query-id "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f"
```
Pour plus d'informations, consultez [get-gremlin-query-status](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/get-gremlin-query-status.html)le manuel de référence des AWS CLI commandes.
------
#### [ 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)
```
Pour des exemples de AWS SDK dans d'autres langages tels que Java, .NET, etc., consultez[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
```
**Note**
Cet exemple suppose que vos AWS informations d'identification sont configurées dans votre environnement. Remplacez *us-east-1* par la région de votre cluster Neptune.
Pour plus d'informations sur l'utilisation **awscurl** de l'authentification IAM, consultez[Utilisation d'informations d'identification temporaires `awscurl` pour se connecter en toute sécurité à un cluster de bases de données avec l'authentification IAM activée](iam-auth-connect-command-line.md#iam-auth-connect-awscurl).
------
#### [ curl ]
```
curl https://your-neptune-endpoint:port/gremlin/status/fb34cd3e-f37c-4d12-9cf2-03bb741bf54f
```
------
Voici un exemple de réponse.
```
{
"queryId": "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
"queryString": "g.V().out().count()",
"queryEvalStats": {
"waited": 0,
"elapsed": 23,
"cancelled": false
}
}
```