As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# API de status de consulta do Gremlin
Você pode listar todas as consultas ativas do Gremlin ou obter o status de uma consulta específica. O endpoint HTTP subjacente para ambas as operações é`https://{{your-neptune-endpoint}}:{{port}}/gremlin/status`.
## Listando consultas ativas do Gremlin
Para listar todas as consultas ativas do Gremlin, chame o endpoint sem nenhum parâmetro. `queryId`
### Parâmetros de solicitação
+ **IncludeWaiting** (*opcional*) — Se definida como`TRUE`, a resposta inclui consultas em espera, além de consultas em execução.
### Sintaxe da resposta
```
{
"acceptedQueryCount": integer,
"runningQueryCount": integer,
"queries": [
{
"queryId": "guid",
"queryEvalStats": {
"waited": integer,
"elapsed": integer,
"cancelled": boolean
},
"queryString": "string"
}
]
}
```
+ **acceptedQueryCount**— O número de consultas que foram aceitas, mas ainda não concluídas, incluindo consultas na fila.
+ **runningQueryCount**— O número de consultas do Gremlin atualmente em execução.
+ **queries**: uma lista de consultas do Gremlin atuais.
### Exemplo
------
#### [ AWS CLI ]
```
aws neptunedata list-gremlin-queries \
--endpoint-url https://{{your-neptune-endpoint}}:{{port}}
```
Para obter mais informações, consulte [list-gremlin-queries](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/list-gremlin-queries.html)na Referência 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 exemplos de AWS SDK em outras linguagens, como Java, .NET e muito mais, 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**
Este exemplo pressupõe que suas AWS credenciais estejam configuradas em seu ambiente. {{us-east-1}}Substitua pela região do seu cluster Neptune.
Para obter mais informações sobre como usar **awscurl** com a autenticação do IAM, consulte[Usar `awscurl` com credenciais temporárias para se conectar com segurança a um cluster de banco de dados com a autenticação do IAM habilitada](iam-auth-connect-command-line.md#iam-auth-connect-awscurl).
------
#### [ curl ]
```
curl https://{{your-neptune-endpoint}}:{{port}}/gremlin/status
```
------
A saída a seguir mostra uma única consulta em execução.
```
{
"acceptedQueryCount": 9,
"runningQueryCount": 1,
"queries": [
{
"queryId": "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
"queryEvalStats": {
"waited": 0,
"elapsed": 23,
"cancelled": false
},
"queryString": "g.V().out().count()"
}
]
}
```
## Obter o status de uma consulta específica do Gremlin
Para obter o status de uma consulta específica do Gremlin, forneça o `queryId` parâmetro.
### Parâmetros de solicitação
+ **queryID** *(*obrigatório) — O ID da consulta Gremlin. O Neptune atribui automaticamente esse valor de ID a cada consulta, ou você pode atribuir seu próprio ID (consulte). [Injetar um ID personalizado em uma consulta do Gremlin ou do SPARQL no Neptune](features-query-id.md)
### Sintaxe da resposta
```
{
"queryId": "guid",
"queryString": "string",
"queryEvalStats": {
"waited": integer,
"elapsed": integer,
"cancelled": boolean,
"subqueries": document
}
}
```
+ **queryID** — O ID da consulta.
+ **queryString**: a consulta enviada. Ela será truncada para 1024 caracteres se for maior do que isso.
+ **queryEvalStats**— Estatísticas da consulta, incluindo `waited` (tempo de espera em milissegundos), `elapsed` (tempo de execução em milissegundos), `cancelled` (se a consulta foi cancelada) e `subqueries` (o número de subconsultas).
### Exemplo
------
#### [ AWS CLI ]
```
aws neptunedata get-gremlin-query-status \
--endpoint-url https://{{your-neptune-endpoint}}:{{port}} \
--query-id "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f"
```
Para obter mais informações, consulte [get-gremlin-query-status](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/get-gremlin-query-status.html)na Referência 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 exemplos de AWS SDK em outras linguagens, como Java, .NET e muito mais, 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**
Este exemplo pressupõe que suas AWS credenciais estejam configuradas em seu ambiente. {{us-east-1}}Substitua pela região do seu cluster Neptune.
Para obter mais informações sobre como usar **awscurl** com a autenticação do IAM, consulte[Usar `awscurl` com credenciais temporárias para se conectar com segurança a um cluster de banco de dados com a autenticação do 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
```
------
O seguinte é um exemplo de resposta.
```
{
"queryId": "fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
"queryString": "g.V().out().count()",
"queryEvalStats": {
"waited": 0,
"elapsed": 23,
"cancelled": false
}
}
```