Aviso de fim do suporte: em 13 de novembro de 2025, o suporte para o Amazon Elastic Transcoder AWS será interrompido. Depois de 13 de novembro de 2025, você não poderá mais acessar o console do Elastic Transcoder ou os recursos do Elastic Transcoder.

Para obter mais informações sobre a transição para AWS Elemental MediaConvert, visite esta [postagem do blog](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/).

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á.

# Cancelar trabalho
<a name="cancel-job"></a>

**Topics**
+ [Descrição](#cancel-job-description)
+ [Solicitações](#cancel-job-requests)
+ [Respostas](#cancel-job-responses)
+ [Erros](#cancel-job-response-errors)
+ [Exemplos](#cancel-job-examples)

## Descrição
<a name="cancel-job-description"></a>

Para cancelar um trabalho que o Elastic Transcoder não começou a processar, envie uma solicitação DELETE para o recurso `/2012-09-25/jobs/jobId`. O Elastic Transcoder ainda poderá retornar o trabalho se você enviar uma solicitação `Read Job`, `List Job by Pipeline` ou `List Job by Status`, mas ele não transcodificará o arquivo de entrada e você não será cobrado pelo trabalho.

**nota**  
Você só pode cancelar um trabalho com o status **Submitted**. Para impedir que um pipeline inicie o processamento de um trabalho enquanto você está obtendo o identificador de trabalho, use [Atualizar o status do pipeline](update-pipeline-status.md) para pausar temporariamente o pipeline.

## Solicitações
<a name="cancel-job-requests"></a>

### Sintaxe
<a name="cancel-job-request-syntax"></a>

```
DELETE /2012-09-25/jobs/jobId HTTP/1.1
Content-Type: charset=UTF-8
Accept: */*
Host: elastictranscoder.Elastic Transcoder endpoint.amazonaws.com:443
x-amz-date: 20130114T174952Z
Authorization: AWS4-HMAC-SHA256
               Credential=AccessKeyID/request-date/Elastic Transcoder endpoint/elastictranscoder/aws4_request,
               SignedHeaders=host;x-amz-date;x-amz-target,
               Signature=calculated-signature
```

### Parâmetro de solicitação
<a name="cancel-job-request-parameters"></a>

Esta operação aceita o seguinte parâmetro de solicitação. 

**jobId**  
O identificador do trabalho que você deseja cancelar.   
Para obter uma lista dos trabalhos (inclusive o `jobId`) cujo status de ação seja `Submitted`, use a ação de API [Listar trabalhos por status](list-jobs-by-status.md).

### Cabeçalhos de solicitação
<a name="cancel-job-request-headers"></a>

Essa operação usa somente os cabeçalhos de solicitação que são comuns a todas as operações. Para informações sobre os cabeçalhos de solicitação comuns, consulte [Conteúdo de cabeçalho HTTP](making-http-requests.md#http-request-header).

### Corpo da Solicitação
<a name="cancel-job-request-body"></a>

Essa operação não tem um corpo de solicitação.

## Respostas
<a name="cancel-job-responses"></a>

### Sintaxe
<a name="cancel-job-response-syntax"></a>

```
Status: 202 Accepted
x-amzn-RequestId: c321ec43-378e-11e2-8e4c-4d5b971203e9
Content-Type: application/json
Content-Length: number of characters in the response
Date: Mon, 14 Jan 2013 06:01:47 GMT

{
   "Success":"true"
}
```

### Cabeçalhos de resposta
<a name="cancel-job-response-headers"></a>

Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte [Respostas HTTP](making-http-requests.md#http-response-header).

### Corpo da resposta
<a name="cancel-job-response-body"></a>

O corpo da resposta contém o seguinte objeto JSON.

**Bem-sucedida**  
Se o trabalho for cancelado com êxito, o valor de `Success` será `true`.

## Erros
<a name="cancel-job-response-errors"></a>

Para obter mais informações sobre exceções e mensagens de erro do Elastic Transcoder, consulte [Tratamento de erros no Elastic Transcoder](error-handling.md).

## Exemplos
<a name="cancel-job-examples"></a>

O exemplo de solicitação a seguir cancela o trabalho com ID `3333333333333-abcde3`.

### Exemplo de solicitação
<a name="cancel-job-examples-sample-request"></a>

```
DELETE /2012-09-25/jobs/3333333333333-abcde3 HTTP/1.1
Content-Type: charset=UTF-8
Accept: */*
Host: elastictranscoder.Elastic Transcoder endpoint.amazonaws.com:443
x-amz-date: 20130114T174952Z
Authorization: AWS4-HMAC-SHA256
               Credential=AccessKeyID/request-date/Elastic Transcoder endpoint/elastictranscoder/aws4_request,
               SignedHeaders=host;x-amz-date;x-amz-target,
               Signature=calculated-signature
```

### Resposta da amostra
<a name="cancel-job-examples-sample-response"></a>

```
Status: 202 Accepted
x-amzn-RequestId: c321ec43-378e-11e2-8e4c-4d5b971203e9
Content-Type: application/json
Content-Length: number of characters in the response
Date: Mon, 14 Jan 2013 06:01:47 GMT
{
   "Success":"true"
}
```