本頁說明如何查看及刪除工作執行作業。如要執行、取消或覆寫工作設定,請參閱「執行工作」。
必要的角色
如要取得管理 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 頁面:
按一下工作,即可顯示執行作業清單。
在執行作業詳細資料頁面中,從清單選取您感興趣的執行作業。(選用) 你可以依條件篩選。
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: 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 頁面:
按一下工作,開啟工作詳細資料窗格。
按一下要查看的工作執行作業。右側面板會顯示執行作業詳細資料。詳情請參閱「工作」、「容器」、「磁碟區」、「網路」、「安全性」和「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: Google Cloud 專案 ID。REGION:作業的 Google Cloud 區域。JOB:Cloud Run 工作名稱。EXECUTION_NAME:工作執行的名稱。
刪除工作執行作業
即使在執行期間,您也可以刪除工作執行個體。刪除執行作業後,系統會停止執行作業。
雖然已刪除的執行作業不會顯示在執行作業清單中,但記錄仍會在記錄保留期限內保留在 Cloud Logging 中,監控資料也會保留在 Cloud Monitoring 中。
控制台
如要刪除工作執行作業,請按照下列步驟操作:
前往 Google Cloud 控制台的 Cloud Run jobs 頁面:
按一下工作,開啟工作詳細資料窗格。
選取要刪除的工作執行作業。
在「動作」選單下方,按一下省略號圖示,然後按一下「刪除」。
如果系統提示確認刪除,請按一下「確認」。
gcloud
如要刪除工作執行作業,請按照下列步驟操作:
執行下列指令:
gcloud run jobs executions delete EXECUTION_NAME
將
EXECUTION_NAME替換為執行的名稱。如果系統提示您確認,請回覆
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: Google Cloud 專案 ID。REGION:作業的 Google Cloud 區域。JOB:Cloud Run 工作名稱。EXECUTION_NAME:工作執行的名稱。