ジョブのキャンセル

このページでは、Batch ジョブをキャンセルする方法について説明します。実行を停止するジョブや、実行を阻止するジョブをキャンセルします。

理想的には、意図したとおりに動作しなかった場合に、実行を自動的に停止して失敗するようにジョブを構成する必要があります。たとえば、ゼロ以外の終了コードまたはタイムアウトを返すように実行可能ファイルを構成します。ただし、実際には、未完了のジョブを手動で停止することが必要な場合があります。たとえば、まだ完了していないジョブのトラブルシューティングや置き換えが必要な場合は、ジョブをキャンセルします。

成功したジョブや失敗したジョブと同様に、キャンセルされたジョブは最大 60 日間プロジェクトに残ります。その後、 Google Cloud はジョブを自動的に削除します。ジョブをキャンセルしてジョブの情報を保持する必要がない場合は、代わりにジョブをすぐに削除できます。

始める前に

  1. Batch を以前に使用したことがない場合は、 Batch を使ってみる を確認し、 プロジェクトとユーザーの前提条件を完了して Batch を有効にします。

  2. ジョブのキャンセルに必要な権限を取得するには、管理者にプロジェクトのバッチジョブ編集者 （roles/batch.jobsEditor）の IAM ロールを付与するように依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

    必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

ジョブのキャンセル

ジョブは、gcloud CLI または Batch API を使用してキャンセルできます。

gcloud

gcloud CLI を使用してジョブをキャンセルするには、gcloud batch jobs cancel コマンドを使用します:

gcloud batch jobs cancel JOB_NAME --location LOCATION

以下を置き換えます。

API

Batch API を使用してジョブをキャンセルするには、 jobs.cancel メソッドを使用します。

POST https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME:cancel

以下を置き換えます。

次のステップ