Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Pembatalan kueri SPARQL
<a name="sparql-api-status-cancel"></a>

Untuk mendapatkan status kueri SPARQL, gunakan HTTP `GET` atau `POST` untuk membuat permintaan ke titik akhir `https://your-neptune-endpoint:port/sparql/status`.

## Parameter permintaan pembatalan kueri SPARQL
<a name="sparql-api-status-cancel-request"></a>

**CancelQuery**  
(Diperlukan) Memberi tahu perintah status untuk membatalkan kueri. Parameter ini tidak mengambil nilai.

**queryId**  
(Diperlukan) ID dari kueri SPARQL yang berjalan yang akan dibatalkan.

**diam**  
(Opsional) Jika `silent=true` maka kueri yang berjalan dibatalkan dan kode respon HTTPnya adalah 200. Jika `silent` tidak ada atau `silent=false`, kueri dibatalkan dengan kode status HTTP 500.

## Contoh pembatalan kueri SPARQL
<a name="sparql-api-status-cancel-example"></a>

**Contoh 1: Pembatalan dengan `silent=false`**  
Berikut ini adalah contoh perintah status menggunakan `curl` untuk membatalkan kueri dengan parameter `silent` diatur ke `false`:

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

Kecuali kueri sudah mulai men-streaming hasil, kueri yang dibatalkan kemudian akan mengembalikan kode HTTP 500 dengan respons seperti ini:

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

Jika kueri sudah mengembalikan kode HTTP 200 (OK) dan telah mulai men-streaming hasil sebelum dibatalkan, informasi pengecualian batas waktu dikirim ke stream output biasa.

**Contoh 2: Pembatalan dengan `silent=true`**  
Berikut ini adalah contoh dari perintah status yang sama seperti di atas kecuali dengan parameter `silent` sekarang diatur ke `true`:

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

Perintah ini akan mengembalikan respons yang sama seperti ketika `silent=false`, tetapi kueri yang dibatalkan sekarang akan mengembalikan kode HTTP 200 dengan respons seperti ini:

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