ジョブ実行を管理する

このページでは、ジョブ実行を表示および削除する方法について説明します。ジョブ構成を実行、キャンセル、オーバーライドする方法については、ジョブを実行するをご覧ください。

必要なロール

Cloud Run ジョブを管理するために必要な権限を取得するには、Cloud Run ジョブに対する Cloud Run デベロッパー（roles/run.developer）IAM ロールを付与するよう管理者に依頼してください。

Cloud Run に関連付けられている IAM ロールと権限のリストについては、Cloud Run IAM ロールと Cloud Run IAM 権限をご覧ください。Cloud Run ジョブがGoogle Cloud API（Cloud クライアント ライブラリなど）と連携している場合は、サービス ID の構成ガイドをご覧ください。ロールの付与の詳細については、デプロイ権限とアクセスの管理をご覧ください。

プロジェクト内のジョブ実行を表示する

Google Cloud コンソールまたは Google Cloud CLI を使用して、プロジェクトのジョブ実行のリストを表示できます。

コンソール

ジョブの実行リストを表示するには:

1. [Cloud Run] ページに移動します。

2. リストで、実行を管理するジョブを見つけます。

3. ジョブをクリックして実行リストを表示します。

4. 実行の詳細ページで、目的の実行を選択します。必要に応じて、フィルタ条件を目的の条件に設定できます（たとえば、ステータス値に「完了」を設定します）。

gcloud

プロジェクト内のすべてのジョブに対するジョブ実行を一覧表示するには:

gcloud run jobs executions list

特定のジョブ実行のみを表示するには、次のコマンドを実行します。

gcloud run jobs executions list --job JOB_NAME

JOB_NAME は、フィルタするジョブの名前に置き換えます。

フィルタを使用するなどの方法で、返されたリストを絞り込む方法については、ジョブ実行リストをご覧ください。

特定のジョブの最新の実行名を取得するには、--format フラグを使用します。

gcloud run jobs describe JOB_NAME --format="value(status.latestCreatedExecution.name)"

JOB_NAME は、フィルタするジョブの名前に置き換えます。

クライアント ライブラリ

コードからすべてのジョブ実行を一覧取得するには:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

ジョブ実行を一覧取得するには、Cloud Run Admin API の jobs エンドポイントに GET HTTP リクエストを送信します。

curl の使用例を次に示します。

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions

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

• ACCESS_TOKEN は、ジョブ実行を表示する IAM 権限を持つアカウントの有効なアクセス トークンに置き換えます。たとえば、gcloud にログインしている場合は、gcloud auth print-access-token を使用してアクセス トークンを取得できます。Cloud Run コンテナ インスタンスから、コンテナ インスタンス メタデータ サーバーを使用してアクセス トークンを取得できます。
• JOB-NAME: ジョブの名前。
• REGION はジョブの Google Cloud リージョンに置き換えます。
• PROJECT-ID は、 Google Cloud プロジェクト ID に置き換えます。

ジョブ実行の詳細を表示する

最新の 1,000 件のジョブ実行のジョブの詳細を表示するには、実行の詳細ペインを使用します。古い実行の詳細は削除され、実行の詳細ペインに表示されなくなります。ただし、古い実行のログとモニタリング データは Cloud Logging と Cloud Monitoring で引き続き利用できます。これらは、保持ポリシーの対象となります。

Google Cloud コンソールまたは Google Cloud CLI を使用して、ジョブ実行の詳細を表示できます。

コンソール

特定のジョブ実行の詳細を表示するには:

1. [Cloud Run] の [ジョブ] ページに移動します。

2. ジョブをクリックしてジョブの詳細パネルを開きます。

3. 表示するジョブ実行をクリックします。実行の詳細が右側のパネルに表示されます。

