管理佇列和工作

Cloud Tasks 可讓您控管非同步工作負載執行作業、暫停佇列處理,以及排解進行中的工作流程問題。您可以使用 Google Cloud 控制台、Google Cloud CLI 或 Cloud Tasks API,設定及維護佇列和任務。

事前準備

  1. 確認您已有 Cloud Tasks 工作佇列。詳情請參閱「建立 Cloud Tasks 佇列」。
  2. 確認您具備管理佇列和工作所需的 Identity and Access Management (IAM) 角色,例如 Cloud Tasks 管理員 (roles/cloudtasks.admin)、Cloud Tasks 佇列管理員 (roles/cloudtasks.queueAdmin) 或 Cloud Tasks 工作刪除者 (roles/cloudtasks.taskDeleter)。

從佇列中刪除任務

您可以刪除已排定或已調度的任務。舉例來說,如果某項工作無論重試多少次都無法順利完成,您可能需要刪除該工作。如果工作已順利完成,或在持續失敗後用盡重試次數,則無法刪除。如果達到工作保留上限,系統會自動刪除工作。

控制台

  1. 在 Google Cloud 控制台,依序前往「Cloud Tasks」>「Queues」(佇列) 頁面。

    前往「佇列」

  2. 按一下要刪除的工作所屬佇列名稱。

  3. 找出要刪除的工作,然後勾選對應的核取方塊。

  4. 按一下 「Delete task」(刪除工作)。

  5. 在系統的提示訊息中,按一下 [刪除]。

gcloud

使用 gcloud tasks delete 指令刪除工作:

gcloud tasks delete TASK_NAME \
    --queue=QUEUE_ID \
    --location=LOCATION

更改下列內容:

  • TASK_NAME:要刪除的工作 ID 或完整資源名稱
  • QUEUE_ID:工作所屬佇列的名稱
  • LOCATION:部署佇列的區域,例如 us-central1

REST

如要刪除工作,請使用 projects.locations.queues.tasks.delete 方法。

使用任何要求資料之前,請先修改下列項目的值:

  • QUEUE_ID:工作所屬的佇列名稱
  • TASK_NAME:要刪除的工作名稱
  • PROJECT_ID:您的 Google Cloud專案 ID
  • LOCATION:佇列所在的區域,例如 us-central1

要求主體必須為空白。

請展開以下其中一個選項,以傳送要求:

如果成功,回應主體會是空白。

從佇列中刪除一批任務

您可以使用 projects.locations.queues.tasks.batchDelete 方法刪除工作名稱清單,從佇列中刪除一批工作。

注意事項:

  • 所有工作都必須從同一個佇列中刪除。

  • 單一批次可刪除的工作數量有限。詳情請參閱「配額與限制」。

  • 批次要求會將個別作業彙整成單一要求,但並非不可分割,因為批次中的某些作業可能會失敗,而其他作業則會成功。

  • 只有排定或調度的工作才能刪除。如果工作已順利完成,或是在持續失敗後用盡重試次數,則無法刪除。如果達到工作保留上限,系統會自動刪除工作。

  • 您也可以建立一批工作。詳情請參閱「建立一批工作」。

使用任何要求資料之前,請先修改下列項目的值:

  • TASK_NAME:要刪除的工作名稱,格式如下:projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks/TASK_ID
  • PROJECT_ID:您的 Google Cloud專案 ID
  • REGION:佇列所在的區域,例如 us-central1
  • QUEUE_ID:工作所屬的佇列名稱

要求主體包含工作名稱清單。

JSON 要求內文:

{
  "names": [
    "TASK_NAME"
  ]
}

請展開以下其中一個選項,以傳送要求:

如果成功,回應主體會包含 Operation 的執行個體。

{
  "name": "projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.tasks.v2.BatchDeleteTasksMetadata"
  },
  "done": false
}

清除佇列中的所有任務

您可以清除佇列中的「所有」任務。在清除呼叫之前建立的所有工作都會永久刪除。不過,清除作業最多可能需要一分鐘才會生效,而且工作可能會在清除生效前調度。

控制台

  1. 在 Google Cloud 控制台,依序前往「Cloud Tasks」>「Queues」(佇列) 頁面。

    前往「佇列」

  2. 按一下要刪除工作的佇列名稱。

  3. 按一下 「Purge queue」(清除佇列)。

  4. 在提示中按一下「Purge」(清除)。

gcloud

使用 gcloud tasks queues purge 指令清除佇列:

gcloud tasks queues purge QUEUE_ID \
    --location=LOCATION

