

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.

# Cancelación de consultas SPARQL
<a name="sparql-api-status-cancel"></a>

Para obtener el estado de las consultas SPARQL, utilice HTTP `GET` o `POST` para realizar una solicitud al punto de enlace `https://your-neptune-endpoint:port/sparql/status`.

## Parámetros de solicitud de cancelación de consultas SPARQL
<a name="sparql-api-status-cancel-request"></a>

**cancelQuery**  
Indica al comando de estado que cancele una consulta (obligatorio). Este parámetro no selecciona un valor.

**queryId**  
El ID de la consulta SPARQL en ejecución que se va a cancelar (obligatorio).

**silent**  
Si es `silent=true`, se cancela la consulta en ejecución y el código de respuesta HTTP es 200 (opcional). Si `silent` no está presente o `silent=false`, la consulta se cancela con un código de estado HTTP 500.

## Ejemplos de cancelación de consultas SPARQL
<a name="sparql-api-status-cancel-example"></a>

**Ejemplo 1: Cancelación con `silent=false`**  
A continuación se muestra un ejemplo de comando de estado que utiliza `curl` para cancelar una consulta con el parámetro `silent` establecido en `false`:

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

A menos que la consulta ya haya comenzado a transmitir resultados, la consulta cancelada devolvería un código HTTP 500 con una respuesta como esta:

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

Si la consulta ya ha devuelto un código HTTP 200 (OK) y ha iniciado la transmisión de resultados antes de su cancelación, la información de excepción de tiempo de espera se enviará a la secuencia de salida normal.

**Ejemplo 2: Cancelación con `silent=true`**  
A continuación se muestra un ejemplo del mismo comando de estado que el anterior, excepto con el parámetro `silent` ahora establecido en `true`:

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

Este comando devolvería la misma respuesta que con `silent=false`, pero la consulta cancelada devolvería ahora un código HTTP 200 con una respuesta similar a la siguiente:

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