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.

# Mettre à jour le statut du pipeline
<a name="update-pipeline-status"></a>

**Topics**
+ [Description](#update-pipeline-status-description)
+ [Requêtes](#update-pipeline-status-requests)
+ [Réponses](#update-pipeline-status-responses)
+ [Erreurs](#update-pipeline-status-response-errors)
+ [exemple](#update-pipeline-status-examples)

## Description
<a name="update-pipeline-status-description"></a>

Pour suspendre ou réactiver un pipeline, de sorte que celui-ci arrête ou redémarre le traitement des tâches, mettez à jour le statut du pipeline. Envoyez une demande POST à la ressource `/2012-09-25/pipelines/pipelineId/status`. 

Il est utile de modifier le statut du pipeline si vous souhaitez annuler une ou plusieurs tâches. Vous ne pouvez pas annuler des tâches une fois qu'Elastic Transcoder a commencé à les traiter ; si vous interrompez le pipeline auquel vous avez soumis les tâches, vous avez plus de temps IDs pour obtenir la tâche correspondant aux tâches que vous souhaitez annuler et pour envoyer une `Delete Job` demande. 

## Requêtes
<a name="update-pipeline-status-requests"></a>

### Syntaxe
<a name="update-pipeline-status-request-syntax"></a>

```
POST /2012-09-25/pipelines/pipelineId/status HTTP/1.1
Content-Type: application/json; 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
Content-Length: number of characters in the JSON string
{
   "Status":"new status for the pipeline"
}
```

### Paramètres de demande
<a name="update-pipeline-status-request-parameters"></a>

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

**pipelineId**  
Identifiant du pipeline à suspendre ou réactiver. 

### En-têtes de demande
<a name="update-pipeline-status-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="update-pipeline-status-request-body"></a>

La chaîne JSON contient l'objet suivant dans le corps de la demande. 

**Statut**  
Nouveau statut du pipeline :  
+ `Active` : active le pipeline, afin qu'il commence à traiter les tâches.
+ `Paused` : désactive le pipeline, afin qu'il arrête de traiter les tâches.

## Réponses
<a name="update-pipeline-status-responses"></a>

### Syntaxe
<a name="update-pipeline-status-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

{
   "Id":"ID for the pipeline",
   "Status":"new status for the pipeline"
}
```

### En-têtes de réponse
<a name="update-pipeline-status-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="update-pipeline-status-response-body"></a>

Lorsque vous mettez à jour le statut d'un pipeline, Elastic Transcoder renvoie les valeurs que vous avez spécifiées dans la demande. Pour de plus amples informations, veuillez consulter [Corps de la requête](#update-pipeline-status-request-body).

## Erreurs
<a name="update-pipeline-status-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)

## exemple
<a name="update-pipeline-status-examples"></a>

L'exemple de demande suivant active le pipeline comportant l'ID `1111111111111-abcde1`.

### Exemple de demande
<a name="update-pipeline-status-examples-sample-request"></a>

```
POST /2012-09-25/pipelines/1111111111111-abcde1/status HTTP/1.1
Content-Type: application/json; 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
Content-Length: number of characters in the JSON string
{
   "Status":"Active"
}
```

### Exemple de réponse
<a name="update-pipeline-status-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
{
   "Id":"1111111111111-abcde1",
   "Status":"Active"
}
```