View a markdown version of this page

CancelJob - Amazon Location Service
Casos de usoSobre a solicitaçãoSobre a resposta

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

CancelJob

A CancelJob operação interrompe um trabalho em execução ou pendente. Somente trabalhos nos estados Pendente ou Em execução podem ser cancelados. O cancelamento é assíncrono, portanto, você deve monitorar o status do trabalho para confirmar a conclusão. Os trabalhos cancelados podem ter resultados parciais no local de saída, dependendo de quando o cancelamento ocorre durante o processamento.

Para obter mais informações, consulte CancelJoba Amazon Location Service API Reference.

Por exemplo, solicitações, respostas e comandos da CLI para essa API, consulte Como cancelar um trabalho.

Casos de uso

  • Pare o processamento desnecessário: cancele trabalhos que foram enviados com configuração incorreta, que não são mais necessários devido a alterações nos requisitos comerciais ou que foram iniciados por engano. Isso pode evitar desperdício de recursos e cobranças desnecessárias.

  • Otimização de recursos e custos: libere a capacidade de processamento cancelando trabalhos de menor prioridade quando tarefas de maior prioridade precisarem ser processadas.

Sobre a solicitação

A CancelJob solicitação exige apenas um único parâmetro para identificar qual trabalho cancelar. Essa estrutura de solicitação simples facilita a interrupção do processamento de trabalhos que não são mais necessários.

A solicitação inclui o seguinte parâmetro:

Identificação do trabalho

Parâmetro obrigatório que especifica qual trabalho cancelar.

  • JobId: o identificador exclusivo do trabalho a ser cancelado. Deve ter de 1 a 100 caracteres que correspondam ao padrão[-._\w]+. Esse é o mesmo identificador retornado pela StartJob operação quando o trabalho foi criado. Somente trabalhos em Pending ou Running status podem ser cancelados.

Sobre a resposta

A CancelJob resposta confirma a solicitação de cancelamento e fornece o status atualizado do trabalho. Como o cancelamento é assíncrono, você deve usar a GetJob operação para monitorar a tarefa até que ela atinja o status. Cancelled

A resposta inclui os seguintes campos:

Identificação do trabalho

Identificadores exclusivos para o trabalho que está sendo cancelado.

  • JobId: O identificador exclusivo do trabalho.

  • JobArn: Amazon Resource Name (ARN) do trabalho que está sendo cancelado.

Status de cancelamento

Status atual do trabalho após a solicitação de cancelamento.

  • Status: Status do trabalho imediatamente após a solicitação de cancelamento. Normalmente, Cancelling para indicar que o cancelamento está em andamento. O status muda para Cancelled quando o cancelamento é concluído. Use GetJob para monitorar essa transição.

nota

Os trabalhos cancelados podem ter resultados parciais no local de saída, dependendo de quando o cancelamento ocorre durante o processamento. Verifique o local de saída para determinar se algum dado parcial foi gravado antes da conclusão do cancelamento. Você é cobrado pelo número de registros que foram processados e gravados em seu bucket de saída antes do cancelamento do trabalho.