翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# SPARQL クエリのキャンセル
<a name="sparql-api-status-cancel"></a>

SPARQL クエリのステータスを取得するには、HTTP `GET` または `POST` を使用して、`https://your-neptune-endpoint:port/sparql/status` エンドポイントにリクエストを送信します。

## SPARQL クエリのキャンセルリクエストパラメータ
<a name="sparql-api-status-cancel-request"></a>

**cancelQuery**  
(必須) クエリをキャンセルするようステータスコマンドに指示します。このパラメータは値を取りません。

**queryId**  
(必須) キャンセルする実行中の SPARQL クエリの ID。

**silent**  
(オプション) `silent=true` の場合、実行中のクエリはキャンセルされます。HTTP レスポンスコードは 200 です。`silent` が存在しない場合、または `silent=false` である場合、クエリは HTTP 500 ステータスコードでキャンセルされます。

## SPARQL クエリのキャンセルの例
<a name="sparql-api-status-cancel-example"></a>

**例 1: `silent=false` でのキャンセル**  
次に示すのは、`curl` を使用し、`silent` パラメータを `false` に設定してクエリをキャンセルするステータスコマンドの例です。

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

クエリが既に結果のストリーミングを開始していない限り、キャンセルされたクエリは、次のようなレスポンスを持つ HTTP 500 コードを返します。

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

クエリが既に HTTP 200 コード (OK) を返し、キャンセルされる前に結果のストリーミングを開始した場合、タイムアウト例外情報が通常の出力ストリームに送信されます。

**例 2: `silent=true` でのキャンセル**  
次に示すのは、`silent` パラメータが `true` に設定されている場合を除いて、上記と同じステータスコマンドの例です。

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

このコマンドは `silent=false` の場合と同じレスポンスを返しますが、キャンセルされたクエリは次のようなレスポンスを伴う HTTP 200 コードを返すようになります。

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