您可以查看 Cloud Run 工作執行作業的狀態詳細資料,或刪除不必要的執行作業。如要執行、取消或覆寫工作設定,請參閱「執行工作」。
必要的角色
如要取得管理 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 用戶端程式庫) 互動,請參閱服務身分設定指南。如要進一步瞭解如何授予角色,請參閱部署權限和管理存取權。
查看專案中的工作執行作業
您可以使用Google Cloud 控制台、gcloud CLI、用戶端程式庫或 REST API,查看專案中的工作執行清單:
控制台
如要查看工作的執行作業清單,請按照下列步驟操作:
前往 Google Cloud 控制台的「Cloud Run jobs」(Cloud Run 工作) 頁面:
按一下工作,即可顯示執行作業清單。
在執行作業詳細資料頁面中,從清單選取要查看的執行作業。您也可以依條件篩選。
gcloud
如要列出專案中所有工作的執行作業,請執行下列指令:
gcloud run jobs executions list
如要僅列出特定工作的執行作業,請執行下列指令:
gcloud run jobs executions list --job JOB
將
JOB替換為要篩選的工作名稱。如要瞭解其他縮小傳回清單範圍的方法 (包括使用篩選器),請參閱「jobs executions list」。
如要取得特定工作最新執行作業的名稱,請使用
--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: Google Cloud 專案 ID。REGION:工作的 Google Cloud 區域。JOB:Cloud Run 工作名稱。
查看工作執行作業詳細資料
您可以使用執行作業詳細資料窗格,查看工作最近 1,000 次執行的詳細資料。系統會移除較舊的執行作業詳細資料,且不會再顯示於執行作業詳細資料窗格中。不過,舊執行作業的記錄和監控資料仍可在 Cloud Logging 和 Cloud Monitoring 中查看,但須遵守這些產品的保留政策。
您可以使用 Google Cloud 控制台、gcloud CLI、用戶端程式庫或 REST API,查看工作執行的詳細資料:
控制台
如要查看特定工作執行作業的詳細資料,請按照下列步驟操作:
前往 Google Cloud 控制台的「Cloud Run jobs」(Cloud Run 工作) 頁面:
按一下工作,開啟工作詳細資料窗格。
按一下要查看的工作執行作業。執行作業詳細資料會顯示在右側面板中。詳情請參閱「Tasks」(工作)、「Containers」(容器)、「Volumes」(磁碟區)、「Networking」(網路)、「Security」(安全性) 和「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
如要查看工作執行詳細資料,請向 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/executions/EXECUTION_NAME
更改下列內容:
ACCESS_TOKEN:帳戶的有效存取權杖,該帳戶必須具備查看工作執行詳細資料的 IAM 權限。舉例來說,如果您已登入 gcloud,可以使用gcloud auth print-access-token擷取存取權杖。在 Cloud Run 容器執行個體中,您可以使用容器執行個體中繼資料伺服器擷取存取權杖。PROJECT_ID: Google Cloud 專案 ID。REGION:工作的 Google Cloud 區域。JOB:Cloud Run 工作名稱。EXECUTION_NAME:工作執行作業的名稱。
刪除工作執行作業
您可以在執行期間刪除工作執行作業。如果刪除執行作業,系統會停止執行作業。
雖然已刪除的執行作業不會顯示在執行作業清單中,但其記錄檔在記錄保留期限內仍會保留在 Cloud Logging 中,而監控資料也會保留在 Cloud Monitoring 中。
控制台
如要刪除工作執行作業,請按照下列步驟操作:
前往 Google Cloud 控制台的「Cloud Run jobs」(Cloud Run 工作) 頁面:
按一下工作,開啟工作詳細資料窗格。
選取要刪除的工作執行作業。
在「動作」選單下方,依序點選「刪除」和「刪除」。
如果系統提示您確認刪除,請點選「確認」。
gcloud
如要刪除工作執行作業,請按照下列步驟操作:
執行下列指令:
gcloud run jobs executions delete EXECUTION_NAME
將
EXECUTION_NAME替換為執行作業名稱。如果系統提示您確認,請回覆
y。成功後,系統會顯示成功訊息。
用戶端程式庫
如要透過程式碼刪除工作執行作業,請按照下列步驟操作:
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/executions/EXECUTION_NAME
更改下列內容:
ACCESS_TOKEN:帳戶的有效存取權杖,該帳戶必須具備刪除工作執行的 IAM 權限。舉例來說,如果您已登入 gcloud,可以使用gcloud auth print-access-token擷取存取權杖。在 Cloud Run 容器執行個體中,您可以使用容器執行個體中繼資料伺服器擷取存取權杖。PROJECT_ID: Google Cloud 專案 ID。REGION:工作的 Google Cloud 區域。JOB:Cloud Run 工作名稱。EXECUTION_NAME:工作執行作業的名稱。