Cancele tarefas

Esta página descreve como cancelar tarefas em lote. Cancelar tarefas que quer parar de executar ou impedir que sejam executadas.

Idealmente, deve configurar as suas tarefas para pararem automaticamente de ser executadas e falharem sempre que não se comportarem como previsto. Por exemplo, configure os seus runnables para devolver um código de saída diferente de zero ou um tempo limite. No entanto, na prática, pode querer parar manualmente as tarefas não concluídas. Por exemplo, cancelar um trabalho quando se apercebe de que precisa de resolver problemas ou substituir um trabalho que ainda não terminou.

Tal como os trabalhos bem-sucedidos e com falhas, um trabalho cancelado permanece no seu projeto durante um período máximo de 60 dias, após o qual Google Cloud elimina automaticamente o trabalho. Se quiser cancelar uma tarefa e não precisar de reter as informações da tarefa, pode eliminar imediatamente a tarefa.

Antes de começar

  1. Se nunca usou o Batch, reveja o artigo Comece a usar o Batch e ative o Batch concluindo os pré-requisitos para projetos e utilizadores.

  2. Para receber as autorizações de que precisa para cancelar uma tarefa, peça ao seu administrador para lhe conceder a função de IAM Editor de tarefas em lote (roles/batch.jobsEditor) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

    Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Cancelar uma tarefa

Pode cancelar uma tarefa através da CLI gcloud ou da API Batch.

gcloud

Para cancelar uma tarefa através da CLI gcloud, use o comando gcloud batch jobs cancel:

gcloud batch jobs cancel JOB_NAME --location LOCATION

Substitua o seguinte:

  • JOB_NAME: o nome da tarefa.
  • LOCATION: a localização da tarefa.

API

Para cancelar uma tarefa através da API Batch, use o método jobs.cancel:

POST https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME:cancel

Substitua o seguinte:

O que se segue?