Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# API del estado de la consulta de Gremlin
Puedes enumerar todas las consultas de Gremlin activas u obtener el estado de una consulta específica. El punto final HTTP subyacente para ambas operaciones es. `https://your-neptune-endpoint:port/gremlin/status`
## Listar las consultas de Gremlin activas
Para ver una lista de todas las consultas de Gremlin activas, llama al punto final sin ningún `queryId` parámetro.
### Parámetros de solicitud
+ **includeWaiting** (*opcional*): si se establece en`TRUE`, la respuesta incluye las consultas en espera además de las consultas en ejecución.
### Sintaxis de la respuesta
```
{
"acceptedQueryCount": integer,
"runningQueryCount": integer,
"queries": [
{
"queryId": "guid",
"queryEvalStats": {
"waited": integer,
"elapsed": integer,
"cancelled": boolean
},
"queryString": "string"
}
]
}
```
+ **acceptedQueryCount**— El número de consultas que se han aceptado pero que aún no se han completado, incluidas las consultas de la cola.
+ **runningQueryCount**— El número de consultas de Gremlin que se están ejecutando actualmente.
+ **queries**: una lista de las consultas de Gremlin actuales.
### Ejemplo
------
#### [ AWS CLI ]
```
aws neptunedata list-gremlin-queries \
--endpoint-url https://your-neptune-endpoint:port
```
Para obtener más información, consulte la [list-gremlin-queries](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/list-gremlin-queries.html)Referencia de AWS CLI comandos.
------
#### [ 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)
```
Para ver ejemplos de AWS SDK en otros lenguajes, como Java, .NET y más, consulte[AWS SDK](access-graph-gremlin-sdk.md).
------
#### [ awscurl ]
```
awscurl https://your-neptune-endpoint:port/gremlin/status \
--region us-east-1 \
--service neptune-db
```
**nota**
En este ejemplo se supone que sus AWS credenciales están configuradas en su entorno. *us-east-1*Sustitúyala por la región de tu cúmulo de Neptuno.
Para obtener más información sobre el uso **awscurl** con la autenticación de IAM, consulte. [Uso de `awscurl` con credenciales temporales para conectarse de forma segura a un clúster de base de datos con la autenticación de IAM habilitada](iam-auth-connect-command-line.md#iam-auth-connect-awscurl)
------
#### [ curl ]
```
curl https://your-neptune-endpoint:port/gremlin/status
```
------
El siguiente resultado muestra una única consulta en ejecución.
```
{
"acceptedQueryCount": 9,
"runningQueryCount": 1,
"queries": [
{
"queryId": "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
"queryEvalStats": {
"waited": 0,
"elapsed": 23,
"cancelled": false
},
"queryString": "g.V().out().count()"
}
]
}
```
## Obtener el estado de una consulta de Gremlin específica
Para obtener el estado de una consulta de Gremlin específica, proporciona el `queryId` parámetro.
### Parámetros de solicitud
+ **queryID** *(*obligatorio): el ID de la consulta de Gremlin. Neptune asigna automáticamente este valor de ID a cada consulta, o usted puede asignar su propio ID (consulte). [Inserte un identificador personalizado en una consulta de Neptune Gremlin o SPARQL](features-query-id.md)
### Sintaxis de la respuesta
```
{
"queryId": "guid",
"queryString": "string",
"queryEvalStats": {
"waited": integer,
"elapsed": integer,
"cancelled": boolean,
"subqueries": document
}
}
```
+ **queryID**: el ID de la consulta.
+ **queryString**: la consulta enviada. Esta se trunca en 1024 caracteres, si supera este número.
+ **queryEvalStats**— Estadísticas de la consulta, que incluyen `waited` (tiempo de espera en milisegundos), `elapsed` (tiempo de ejecución en milisegundos), `cancelled` (si la consulta se canceló) y `subqueries` (número de subconsultas).
### Ejemplo
------
#### [ AWS CLI ]
```
aws neptunedata get-gremlin-query-status \
--endpoint-url https://your-neptune-endpoint:port \
--query-id "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f"
```
Para obtener más información, consulte [get-gremlin-query-status](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/get-gremlin-query-status.html)la Referencia de AWS CLI comandos.
------
#### [ 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)
```
Para ver ejemplos de AWS SDK en otros lenguajes, como Java, .NET y más, consulte[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
```
**nota**
En este ejemplo se supone que sus AWS credenciales están configuradas en su entorno. *us-east-1*Sustitúyala por la región de tu cúmulo de Neptuno.
Para obtener más información sobre el uso **awscurl** con la autenticación de IAM, consulte. [Uso de `awscurl` con credenciales temporales para conectarse de forma segura a un clúster de base de datos con la autenticación de IAM habilitada](iam-auth-connect-command-line.md#iam-auth-connect-awscurl)
------
#### [ curl ]
```
curl https://your-neptune-endpoint:port/gremlin/status/fb34cd3e-f37c-4d12-9cf2-03bb741bf54f
```
------
A continuación, se muestra un ejemplo de respuesta.
```
{
"queryId": "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
"queryString": "g.V().out().count()",
"queryEvalStats": {
"waited": 0,
"elapsed": 23,
"cancelled": false
}
}
```