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

# CancelJob
<a name="cancel-job-api"></a>

`CancelJob` オペレーションは、実行中または保留中のジョブを停止します。キャンセルできるのは、**保留中**または**実行中**状態のジョブのみです。キャンセルは非同期であるため、ジョブのステータスをモニタリングして完了を確認する必要があります。キャンセルされたジョブは、処理中にキャンセルが発生するタイミングに応じて、出力場所に部分的な結果が生じる場合があります。

詳細については、*Amazon Location Service API リファレンス*の[CancelJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_CancelJob.html)」を参照してください。

この API のリクエスト、レスポンス、CLI コマンドの例については、[「ジョブをキャンセルする方法](https://docs.aws.amazon.com/location/latest/developerguide/canceling-job.html)」を参照してください。

## ユースケース
<a name="cancel-job-use-cases"></a>
+ **不要な処理を停止する:** 誤った設定で送信されたジョブ、ビジネス要件の変更により不要になったジョブ、または誤って開始されたジョブをキャンセルします。これにより、リソースの浪費や不要な料金を防ぐことができます。
+ **リソースとコストの最適化:** 優先度の高いタスクを処理する必要がある場合に優先度の低いジョブをキャンセルすることで、処理容量を解放します。

## リクエストを理解する
<a name="cancel-job-request-parameters"></a>

`CancelJob` リクエストでは、キャンセルするジョブを識別するために 1 つのパラメータのみが必要です。このシンプルなリクエスト構造により、不要になったジョブの処理を簡単に停止できます。

リクエストには、次のパラメータが含まれます。

**ジョブ識別**  
キャンセルするジョブを指定する必須パラメータ。  
+ `JobId`: キャンセルするジョブの一意の識別子。パターン に一致する 1～100 文字にする必要があります`[-._\w]+`。これは、ジョブの作成時に `StartJob`オペレーションによって返される識別子と同じです。キャンセルできるのは、 `Pending` または `Running`ステータスのジョブのみです。

## レスポンスを理解する
<a name="cancel-job-response-details"></a>

`CancelJob` レスポンスはキャンセルリクエストを確認し、ジョブの更新ステータスを提供します。キャンセルは非同期であるため、 `GetJob`オペレーションを使用して、 `Cancelled`ステータスに達するまでジョブをモニタリングする必要があります。

レスポンスには、次のフィールドが含まれます。

**ジョブ識別**  
キャンセルされるジョブの一意の識別子。  
+ `JobId`: 一意のジョブ識別子。
+ `JobArn`: キャンセルされるジョブの Amazon リソースネーム (ARN)。

**キャンセルステータス**  
キャンセルリクエスト後の現在のジョブステータス。  
+ `Status`: キャンセルリクエストの直後のジョブステータス。通常`Cancelling`、キャンセルが進行中であることを示します。`Cancelled` キャンセルが完了すると、ステータスは に移行します。を使用して、この移行をモニタリング`GetJob`します。

**注記**  
キャンセルされたジョブは、処理中にキャンセルが発生するタイミングに応じて、出力場所に部分的な結果が生じる場合があります。出力場所をチェックして、キャンセルが完了する前に部分データが書き込まれたかどうかを確認します。ジョブがキャンセルされる前に処理され、出力バケットに書き込まれたレコードの数に対して課金されます。