Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Annullamento della query SPARQL
<a name="sparql-api-status-cancel"></a>

Per ottenere lo stato delle query SPARQL, utilizza l'operazione HTTP `GET` o `POST` per effettuare una richiesta all'endpoint `https://your-neptune-endpoint:port/sparql/status`.

## Parametri della richiesta di annullamento delle query SPARQL
<a name="sparql-api-status-cancel-request"></a>

**cancelQuery**  
(Obbligatorio) Indica al comando di stato di annullare una query. Questo parametro non accetta un valore.

**queryId**  
(Obbligatorio) L'ID della query SPARQL in esecuzione da annullare.

**silent**  
(Facoltativo) Se `silent=true`, la query in esecuzione viene annullata e il codice di risposta HTTP è 200. Se `silent` non è presente o `silent=false`, la query viene annullata con un codice di stato HTTP 500.

## Esempi di annullamento di query SPARQL
<a name="sparql-api-status-cancel-example"></a>

**Esempio 1: annullamento con `silent=false`**  
Di seguito è riportato un esempio del comando di stato che utilizza `curl` per annullare una query con il parametro `silent` impostato su `false`:

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

A meno che la query non abbia già avviato i risultati in streaming, la query annullata restituirebbe un codice HTTP 500 con una risposta come questa:

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

Se la query ha già restituito un codice HTTP 200 (OK) e ha iniziato lo streaming dei risultati prima di essere annullata, le informazioni sull'eccezione di timeout vengono inviate al flusso di output normale.

**Esempio 2: annullamento con `silent=true`**  
Di seguito è riportato un esempio dello stesso comando di stato di cui sopra, tranne che il parametro `silent` è ora impostato su `true`:

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

Questo comando restituisce la stessa risposta del caso `silent=false`, ma la query annullata restituisce ora un codice HTTP 200 con una risposta simile alla seguente:

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