ジョブのキャンセル

このページでは、バッチジョブをキャンセルする方法について説明します。実行を停止または実行を防ぐジョブをキャンセルします。

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

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

始める前に

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

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

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

ジョブのキャンセル

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

gcloud

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

gcloud alpha batch jobs cancel JOB_NAME --location LOCATION

以下を置き換えます。

API

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

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

以下を置き換えます。

次のステップ