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á.

# Cancelamento de consulta do SPARQL
<a name="sparql-api-status-cancel"></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 cancelamento da consulta do SPARQL
<a name="sparql-api-status-cancel-request"></a>

**cancelQuery**  
(Obrigatório) Ordena ao comando de status para cancelar uma consulta. Esse parâmetro não usa um valor.

**queryId**  
(Obrigatório) O ID da consulta SPARQL em execução a ser cancelada.

**silent**  
(Opcional) Se `silent=true`, a consulta em execução será cancelada e o código de resposta HTTP será 200. Se `silent` não estiver presente ou `silent=false`, a consulta será cancelada com um código de status HTTP 500.

## Exemplos de cancelamento de consultas do SPARQL
<a name="sparql-api-status-cancel-example"></a>

**Exemplo 1: cancelamento com `silent=false`**  
Veja a seguir um exemplo do comando de status que usa `curl` para cancelar uma consulta com o parâmetro `silent` definido como `false`:

```
curl https://your-neptune-endpoint:port/sparql/status \
  -d "cancelQuery" \
  -d "queryId=4d5c4fae-aa30-41cf-9e1f-91e6b7dd6f47" \
  -d "silent=false"
```

A menos que a consulta já tenha iniciado os resultados de streaming, a consulta cancelada retornaria um código HTTP 500 com uma resposta como esta:

```
{
  "code": "CancelledByUserException",
  "requestId": "4d5c4fae-aa30-41cf-9e1f-91e6b7dd6f47",
  "detailedMessage": "Operation terminated (cancelled by user)"
}
```

Se a consulta já retornou um código HTTP 200 (OK) e iniciou os resultados de streaming antes de ser cancelada, as informações de exceção de tempo limite serão enviadas para o fluxo de saída normal.

**Exemplo 2: cancelamento com `silent=true`**  
Veja a seguir um exemplo do mesmo comando de status acima, com a exceção de que o parâmetro `silent` agora está definido como `true`:

```
curl https://your-neptune-endpoint:port/sparql/status \
  -d "cancelQuery" \
  -d "queryId=4d5c4fae-aa30-41cf-9e1f-91e6b7dd6f47" \
  -d "silent=true"
```

Esse comando retornaria a mesma resposta de quando `silent=false`, mas a consulta cancelada agora retornaria um código HTTP 200 com uma resposta como esta:

```
{
  "head" : {
    "vars" : [ "s", "p", "o" ]
  },
  "results" : {
    "bindings" : [ ]
  }
}
```