Excluir tarefas e filas

Esta página descreve como excluir tarefas de uma fila push e como excluir filas. Em alguns casos, será preciso excluir uma tarefa que não pode ser concluída, não importa quantas tentativas sejam feitas.

Essa API é compatível com os ambientes de execução de primeira geração e pode ser usada ao fazer upgrade para os ambientes de execução de segunda geração correspondentes. Se você estiver atualizando para o ambiente de execução do Java 11/17 do App Engine, consulte o guia de migração para saber mais sobre as opções de migração para serviços incluídos legados.

Como excluir tarefas de uma fila

API

Use deleteTask() para excluir uma tarefa individual:

// Delete an individual task...
Queue q = QueueFactory.getQueue("queue1");
q.deleteTask("foo")

Console

Para excluir uma tarefa do Console do Google Cloud:

1. Abra a página "Cloud Tasks" no console.

   Ir para o Cloud Tasks

2. Clique no nome da fila da qual você quer remover a tarefa.

3. Selecione a tarefa que você quer excluir e clique em Excluir tarefas selecionadas.

   

4. Clique em Excluir.

Como limpar todas as tarefas de uma fila

API

Use purge() para excluir todas as tarefas da fila especificada:

// Purge entire queue...
Queue queue = QueueFactory.getQueue("foo");
queue.purge();

Console

Para excluir uma tarefa do Console do Google Cloud:

1. Abra a página "Cloud Tasks" no console.

   Ir para o Cloud Tasks

2. Clique no nome da fila da qual você quer remover a tarefa.

3. Selecione a tarefa que você quer excluir e clique em Excluir todas as tarefas.

   

4. Clique em Excluir.

Todas as tarefas criadas antes do momento da limpeza são excluídas. As operações de limpeza podem levar até um minuto para serem finalizadas.

A recuperação das cotas liberadas após a limpeza de uma fila pode levar algumas horas.

Aviso: não crie novas tarefas logo depois de limpar uma fila. Aguarde pelo menos um segundo. Tarefas criadas com muita proximidade temporal a uma chamada de limpeza também são limpas.

Como pausar filas

Para pausar uma fila, remova a definição dela do arquivo queue.yaml e faça upload do arquivo queue.yaml editado. Definir a taxa de qualquer fila como zero também pausa a fila.

Nenhuma das tarefas que permanecerem em uma fila pausada ou novas tarefas adicionadas a ela serão processadas. É possível retomar a fila pausada. Para isso, faça o upload de um novo arquivo queue.yaml com a fila e a taxa definidas como um valor diferente de zero. As filas desativadas continuam contando como parte da cota.

Também é possível pausar uma fila na página Cloud Tasks no Console do Google Cloud

Como excluir filas

A prática recomendada é pausar uma fila antes de excluí-la:

1. Remova a definição da fila do arquivo queue.yaml.

2. Faça upload da alteração no arquivo queue.yaml.

   gcloud app deploy queue.yaml

Depois que a fila for removida do arquivo queue.yaml, use o console do Google Cloud para excluí-la.

1. No console do Google Cloud, selecione a fila.

   Ir para o Cloud Tasks

2. Clique em Excluir fila.

Se você excluir uma fila do Console do Google Cloud, precisará aguardar sete dias antes de recriar outra com o mesmo nome.