4. [タスク]、[コンテナ]、[ボリューム]、[ネットワーキング]、[セキュリティ]、[YAML] の各タブと、[ログを表示] リンクを確認します。

   • [タスク] には、ジョブ実行のタスクに関する情報が表示されます。
   • [YAML] には、ジョブの構成が YAML 形式で表示されます。
   • [ログを表示] リンクをクリックして、実行に関連するログを表示します。
   • 他のタブには、実行に使用されたジョブ、コンテナ、セキュリティ、接続などに関する情報が表示されます。

gcloud

ジョブ実行の詳細を表示するには:

次のコマンドを使用します。

gcloud run jobs executions describe EXECUTION_NAME

EXECUTION_NAME は、実行名に置き換えます。

--format フラグを使用して出力をフォーマットし、追加情報を取得できます。たとえば、YAML としてフォーマットします。

gcloud run jobs executions describe EXECUTION_NAME --format yaml

クライアント ライブラリ

コードからジョブ実行の詳細を表示するには:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

ジョブ実行の詳細を表示するには、Cloud Run Admin API の jobs エンドポイントに GET HTTP リクエストを送信します。

curl の使用例を次に示します。

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X GET \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions/EXECUTION-NAME

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

• ACCESS_TOKEN は、ジョブ実行の詳細を表示する IAM 権限を持つアカウントの有効なアクセス トークンに置き換えます。たとえば、gcloud にログインしている場合は、gcloud auth print-access-token を使用してアクセス トークンを取得できます。Cloud Run コンテナ インスタンスから、コンテナ インスタンス メタデータ サーバーを使用してアクセス トークンを取得できます。
• JOB-NAME: ジョブの名前。
• EXECUTION-NAME: ジョブ実行の名前。
• REGION はジョブの Google Cloud リージョンに置き換えます。
• PROJECT-ID は、 Google Cloud プロジェクト ID に置き換えます。

ジョブ実行を削除する

ジョブの実行中でも、その実行を削除することができます。実行を削除すると、それ以上そのジョブは実行されなくなります。

注: 一方、ジョブ実行の cancel メソッドを使用して現在のジョブ実行を停止した場合、そのジョブ実行はジョブ実行のリストに残ります。

削除された実行は実行リストに表示されませんが、ログ保持期間が残っている間は Cloud Logging でそのログを参照できます。また、モニタリング データは Cloud Monitoring で参照できます。

コンソール

ジョブ実行を削除するには:

1. [Cloud Run] の [ジョブ] ページに移動します。

2. ジョブをクリックしてジョブの詳細パネルを開きます。

3. 削除するジョブ実行を選択します。

4. [アクション] メニューで、省略記号アイコンをクリックし、[削除] をクリックします。

5. 削除を確認するメッセージが表示されたら、[確認] をクリックします。

gcloud

ジョブ実行を削除するには:

1. 次のコマンドを使用します。

   gcloud run jobs executions delete EXECUTION_NAME

   EXECUTION_NAME は、実行名に置き換えます。

2. 確認するメッセージが表示されたら、y と応答します。ビルドが成功すると、成功メッセージが表示されます。

クライアント ライブラリ

コードからジョブ実行を削除するには:

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

ジョブ実行を削除するには、Cloud Run Admin API の jobs エンドポイントに DELETE HTTP リクエストを送信します。

curl の使用例を次に示します。

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X DELETE \
  -d '' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions/EXECUTION-NAME

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

• ACCESS_TOKEN は、ジョブ実行を削除する IAM 権限を持つアカウントの有効なアクセス トークンに置き換えます。たとえば、gcloud にログインしている場合は、gcloud auth print-access-token を使用してアクセス トークンを取得できます。Cloud Run コンテナ インスタンスから、コンテナ インスタンス メタデータ サーバーを使用してアクセス トークンを取得できます。
• JOB_NAME: ジョブの名前。
• EXECUTION-NAME: ジョブ実行の名前。
• REGION はジョブの Google Cloud リージョンに置き換えます。
• PROJECT-ID は、 Google Cloud プロジェクト ID に置き換えます。