Gerenciar filas e tarefas

É possível gerenciar filas e tarefas das seguintes maneiras:

  • No console do Google Cloud
  • Usando a CLI do Google Cloud no terminal ou no Cloud Shell
  • Enviando uma solicitação para a API Cloud Tasks

Excluir uma tarefa de uma fila

É possível excluir uma tarefa se ela estiver programada ou enviada. Por exemplo, talvez seja necessário excluir uma tarefa que não pode ser concluída, não importa quantas vezes ela for refeita. Não é possível excluir uma tarefa se ela foi concluída ou se ela esgotou as tentativas depois de falhas constantes.

Console

  1. No console do Google Cloud, acesse a página Cloud Tasks > Queues.

    Acessar Filas

  2. Clique no nome da fila da tarefa que você quer excluir.

  3. Marque a caixa de seleção da tarefa que você quer excluir.

  4. Clique em Excluir tarefa.

  5. No prompt, clique em Excluir.

gcloud

Exclua uma tarefa usando o comando gcloud tasks delete:

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

Substitua:

  • TASK_NAME: o nome da tarefa que você quer excluir.
  • QUEUE_ID: o nome da fila a que a tarefa pertence
  • LOCATION: a região em que a fila é implantada. Por exemplo, us-central1

REST

Para excluir uma tarefa, use o método projects.locations.queues.tasks.delete.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • QUEUE_ID: o nome da fila à qual a tarefa pertence
  • TASK_NAME: o nome da tarefa que você quer excluir
  • PROJECT_ID: o ID do projeto Google Cloud
  • LOCATION: a região em que a fila existe. Por exemplo, us-central1

O corpo da solicitação precisa estar vazio.

Para enviar a solicitação, expanda uma destas opções:

Se a solicitação for concluída, o corpo da resposta estará vazio.

Limpar todas as tarefas de uma fila

É possível excluir todas as tarefas de uma fila com a limpeza. Todas as tarefas criadas antes da chamada de limpeza são excluídas permanentemente. No entanto, as operações de limpeza podem levar até um minuto para entrar em vigor, e as tarefas podem ser enviadas antes que a limpeza entre em vigor.

Console

  1. No console do Google Cloud, acesse a página Cloud Tasks > Queues.

    Acessar Filas

  2. Clique no nome da fila das tarefas que você quer excluir.

  3. Clique em Limpar fila.

  4. No prompt, clique em Limpar.

gcloud

Excluir uma fila usando o comando gcloud tasks queues purge:

gcloud tasks queues purge QUEUE_ID \
    --location=LOCATION

Substitua:

  • QUEUE_ID: o nome da fila que você quer limpar
  • LOCATION: a região em que a fila é implantada. Por exemplo, us-central1

REST

Para limpar uma fila, use o método projects.locations.queues.purge.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • QUEUE_ID: o nome da fila que você quer limpar.
  • PROJECT_ID: o ID do projeto Google Cloud
  • LOCATION: a região em que a fila é implantada. Por exemplo, us-central1

O corpo da solicitação precisa estar vazio.

Para enviar a solicitação, expanda uma destas opções:

Se houver êxito, o corpo da resposta conterá uma instância de 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"
}

Pausar ou retomar filas

É possível pausar ou retomar uma fila. Pausar uma fila significa que a execução e a entrega de tarefas são interrompidas. Ainda é possível criar tarefas e enviá-las ou adicioná-las à fila, mas elas não serão processadas. Quando a fila é retomada, todas as tarefas pendentes são processadas na ordem em que foram adicionadas ao backlog da fila.

Console

  1. No console do Google Cloud, acesse a página Cloud Tasks > Queues.

    Acessar Filas

  2. Marque a caixa de seleção da fila que você quer pausar.

  3. Clique em Pausar fila.

  4. No prompt, clique em Pausar.

  5. Para retomar a fila, clique em Retomar fila.

gcloud

  1. Pausar uma fila usando o comando gcloud tasks queues pause:

    gcloud tasks queues pause QUEUE_ID \
    --location=LOCATION

    Substitua:

    • QUEUE_ID: o nome da fila que você quer pausar.
    • LOCATION: a região em que a fila é implantada. Por exemplo, us-central1

  2. Retome uma fila usando o comando gcloud tasks queues resume:

    gcloud tasks queues resume QUEUE_ID \
    --location=LOCATION

REST

  1. Para pausar uma fila, use o método projects.locations.queues.pause.

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • QUEUE_ID: o nome da fila que você quer pausar
    • PROJECT_ID: o ID do projeto Google Cloud
    • LOCATION: a região em que a fila é implantada. Por exemplo, us-central1

    O corpo da solicitação precisa estar vazio.

    Para enviar a solicitação, expanda uma destas opções:

    Se houver êxito, o corpo da resposta conterá uma instância de 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. Para retomar uma fila, use o método projects.locations.queues.resume.

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • QUEUE_ID: o nome da fila que você quer retomar.
    • PROJECT_ID: o ID do projeto Google Cloud
    • LOCATION: a região em que a fila é implantada. Por exemplo, us-central1

    O corpo da solicitação precisa estar vazio.

    Para enviar a solicitação, expanda uma destas opções:

    Se houver êxito, o corpo da resposta conterá uma instância de 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"
}

Excluir filas

É possível excluir uma fila. Todas as tarefas na fila também são excluídas. Se você excluir uma fila, aguarde três dias antes de recriar com o mesmo nome. Esse período de espera evita comportamentos inesperados em tarefas que estão sendo executadas no momento da exclusão ou aguardando execução. Isso também evita falhas de processo interno no ciclo de exclusão ou recriação.

Console

  1. No console do Google Cloud, acesse a página Cloud Tasks > Queues.

    Acessar Filas

  2. Marque a caixa de seleção da fila que você quer excluir.

  3. Clique em Excluir fila.

  4. No prompt, digite o nome da fila e clique em Confirmar.

gcloud

Exclua uma fila usando o comando gcloud tasks queues delete:

gcloud tasks queues delete QUEUE_ID \
    --location=LOCATION

Substitua:

  • QUEUE_ID: o nome da fila que você quer excluir.
  • LOCATION: a região em que a fila é implantada. Por exemplo, us-central1

REST

Para excluir uma fila, use o método projects.locations.queues.delete.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • QUEUE_ID: o nome da fila que você quer excluir.
  • PROJECT_ID: o ID do projeto Google Cloud
  • LOCATION: a região em que a fila é implantada. Por exemplo, us-central1

O corpo da solicitação precisa estar vazio.

Para enviar a solicitação, expanda uma destas opções:

Se a solicitação for concluída, o corpo da resposta estará vazio.