Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Gerenciar filas e tarefas

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

No console do Google Cloud
Usando a Google Cloud CLI 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 agendada ou enviada. Por exemplo, talvez seja necessário excluir uma tarefa que não pode ser concluída, não importa quantas tentativas sejam feitas. Não é possível excluir uma tarefa se ela foi concluída com sucesso ou se as tentativas acabaram após falhas constantes. Uma tarefa é excluída automaticamente quando o limite máximo de retenção de tarefas é atingido.

Console

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

Acessar "Filas"
Clique no nome da fila da tarefa que você quer excluir.
Marque a caixa de seleção da tarefa que você quer excluir.
Clique em Excluir tarefa.
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 a que a tarefa pertence
TASK_NAME: o nome da tarefa que você quer excluir
PROJECT_ID: o ID do projeto do 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:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID/tasks/TASK_NAME"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID/tasks/TASK_NAME" | Select-Object -Expand Content

APIs Explorer (navegador)

Abra a página de referência do método. O painel "APIs Explorer" é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Preencha todos os campos obrigatórios e clique em Executar.

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

Excluir um lote de tarefas de uma fila

É possível excluir um lote de tarefas de uma fila usando o método projects.locations.queues.tasks.batchDelete para excluir uma lista de nomes de tarefas.

Observe o seguinte:

Todas as tarefas precisam ser excluídas da mesma fila.
Há um limite de quantas tarefas podem ser excluídas em um único lote. Para mais informações, consulte Cotas e limites.
As solicitações em lote, que agregam operações individuais em uma única solicitação, não são atômicas porque é possível que algumas das operações contidas no lote falhem enquanto outras são concluídas.
Só é possível excluir uma tarefa se ela estiver agendada ou enviada. Não é possível excluir uma tarefa se ela foi concluída com sucesso ou se as tentativas acabaram após falhas constantes. Uma tarefa é excluída automaticamente se o limite máximo de retenção de tarefas for atingido.
Também é possível criar um lote de tarefas. Para mais informações, consulte Criar um lote de tarefas.

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

TASK_NAME: o nome das tarefas a serem excluídas no seguinte formato: projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks/TASK_ID
PROJECT_ID: o ID do projeto do Google Cloud
REGION: a região em que a fila existe, por exemplo, us-central1.
QUEUE_ID: o nome da fila a que as tarefas pertencem.

O corpo da solicitação contém uma lista de nomes de tarefas.

Corpo JSON da solicitação:

{
  "names": [
    "TASK_NAME"
  ]
}

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

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo chamado request.json. Execute o comando a seguir no terminal para criar ou substituir esse arquivo no diretório atual:

cat > request.json << 'EOF'
{
  "names": [
    "TASK_NAME"
  ]
}
EOF

Depois execute o comando a seguir para enviar a solicitação REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://cloudtasks.googleapis.com/v2beta3/projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks:batchDelete"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo chamado request.json. Execute o comando a seguir no terminal para criar ou substituir esse arquivo no diretório atual:

@'
{
  "names": [
    "TASK_NAME"
  ]
}
'@  | Out-File -FilePath request.json -Encoding utf8

Depois execute o comando a seguir para enviar a solicitação REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://cloudtasks.googleapis.com/v2beta3/projects/PROJECT_ID/locations/REGION/queues/QUEUE_ID/tasks:batchDelete" | Select-Object -Expand Content

APIs Explorer (navegador)

Copie o corpo da solicitação e abra a página de referência do método. O painel APIs Explorer é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Cole o corpo da solicitação nessa ferramenta, preencha todos os outros campos obrigatórios e clique em Executar.

Se a solicitação for bem-sucedida, o corpo da resposta vai conter uma instância de Operation.

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

Limpar todas as tarefas de uma fila

É possível excluir todas as tarefas de uma fila limpando-as. 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 da limpeza.

Console

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

Acessar "Filas"
Clique no nome da fila com as tarefas que você quer excluir.
Clique em Limpar fila.
No prompt, clique em Limpar.

gcloud

Limpe 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 do 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:

