Cancelar jobs

Nesta página, descrevemos como cancelar jobs do Batch. Cancele os jobs que você quer interromper ou impedir de serem executados.

O ideal é configurar os jobs para que eles parem de ser executados e falhem automaticamente sempre que não se comportarem como esperado. Por exemplo, configure seus executáveis para retornar um código de saída diferente de zero ou um tempo limite. Mas, na prática, talvez você ainda queira interromper manualmente os jobs inconclusos. Por exemplo, cancele um job quando 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 seu projeto por até 60 dias. Depois disso, o Google Cloud exclui o job automaticamente. 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, leia Começar a usar o Batch e ative o serviço 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 de Editor de jobs 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 gcloud ou a API Batch.

gcloud

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

gcloud 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:

POST https://batch.googleapis.com/v1/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