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 name="cancel-job-api"></a>

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 [CancelJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_CancelJob.html)a *Amazon Location Service API Reference*.

Por exemplo, solicitações, respostas e comandos da CLI para essa API, consulte [Como cancelar um trabalho](https://docs.aws.amazon.com/location/latest/developerguide/canceling-job.html).

## Casos de uso
<a name="cancel-job-use-cases"></a>
+ **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 name="cancel-job-request-parameters"></a>

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 name="cancel-job-response-details"></a>

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.