管理工作執行作業

本頁說明如何查看及刪除工作執行作業。如要執行、取消或覆寫工作設定,請參閱「執行工作」。

必要的角色

如要取得管理 Cloud Run 作業所需的權限,請要求管理員授予您 Cloud Run 作業的「Cloud Run 開發人員 」(roles/run.developer) IAM 角色。

如需與 Cloud Run 相關聯的 IAM 角色和權限清單,請參閱「Cloud Run IAM 角色」和「Cloud Run IAM 權限」。如果 Cloud Run 作業與Cloud de Confiance API (例如 Cloud 用戶端程式庫) 介接,請參閱服務身分設定指南。如要進一步瞭解如何授予角色,請參閱「部署權限」和「管理存取權」。

查看專案中的工作執行情況

您可以使用Cloud de Confiance 控制台、gcloud CLI、用戶端程式庫或 REST API,查看專案中的工作執行清單:

控制台

如要查看工作的執行清單,請按照下列步驟操作:

  1. 前往 Cloud de Confiance by S3NS 控制台的 Cloud Run jobs 頁面:

    前往 Cloud Run jobs

  2. 按一下工作,即可顯示執行作業清單。

  3. 在執行作業詳細資料頁面中,從清單選取您感興趣的執行作業。(選用) 你可以依條件篩選。

gcloud

  • 如要列出專案中所有工作的所有工作執行作業,請執行下列指令:

    gcloud run jobs executions list
  • 如要只列出特定作業的執行作業,請執行下列指令:

    gcloud run jobs executions list --job JOB

    將 JOB 替換為要篩選的工作名稱。

    如要瞭解其他縮小傳回清單範圍的方法 (包括使用篩選器),請參閱工作執行清單。

  • 如要取得特定作業的最新執行作業名稱,請使用 --format 標記:

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

    將 JOB 替換為要篩選的工作名稱。

或者,如要查看最新工作執行作業的詳細資料,請參閱「查看工作執行作業詳細資料」。

用戶端程式庫

如要透過程式碼列出所有工作執行作業,請執行下列操作:

REST API

如要列出工作執行作業,請將 GET HTTP 要求傳送至 Cloud Run Admin API jobs 端點。

例如,使用 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/executions

更改下列內容:

  • ACCESS_TOKEN:帳戶的有效存取權杖,該帳戶具有查看工作執行的 IAM 權限。 舉例來說,如果您已登入 gcloud,可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中,您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
  • PROJECT_ID: Cloud de Confiance 專案 ID。
  • REGION:作業的 Cloud de Confiance 區域。
  • JOB:Cloud Run 工作名稱。

查看工作執行作業詳細資料

您可以使用執行作業詳細資料窗格,查看工作最近 1,000 次執行作業的詳細資料。 系統會移除舊的執行作業詳細資料,且不再顯示於執行作業詳細資料窗格。不過,舊版執行的記錄和監控資料仍會保留在 Cloud Logging 和 Cloud Monitoring 中,但須遵守這些產品的保留政策。

您可以使用 Cloud de Confiance 控制台、gcloud CLI、用戶端程式庫或 REST API,查看作業執行的詳細資料:

控制台

如要查看特定工作執行的詳細資料,請按照下列步驟操作:

  1. 前往 Cloud de Confiance by S3NS 控制台的 Cloud Run jobs 頁面:

    前往 Cloud Run jobs

  2. 按一下工作,開啟工作詳細資料窗格。

  3. 按一下要查看的工作執行作業。右側面板會顯示執行作業詳細資料。詳情請參閱「工作」、「容器」、「磁碟區」、「網路」、「安全性」和「YAML」分頁。

gcloud

如要查看工作執行的詳細資料,請執行下列指令:

  • 如要描述特定工作執行作業:

    gcloud run jobs executions describe EXECUTION_NAME

    將 EXECUTION_NAME 替換為執行的名稱。

    您可以使用 --format 旗標設定輸出內容的格式,並取得額外資訊。例如,以 YAML 格式表示:

    gcloud run jobs executions describe EXECUTION_NAME --format yaml
  • 如要說明工作的最新執行作業,請執行下列操作:

    gcloud run jobs executions describe-latest --job=JOB

    將 JOB 替換為工作名稱。

用戶端程式庫

如要從程式碼查看工作執行詳細資料:

REST API

如要查看工作執行詳細資料,請將 GET HTTP 要求傳送至 Cloud Run Admin API jobs 端點。

例如,使用 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/executions/EXECUTION_NAME

更改下列內容:

  • ACCESS_TOKEN:帳戶的有效存取權杖,該帳戶須具備查看工作執行詳細資料的 IAM 權限。 舉例來說,如果您已登入 gcloud,可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中,您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
  • PROJECT_ID: Cloud de Confiance 專案 ID。
  • REGION:作業的 Cloud de Confiance 區域。
  • JOB:Cloud Run 工作名稱。
  • EXECUTION_NAME:工作執行的名稱。

刪除工作執行作業

即使在執行期間,您也可以刪除工作執行個體。刪除執行作業後,系統會停止執行作業。

雖然已刪除的執行作業不會顯示在執行作業清單中,但記錄仍會在記錄保留期限內保留在 Cloud Logging 中,監控資料也會保留在 Cloud Monitoring 中。

控制台

如要刪除工作執行作業,請按照下列步驟操作:

  1. 前往 Cloud de Confiance by S3NS 控制台的 Cloud Run jobs 頁面:

    前往 Cloud Run jobs

  2. 按一下工作,開啟工作詳細資料窗格。

  3. 選取要刪除的工作執行作業。

  4. 在「動作」選單下方,按一下省略號圖示,然後按一下「刪除」。

  5. 如果系統提示確認刪除,請按一下「確認」。

gcloud

如要刪除工作執行作業,請按照下列步驟操作:

  1. 執行下列指令:

    gcloud run jobs executions delete EXECUTION_NAME

    將 EXECUTION_NAME 替換為執行的名稱。

  2. 如果系統提示您確認,請回覆 y。成功後,畫面上會顯示成功訊息。

用戶端程式庫

如要從程式碼刪除工作執行作業:

REST API

如要刪除工作執行作業,請將 DELETE HTTP 要求傳送至 Cloud Run Admin API jobs 端點。

例如,使用 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/executions/EXECUTION_NAME

更改下列內容:

  • ACCESS_TOKEN:帳戶的有效存取權杖,該帳戶具有刪除工作執行的 IAM 權限。舉例來說,如果您已登入 gcloud,可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中,您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
  • PROJECT_ID: Cloud de Confiance 專案 ID。
  • REGION:作業的 Cloud de Confiance 區域。
  • JOB:Cloud Run 工作名稱。
  • EXECUTION_NAME:工作執行的名稱。