更改下列內容:

  • QUEUE_ID:要清除的佇列名稱
  • LOCATION:部署佇列的區域,例如 us-central1

REST

如要清除佇列,請使用 projects.locations.queues.purge 方法。

使用任何要求資料之前,請先修改下列項目的值:

  • QUEUE_ID:要清除的佇列名稱
  • PROJECT_ID:您的 Google Cloud專案 ID
  • LOCATION:部署佇列的區域,例如 us-central1

要求主體必須為空白。

請展開以下其中一個選項,以傳送要求:

如果成功,回應主體會包含 Queue 的執行個體:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
  "rateLimits": {
    "maxDispatchesPerSecond": 500,
    "maxBurstSize": 100,
    "maxConcurrentDispatches": 1000
  },
  "retryConfig": {
    "maxAttempts": 100,
    "minBackoff": "0.100s",
    "maxBackoff": "3600s",
    "maxDoublings": 16
  },
  "state": "RUNNING",
  "purgeTime": "2025-03-28T13:06:30.110255Z"
}

暫停或繼續佇列

您可以暫停或繼續佇列。暫停佇列會停止執行及傳送任務。您仍可建立工作,並將工作推送或附加至佇列,但工作要等到佇列恢復後才會處理。恢復佇列後,Cloud Tasks 會開始調度待處理工作,但不會定義執行順序。如要恢復高流量佇列,且有大量待處理工作,請按照逐步增加流量的指南操作,避免目標超載。

控制台

  1. 在 Google Cloud 控制台,依序前往「Cloud Tasks」>「Queues」(佇列) 頁面。

    前往「佇列」

  2. 找出要暫停或繼續執行的佇列,然後勾選對應的核取方塊。

  3. 如要暫停佇列,請按一下 「Pause queue」(暫停佇列),然後在提示中按一下「Pause」(暫停)。

  4. 如要繼續處理暫停的佇列,請按一下 「Resume queue」(繼續處理佇列)。

gcloud

  1. 使用 gcloud tasks queues pause 指令暫停佇列:

    gcloud tasks queues pause QUEUE_ID \
        --location=LOCATION

    更改下列內容:

    • QUEUE_ID:要暫停的佇列名稱
    • LOCATION:部署佇列的區域,例如 us-central1
  2. 使用 gcloud tasks queues resume 指令恢復佇列:

    gcloud tasks queues resume QUEUE_ID \
        --location=LOCATION

REST

  1. 如要暫停佇列,請使用 projects.locations.queues.pause 方法。

    使用任何要求資料之前,請先修改下列項目的值:

    • QUEUE_ID:要暫停的佇列名稱
    • PROJECT_ID:您的 Google Cloud專案 ID
    • LOCATION:部署佇列的區域,例如 us-central1

    要求主體必須為空白。

    請展開以下其中一個選項,以傳送要求:

    如果成功,回應主體會包含 Queue 的執行個體:

    {
      "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
      "rateLimits": {
        "maxDispatchesPerSecond": 500,
        "maxBurstSize": 100,
        "maxConcurrentDispatches": 1000
      },
      "retryConfig": {
        "maxAttempts": 100,
        "minBackoff": "0.100s",
        "maxBackoff": "3600s",
        "maxDoublings": 16
      },
      "state": "PAUSED"
    }
    

  2. 如要繼續佇列,請使用 projects.locations.queues.resume 方法。

    使用任何要求資料之前,請先修改下列項目的值:

    • QUEUE_ID:: 要繼續執行的佇列名稱
    • PROJECT_ID:您的 Google Cloud專案 ID
    • LOCATION:部署佇列的區域,例如 us-central1

    要求主體必須為空白。

    請展開以下其中一個選項,以傳送要求:

    如果成功,回應主體會包含 Queue 的執行個體:

    {
      "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
      "rateLimits": {
        "maxDispatchesPerSecond": 500,
        "maxBurstSize": 100,
        "maxConcurrentDispatches": 1000
      },
      "retryConfig": {
        "maxAttempts": 100,
        "minBackoff": "0.100s",
        "maxBackoff": "3600s",
        "maxDoublings": 16
      },
      "state": "RUNNING"
    }
    

列出佇列

您可以列出佇列。列出佇列時,系統會傳回部分頻率限制和重試參數詳細資料。請注意,下列欄位的作用相同:

  • Max rate (控制台)、MAX_RATE (gcloud)、maxDispatchesPerSecond (REST)
  • Max concurrent (控制台)、MAX_NUM_OF_TASKS (gcloud)、maxConcurrentDispatches (REST)

