

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 SPARQL
<a name="sparql-api-status"></a>

Para obter o status das consultas SPARQL, use HTTP `GET` ou `POST` para fazer uma solicitação ao endpoint de `https://your-neptune-endpoint:port/sparql/status`. 

## Parâmetros de solicitação do status de consulta do SPARQL
<a name="sparql-api-status-get-request"></a>

**queryId (opcional)**  
O ID de uma consulta SPARQL em execução. Exibe apenas o status da consulta especificada.

## Sintaxe da resposta do status de consulta do SPARQL
<a name="sparql-api-status-get-response-syntax"></a>

```
{
    "acceptedQueryCount": integer,
    "runningQueryCount": integer,
    "queries": [
      {
        "queryId":"guid",
        "queryEvalStats":
          {
            "subqueries": integer,
            "elapsed": integer,
            "cancelled": boolean
          },
        "queryString": "string"
      }
    ]
}
```

## Valores da resposta do status de consulta do SPARQL
<a name="sparql-api-status-get-response-values"></a>

**acceptedQueryCount**  
O número de consultas aceitas desde o último reinício do mecanismo do Neptune.

**runningQueryCount**  
O número de consultas SPARQL em execução atualmente.

**queries**  
Uma lista de consultas SPARQL atuais.

**queryId**  
Um ID de GUID da consulta. O Neptune atribui automaticamente esse valor de ID a cada consulta, ou você também 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)). 

**queryEvalStats**  
Estatísticas dessa consulta.

**subconsultas**  
Número de subconsultas nesta consulta.

**elapsed**  
O número de milissegundos em que a consulta esteve em execução até agora.

**cancelado**  
Verdadeiro indica que a consulta foi cancelada.

**queryString**  
A consulta enviada.

## Exemplo de status de consulta do SPARQL
<a name="sparql-api-status-get-example"></a>

A seguir está um exemplo de comando de status usando `curl` e HTTP `GET`.

```
curl https://your-neptune-endpoint:port/sparql/status
```

Essa saída mostra uma única consulta em execução.

```
{
    "acceptedQueryCount":9,
    "runningQueryCount":1,
    "queries": [
        {
            "queryId":"fb34cd3e-f37c-4d12-9cf2-03bb741bf54f",
            "queryEvalStats":
                {
                    "subqueries": 0,
                    "elapsed": 29256,
                    "cancelled": false
                },
            "queryString": "SELECT ?s ?p ?o WHERE {?s ?p ?o}"
        }
    ]
}
```