Cancelar jobs

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

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. Na prática, talvez você ainda queira interromper manualmente os trabalhos inacabados. Por exemplo, cancele uma tarefa quando perceber que precisa solucionar 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 o exclui automaticamente. Se você quiser cancelar um job e não precisar reter as informações dele, pode excluir 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 papel do IAM Editor de job em lote (roles/batch.jobsEditor) 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 CLI do Google Cloud 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