Cloud Tasks 可讓您控管非同步工作負載執行作業、暫停佇列處理,以及排解進行中的工作流程問題。您可以使用 Google Cloud 控制台、Google Cloud CLI 或 Cloud Tasks API,設定及維護佇列和任務。
事前準備
- 確認您已有 Cloud Tasks 工作佇列。詳情請參閱「建立 Cloud Tasks 佇列」。
- 確認您具備管理佇列和工作所需的 Identity and Access Management (IAM) 角色,例如 Cloud Tasks 管理員 (
roles/cloudtasks.admin)、Cloud Tasks 佇列管理員 (roles/cloudtasks.queueAdmin) 或 Cloud Tasks 工作刪除者 (roles/cloudtasks.taskDeleter)。
從佇列中刪除任務
您可以刪除已排定或已調度的任務。舉例來說,如果某項工作無論重試多少次都無法順利完成,您可能需要刪除該工作。如果工作已順利完成,或在持續失敗後用盡重試次數,則無法刪除。如果達到工作保留上限,系統會自動刪除工作。
控制台
在 Google Cloud 控制台,依序前往「Cloud Tasks」>「Queues」(佇列) 頁面。
按一下要刪除的工作所屬佇列名稱。
找出要刪除的工作,然後勾選對應的核取方塊。
按一下 「Delete task」(刪除工作)。
在系統的提示訊息中,按一下 [刪除]。
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專案 IDLOCATION:佇列所在的區域,例如us-central1
要求主體必須為空白。
請展開以下其中一個選項,以傳送要求:
如果成功,回應主體會是空白。
從佇列中刪除一批任務
您可以使用 projects.locations.queues.tasks.batchDelete 方法刪除工作名稱清單,從佇列中刪除一批工作。
注意事項:
所有工作都必須從同一個佇列中刪除。
單一批次可刪除的工作數量有限。詳情請參閱「配額與限制」。
批次要求會將個別作業彙整成單一要求,但並非不可分割,因為批次中的某些作業可能會失敗,而其他作業則會成功。
只有排定或調度的工作才能刪除。如果工作已順利完成,或是在持續失敗後用盡重試次數,則無法刪除。如果達到工作保留上限,系統會自動刪除工作。
您也可以建立一批工作。詳情請參閱「建立一批工作」。
使用任何要求資料之前,請先修改下列項目的值:
TASK_NAME:要刪除的工作名稱,格式如下:projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks/TASK_IDPROJECT_ID:您的 Google Cloud專案 IDREGION:佇列所在的區域,例如us-central1QUEUE_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
}
清除佇列中的所有任務
您可以清除佇列中的「所有」任務。在清除呼叫之前建立的所有工作都會永久刪除。不過,清除作業最多可能需要一分鐘才會生效,而且工作可能會在清除生效前調度。
控制台
在 Google Cloud 控制台,依序前往「Cloud Tasks」>「Queues」(佇列) 頁面。
按一下要刪除工作的佇列名稱。
按一下 「Purge queue」(清除佇列)。
在提示中按一下「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專案 IDLOCATION:部署佇列的區域,例如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 會開始調度待處理工作,但不會定義執行順序。如要恢復高流量佇列,且有大量待處理工作,請按照逐步增加流量的指南操作,避免目標超載。
控制台
在 Google Cloud 控制台,依序前往「Cloud Tasks」>「Queues」(佇列) 頁面。
找出要暫停或繼續執行的佇列,然後勾選對應的核取方塊。
如要暫停佇列,請按一下 「Pause queue」(暫停佇列),然後在提示中按一下「Pause」(暫停)。
如要繼續處理暫停的佇列,請按一下 「Resume queue」(繼續處理佇列)。
gcloud
使用
gcloud tasks queues pause指令暫停佇列:gcloud tasks queues pause QUEUE_ID \ --location=LOCATION
更改下列內容:
QUEUE_ID:要暫停的佇列名稱LOCATION:部署佇列的區域,例如us-central1
使用
gcloud tasks queues resume指令恢復佇列:gcloud tasks queues resume QUEUE_ID \ --location=LOCATION
REST
如要暫停佇列,請使用
projects.locations.queues.pause方法。使用任何要求資料之前,請先修改下列項目的值:
QUEUE_ID:要暫停的佇列名稱PROJECT_ID:您的 Google Cloud專案 IDLOCATION:部署佇列的區域,例如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" }如要繼續佇列,請使用
projects.locations.queues.resume方法。使用任何要求資料之前,請先修改下列項目的值:
QUEUE_ID:: 要繼續執行的佇列名稱PROJECT_ID:您的 Google Cloud專案 IDLOCATION:部署佇列的區域,例如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)
控制台
在 Google Cloud 控制台,依序前往「Cloud Tasks」>「Queues」(佇列) 頁面。
系統會列出 Google Cloud 專案中的所有佇列。
如要瞭解詳情,請按一下佇列名稱,然後點選「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 天等待期,請使用下列替代方案,而非刪除並重新建立佇列:
清除佇列:使用
gcloud tasks queues purge指令或projects.locations.queues.purge方法清除佇列中的所有任務,同時保持佇列運作。就地更新佇列:使用
gcloud tasks queues update指令或projects.locations.queues.patch方法,修改現有佇列的頻率限制、重試參數或轉送。詳情請參閱「設定佇列轉送、限制和重試」。暫停佇列:使用
gcloud tasks queues pause指令或projects.locations.queues.pause方法暫停佇列,即可暫時停止調度工作,同時保留佇列中的工作。設定生命週期防護機制:在基礎架構即程式碼範本中設定防刪除功能,例如在 Terraform
lifecycle區塊中設定prevent_destroy = true,防止在自動部署期間意外刪除佇列。
如要刪除佇列,請使用 Google Cloud 控制台、gcloud CLI 或 Cloud Tasks API:
控制台
在 Google Cloud 控制台,依序前往「Cloud Tasks」>「Queues」(佇列) 頁面。
找出要刪除的佇列,然後勾選對應的核取方塊。
按一下 「Delete queue」(刪除佇列)。
在提示中輸入佇列名稱,然後按一下「確認」。
gcloud
使用 gcloud tasks queues delete 指令刪除佇列:
gcloud tasks queues delete QUEUE_ID \ --location=LOCATION
更改下列內容:
QUEUE_ID:要刪除的佇列 ID 或完整 IDLOCATION:部署佇列的區域,例如us-central1
除非您傳遞 --quiet 旗標,否則 gcloud CLI 會在刪除佇列前提示您確認。
REST
如要刪除佇列,請使用 projects.locations.queues.delete 方法。
使用任何要求資料之前,請先修改下列項目的值:
QUEUE_ID:要刪除的佇列名稱PROJECT_ID:您的 Google Cloud專案 IDLOCATION:部署佇列的區域,例如us-central1
要求主體必須為空白。
請展開以下其中一個選項,以傳送要求:
如果成功,回應主體會是空白。