

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

# Neptune Loader Cancel Job
<a name="load-api-reference-cancel"></a>

ロードジョブをキャンセルします｡

ジョブをキャンセルするには、`DELETE` エンドポイントに、HTTP `https://{{your-neptune-endpoint}}:{{port}}/loader` リクエストを送信する必要があります。`loadId` は `/loader` URL パスに追加することも、URL に変数として含めることもできます。

## ジョブキャンセルリクエストの構文
<a name="load-api-reference-cancel-syntax"></a>

```
DELETE https://{{your-neptune-endpoint}}:{{port}}/loader?loadId={{loadId}}
```

```
DELETE https://{{your-neptune-endpoint}}:{{port}}/loader/{{loadId}}
```

## ジョブキャンセルリクエストのパラメータ
<a name="load-api-reference-cancel-parameters"></a>

**loadId**  
ロードジョブの ID。

## ジョブキャンセルレスポンスの構文
<a name="load-api-reference-cancel-parameters-response"></a>

```
no response body
```

**200 OK**  
ロードジョブが正常に削除されると `200` コードが返されます。

## ジョブキャンセルエラー
<a name="load-api-reference-cancel-parameters-errors"></a>

エラーが発生すると、JSON オブジェクトがレスポンスの `BODY` に返されます。`message` オブジェクトには、エラーの説明が含まれています。

**エラーカテゴリ**
+ **`Error 400`** - `loadId` が無効の場合、HTTP `400` 無効な要求エラーが返されます。エラーを説明するメッセージ。
+ **`Error 500`** - 処理できない有効なリクエストは、HTTP `500` 内部サーバーエラーを返します。エラーを説明するメッセージ。

## ジョブキャンセルエラーメッセージ
<a name="load-api-reference-cancel-parameters-errors-messages"></a>

以下は、キャンセル API からエラーの説明とともに返される可能性があるエラーメッセージです。
+ `The load with id = {{load_id}} does not exist or not active` (HTTP 404)   -   ロードが見つかりませんでした。`id` パラメータの値を確認します。
+ `Load cancellation is not permitted on a read replica instance.` (HTTP 405)   -   ロードは書き込み操作です。読み取り/書き込みクラスターエンドポイントの再試行。

## ジョブキャンセルの例
<a name="load-api-reference-cancel-examples"></a>

**Example [リクエスト]**  
以下は、`curl` コマンドを使用して HTTP `DELETE` 経由で送信されるリクエストです。  

```
aws neptunedata cancel-loader-job \
  --endpoint-url https://{{your-neptune-endpoint}}:{{port}} \
  --load-id {{0a237328-afd5-4574-a0bc-c29ce5f54802}}
```
詳細については、 AWS CLI 「 コマンドリファレンス」の[cancel-loader-job](https://docs.aws.amazon.com/cli/latest/reference/neptunedata/cancel-loader-job.html)」を参照してください。

```
import boto3
from botocore.config import Config

client = boto3.client(
    'neptunedata',
    endpoint_url='https://{{your-neptune-endpoint}}:{{port}}',
    config=Config(read_timeout=None, retries={'total_max_attempts': 1})
)

response = client.cancel_loader_job(
    loadId='{{0a237328-afd5-4574-a0bc-c29ce5f54802}}'
)

print(response)
```

```
awscurl 'https://{{your-neptune-endpoint}}:{{port}}/loader/{{0a237328-afd5-4574-a0bc-c29ce5f54802}}' \
  --region {{us-east-1}} \
  --service neptune-db \
  -X DELETE
```
この例では、 AWS 認証情報が 環境で設定されていることを前提としています。{{us-east-1}} を Neptune クラスターのリージョンに置き換えます。

```
curl -X DELETE 'https://{{your-neptune-endpoint}}:{{port}}/loader/{{0a237328-afd5-4574-a0bc-c29ce5f54802}}'
```