Avis de fin de support : le 13 novembre 2025, le support d'Amazon Elastic Transcoder AWS sera interrompu. Après le 13 novembre 2025, vous ne pourrez plus accéder à la console Elastic Transcoder ni aux ressources Elastic Transcoder.

Pour plus d'informations sur la transition vers AWS Elemental MediaConvert, consultez ce billet de [blog](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Annuler une tâche
<a name="cancel-job"></a>

**Topics**
+ [Description](#cancel-job-description)
+ [Requêtes](#cancel-job-requests)
+ [Réponses](#cancel-job-responses)
+ [Erreurs](#cancel-job-response-errors)
+ [Exemples](#cancel-job-examples)

## Description
<a name="cancel-job-description"></a>

Pour annuler une tâche qu'Elastic Transcoder n'a pas encore commencé à traiter, envoyez une demande DELETE à la `/2012-09-25/jobs/jobId` ressource. Elastic Transcoder peut toujours renvoyer la tâche si vous soumettez une ou une `List Job by Status` demande `Read Job``List Job by Pipeline`, mais Elastic Transcoder ne transcodera pas le fichier d'entrée et la tâche ne vous sera pas facturée.

**Note**  
Vous pouvez annuler une tâche uniquement si elle présente le statut **Submitted**. Pour empêcher un pipeline de commencer à traiter une tâche pendant que vous obtenez l'identifiant de la tâche, utilisez [Mettre à jour le statut du pipeline](update-pipeline-status.md) pour suspendre temporairement le pipeline.

## Requêtes
<a name="cancel-job-requests"></a>

### Syntaxe
<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
```

### Paramètre de demande
<a name="cancel-job-request-parameters"></a>

Cette opération prend le paramètre de demande suivant. 

**jobId**  
Identifiant de la tâche à annuler.   
Pour obtenir une liste des tâches (y compris leur `jobId`) dotées d'un statut `Submitted`, utilisez l'action d'API [Liste des tâches par statut](list-jobs-by-status.md).

### En-têtes de demande
<a name="cancel-job-request-headers"></a>

Cette opération utilise uniquement les en-têtes de demande qui sont communs à toutes les opérations. Pour plus d'informations sur les en-têtes de demande communs, consultez [Contenu de l'en-tête HTTP](making-http-requests.md#http-request-header).

### Corps de la requête
<a name="cancel-job-request-body"></a>

Cette opération n'a pas de corps de demande.

## Réponses
<a name="cancel-job-responses"></a>

### Syntaxe
<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"
}
```

### En-têtes de réponse
<a name="cancel-job-response-headers"></a>

Cette opération utilise uniquement les en-têtes de réponse qui sont communs à la plupart des réponses. Pour plus d'informations sur les en-têtes de réponse communs, consultez [Réponses HTTP](making-http-requests.md#http-response-header).

### Corps de la réponse
<a name="cancel-job-response-body"></a>

Le corps de la réponse contient l'objet JSON suivant.

**Succès**  
Si la tâche est supprimée correctement, la valeur de `Success` est `true`.

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

Pour plus d'informations sur les exceptions et les messages d'erreur d'Elastic Transcoder, consultez. [Gestion des erreurs dans Elastic Transcoder](error-handling.md)

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

L'exemple de demande suivant annule la tâche comportant l'ID `3333333333333-abcde3`.

### Exemple de demande
<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
```

### Exemple de réponse
<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"
}
```