ジョブのキャンセル

このページでは、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

次のように置き換えます。

次のステップ