curl (Linux, macOS ou Cloud Shell)

Execute o seguinte comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:purge"

PowerShell (Windows)

execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:purge" | Select-Object -Expand Content

APIs Explorer (navegador)

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. Você ainda pode criar tarefas e enviá-las ou anexá-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.

Console

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

Acessar "Filas"
Marque a caixa de seleção da fila que você quer pausar.
Clique em Pausar fila.
Na solicitação, clique em Pausar.
Para retomar a fila, clique em Retomar fila.

gcloud

Pause 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

Retome uma fila usando o comando gcloud tasks queues resume:

gcloud tasks queues resume QUEUE_ID \
    --location=LOCATION

REST

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 do 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:
curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:pause"
```
PowerShell (Windows)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

execute o seguinte comando:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:pause" | Select-Object -Expand Content
```
APIs Explorer (navegador)

Abra a página de referência do método. O painel "APIs Explorer" é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Preencha todos os campos obrigatórios e clique em Executar.

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"
}
```
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 do 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:
curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:
```
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:resume"
```
PowerShell (Windows)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

execute o seguinte comando:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID:resume" | Select-Object -Expand Content
```
APIs Explorer (navegador)

Abra a página de referência do método. O painel "APIs Explorer" é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Preencha todos os campos obrigatórios e clique em Executar.

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"
}
```

Listar filas

É possível listar filas. Ao listar filas, alguns detalhes de limite de taxa e parâmetro de nova tentativa são retornados. Os seguintes campos são equivalentes:

Taxa máxima (console), MAX_RATE (gcloud), maxDispatchesPerSecond (REST)
Máximo de simultâneas (console), MAX_NUM_OF_TASKS (gcloud), maxConcurrentDispatches (REST)

Console

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

Acessar "Filas"

Todas as filas no seu projeto Google Cloud são listadas.
Para mais detalhes, clique no nome de uma fila e na guia Configuração.

Os detalhes do parâmetro de limitação de taxa e de nova tentativa são mostrados.

gcloud

Liste as filas usando o comando gcloud tasks queues list:

gcloud tasks queues list \
    --location=LOCATION

Substitua LOCATION pela região em que a fila está implantada. Por exemplo, us-central1. Se um local não for especificado, o local do aplicativo do App Engine do projeto Google Cloud será usado, se existir. Caso contrário, especifique um local.

A saída será semelhante a esta:

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

REST

Para listar filas, use o método projects.locations.queues.list.

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

PROJECT_ID: o ID do projeto do Google Cloud.
LOCATION: a região em que as filas são criadas, por exemplo, us-central1.

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

curl (Linux, macOS ou Cloud Shell)

Execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues"

PowerShell (Windows)

execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues" | Select-Object -Expand Content

APIs Explorer (navegador)

Se a operação for bem-sucedida, o corpo da resposta vai conter instâncias de recursos Queue, e a resposta será semelhante a esta:

{
  "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"
}

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 em execução no momento da exclusão ou aguardando para serem executadas. Isso também evita falhas de processos internos no ciclo de exclusão ou recriação.

Console

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

Acessar "Filas"
Marque a caixa de seleção da fila que você quer excluir.
Clique em Excluir fila.
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 do 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:

curl (Linux, macOS ou Cloud Shell)

Execute o seguinte comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID"

PowerShell (Windows)

execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://cloudtasks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/queues/QUEUE_ID" | Select-Object -Expand Content

APIs Explorer (navegador)

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

Gerenciar filas e tarefas Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Excluir uma tarefa de uma fila

Console

gcloud

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

APIs Explorer (navegador)

Excluir um lote de tarefas de uma fila

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

APIs Explorer (navegador)

Limpar todas as tarefas de uma fila

Console

gcloud

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

APIs Explorer (navegador)

Pausar ou retomar filas

Console

gcloud

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

APIs Explorer (navegador)

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

APIs Explorer (navegador)

Listar filas

Console

gcloud

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

APIs Explorer (navegador)

Excluir filas

Console

gcloud

REST

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

APIs Explorer (navegador)

A seguir

Gerenciar filas e tarefas