控制台

  1. 在 Google Cloud 控制台,依序前往「Cloud Tasks」>「Queues」(佇列) 頁面。

    前往「佇列」

    系統會列出 Google Cloud 專案中的所有佇列。

  2. 如要瞭解詳情,請按一下佇列名稱,然後點選「Configuration」(設定) 分頁標籤。

    系統會顯示頻率限制和重試參數詳細資料。

gcloud

使用 gcloud tasks queues list 指令列出佇列:

gcloud tasks queues list \
    --location=LOCATION

將 LOCATION 替換為部署佇列的區域,例如 us-central1。如未指定位置,系統會使用 Google Cloud 專案 App Engine 應用程式的位置 (如有);否則,您必須指定位置。

畫面會顯示如下的輸出內容:

QUEUE_NAME: my-queue
STATE: PAUSED
MAX_NUM_OF_TASKS: 1000
MAX_RATE (/sec): 500.0
MAX_ATTEMPTS: 100
...

REST

如要列出佇列,請使用 projects.locations.queues.list 方法。

使用任何要求資料之前,請先修改下列項目的值:

  • PROJECT_ID:您的 Google Cloud專案 ID。
  • LOCATION:建立佇列的區域,例如 us-central1。

請展開以下其中一個選項,以傳送要求:

如果成功,回應主體會包含 Queue 資源的執行個體,且回應應與下列內容相似:

{
  "queues": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID",
      "rateLimits": {
        "maxDispatchesPerSecond": 500,
        "maxBurstSize": 100,
        "maxConcurrentDispatches": 1000
      },
      "retryConfig": {
        "maxAttempts": 100,
        "minBackoff": "0.100s",
        "maxBackoff": "3600s",
        "maxDoublings": 16
      },
      "state": "PAUSED",
      "purgeTime": "2025-03-28T13:37:32.292552Z"
    },
    ...
  ],
  "nextPageToken": "CjQKCHppcHBlcjIAEgwI9-GExAYQ_oDc1AMaGioLeWlrZXMtYWdhaW4yC3VzLWNlbnRyYWwx"
}

刪除佇列

您可以刪除不再需要的任何佇列,但App Engine default佇列除外。刪除佇列後,必須等待 3 天,才能以相同名稱重新建立佇列。無論是透過 Google Cloud 控制台、gcloud CLI、REST 或 RPC API,還是 Terraform 刪除佇列,都必須等待這段時間。這可防止刪除時執行的工作發生非預期行為,並避免在刪除和重新建立週期內發生內部程序失敗。

在這段最長 3 天的墓碑期間,佇列建立要求可能會顯示成功,但不會重新建立佇列。如要確認是否已重新建立同名佇列,請使用 gcloud tasks queues describe 指令或 projects.locations.queues.get 方法擷取佇列。如果收到成功 (200 OK) 回應,代表佇列已重新建立。

如要清除工作、修改佇列設定,或在 CI/CD 管道中管理佇列,而不遺失佇列或觸發 3 天等待期,請使用下列替代方案,而非刪除並重新建立佇列:

如要刪除佇列,請使用 Google Cloud 控制台、gcloud CLI 或 Cloud Tasks API:

控制台

  1. 在 Google Cloud 控制台,依序前往「Cloud Tasks」>「Queues」(佇列) 頁面。

    前往「佇列」

  2. 找出要刪除的佇列,然後勾選對應的核取方塊。

  3. 按一下 「Delete queue」(刪除佇列)。

  4. 在提示中輸入佇列名稱,然後按一下「確認」。

gcloud

使用 gcloud tasks queues delete 指令刪除佇列:

gcloud tasks queues delete QUEUE_ID \
    --location=LOCATION

更改下列內容:

  • QUEUE_ID:要刪除的佇列 ID 或完整 ID
  • LOCATION:部署佇列的區域,例如 us-central1

除非您傳遞 --quiet 旗標,否則 gcloud CLI 會在刪除佇列前提示您確認。

REST

如要刪除佇列,請使用 projects.locations.queues.delete 方法。

使用任何要求資料之前,請先修改下列項目的值:

  • QUEUE_ID:要刪除的佇列名稱
  • PROJECT_ID:您的 Google Cloud專案 ID
  • LOCATION:部署佇列的區域,例如 us-central1

要求主體必須為空白。

請展開以下其中一個選項,以傳送要求:

如果成功,回應主體會是空白。

後續步驟