Cancelar jobs

Esta página descreve como cancelar jobs em lote. Cancele os jobs que você quer interromper ou impedir.

O ideal é configurar os jobs para que eles parem de ser executados e falhem automaticamente. Por exemplo, configure os runnables para retornar um código de saída diferente de zero ou tempo limite sempre que eles não se comportarem como esperado. Mas, na prática, talvez você ainda queira interromper manualmente os trabalhos inacabados. Por exemplo, cancele um job quando você perceber que precisa resolver problemas ou substituir um job que ainda não foi concluído.

Assim como os jobs concluídos e com falha, um job cancelado permanece no projeto por até 60 dias, após o que o Google Cloud exclui automaticamente o job. Se você quiser cancelar um job e não precisar manter as informações dele, exclua o job imediatamente.

Antes de começar

  1. Se você nunca usou o Batch, consulte Começar a usar o Batch e ative o Batch concluindo os pré-requisitos para projetos e usuários.

  2. Para receber as permissões necessárias para cancelar um job, peça ao administrador para conceder a você o Editor de job em lote (roles/batch.jobsEditor) do IAM no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

    Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Cancelar um job

É possível cancelar um job usando a Google Cloud CLI ou a API Batch.

gcloud

Para cancelar um job usando a CLI gcloud, use o comando gcloud alpha batch jobs cancel:

gcloud alpha batch jobs cancel JOB_NAME --location LOCATION

Substitua:

  • JOB_NAME: o nome do job.
  • LOCATION: o local do job.

API

Para cancelar um job usando a API Batch, use o método jobs.cancel v1alpha:

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

Substitua:

  • PROJECT_ID: o ID do projeto do seu projeto.
  • LOCATION: o local do job.
  • JOB_NAME: o nome do job.

A seguir