管理工作機會

本頁說明如何管理作業。如要建立工作，請參閱建立工作。 如要執行工作，請參閱「執行工作」。

必要的角色

如要取得管理 Cloud Run 作業所需的權限，請要求管理員為您授予 Cloud Run 作業的 Cloud Run 開發人員 (roles/run.developer) 身分與存取權管理角色。

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

查看專案中的工作

您可以透過下列其中一種方式，查看專案中的工作清單：

控制台

如要查看工作：

  1. 前往 Cloud Run jobs 頁面。

  2. 您可以視需要從下拉式選單中選取條件，篩選工作，例如工作名稱、執行時間、區域等。

gcloud

  1. 如要列出專案中的所有工作：

    gcloud run jobs list

  2. 如要依地區篩選工作，請按照下列步驟操作：

    gcloud run jobs list --region REGION

    將 REGION 替換為您要篩選的區域名稱，例如 europe-west1。

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

用戶端程式庫

如要透過程式碼查看專案中的工作：

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

取代：

  • ACCESS_TOKEN 帳戶的有效存取權權杖，該帳戶具備查看工作的 IAM 權限。 舉例來說，如果您已登入 gcloud，可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中，您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
  • 將 REGION 替換為職缺的 Google Cloud 地區。
  • 將 PROJECT-ID 改成 Google Cloud 專案 ID。

查看工作詳細資料

使用 gcloud 指令列查看工作的更多詳細資料。

控制台

如要查看特定工作執行的詳細資料：

  1. 前往 Cloud Run jobs 頁面

  2. 找出感興趣的工作。

  3. 按一下工作，顯示工作詳細資料頁面。

  4. 請注意「歷史記錄」、「指標」、「記錄」、「觸發條件」和「YAML」分頁。

    • 「記錄」分頁會顯示工作執行作業中各項工作的相關資訊。
    • 「記錄」會顯示記錄資訊。
    • 「指標」會顯示工作執行相關資訊。
    • YAML 會以 YAML 格式顯示工作設定。

gcloud

如要查看工作詳細資料：

使用以下指令：

gcloud run jobs describe  JOB_NAME

將 JOB_NAME 改為工作名稱。

用戶端程式庫

如要透過程式碼查看工作詳細資料：

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-NAME

取代：

  • ACCESS_TOKEN，並提供帳戶的有效存取權杖，該帳戶必須具備查看工作詳細資料的 IAM 權限。 舉例來說，如果您已登入 gcloud，可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中，您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
  • JOB-NAME 改為工作名稱。
  • 將 REGION 替換為職缺的 Google Cloud 地區。
  • 將 PROJECT-ID 改成 Google Cloud 專案 ID。

刪除工作

刪除工作會終止所有進行中的工作執行作業和所有執行中的容器執行個體。

雖然已刪除的工作不會再顯示在工作清單中，但記錄檔仍會在記錄保留期間內保留在 Cloud Logging 中，監控資料也會保留在 Cloud Monitoring 中。

控制台

如要刪除工作：

  1. 前往 Cloud Run jobs 頁面

  2. 選取工作。

  3. 點選「刪除」。

gcloud

如要刪除工作：

  1. 使用以下指令：

    gcloud run jobs delete JOB_NAME

    將 JOB_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-NAME

取代：

  • ACCESS_TOKEN，並提供帳戶的有效存取權權杖，該帳戶必須具備刪除工作的 IAM 權限。舉例來說，如果您已登入 gcloud，可以使用 gcloud auth print-access-token 擷取存取權杖。在 Cloud Run 容器執行個體中，您可以使用容器執行個體中繼資料伺服器擷取存取權杖。
  • JOB-NAME 改為工作名稱。
  • 將 REGION 替換為職缺的 Google Cloud 地區。
  • 將 PROJECT-ID 改成 Google Cloud 專案 ID。