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 les notifications de pipeline
<a name="update-pipeline-notifications"></a>

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

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

Pour mettre à jour uniquement les notifications Amazon Simple Notification Service (Amazon SNS) relatives à un pipeline, envoyez une requête POST à la ressource. `/2012-09-25/pipelines/pipelineId/notifications`

**Important**  
Lorsque vous modifiez des notifications, vos changements prennent effet immédiatement. Les tâches que vous avez déjà soumises et qu'Elastic Transcoder n'a pas encore commencé à traiter sont concernées, en plus des tâches que vous soumettez après avoir reçu des notifications de modification.

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

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

```
POST /2012-09-25/pipelines/pipelineId/notifications 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
{
   "Id":"pipelineId",
   "Notifications":{
      "Progressing":"SNS topic to notify when
         Elastic Transcoder has started to process the job",
      "Complete":"SNS topic to notify when
         Elastic Transcoder has finished processing the job",
      "Warning":"SNS topic to notify when
      	Elastic Transcoder returns a warning",
      "Error":"SNS topic to notify when
         Elastic Transcoder returns an error"
   }
}
```

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

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

**pipelineId**  
Identifiant du pipeline pour lequel vous souhaitez modifier les paramètres de notification. 

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

La chaîne JSON contient les objets suivants dans le corps de la demande. 

**Id**  
Identifiant du pipeline que vous souhaitez mettre à jour.

**Notifications:Progressing**  
L'ARN de la rubrique Amazon Simple Notification Service (Amazon SNS) que vous souhaitez avertir lorsqu'Elastic Transcoder a commencé à traiter une tâche dans ce pipeline. Il s'agit de l'ARN renvoyé par Amazon SNS lorsque vous avez créé le sujet. Pour en savoir plus, consultez [Création d'une rubrique](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) dans le *Manuel du développeur d'Amazon Simple Notification Service*.  
Pour recevoir des notifications, vous devez également vous abonner à la nouvelle rubrique dans la console Amazon SNS.
Amazon SNS propose diverses options de notification, notamment la possibilité d'envoyer des messages Amazon SNS aux files d'attente Amazon Simple Queue Service. Pour de plus amples informations, consultez dans le [Guide du développeur Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/).

**Notifications : Terminées**  
L'ARN de la rubrique Amazon SNS que vous souhaitez avertir lorsqu'Elastic Transcoder a terminé le traitement d'une tâche dans ce pipeline. Il s'agit de l'ARN renvoyé par Amazon SNS lorsque vous avez créé le sujet. 

**Notifications:Warning**  
L'ARN de la rubrique Amazon SNS que vous souhaitez avertir lorsqu'Elastic Transcoder rencontre une condition d'avertissement lors du traitement d'une tâche dans ce pipeline. Il s'agit de l'ARN renvoyé par Amazon SNS lorsque vous avez créé le sujet. 

**Notifications:Error**  
L'ARN de la rubrique Amazon SNS que vous souhaitez avertir lorsqu'Elastic Transcoder rencontre une erreur lors du traitement d'une tâche dans ce pipeline. Il s'agit de l'ARN renvoyé par Amazon SNS lorsque vous avez créé le sujet. 

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

### Syntaxe
<a name="update-pipeline-notifications-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
{
   "Pipeline":{
      "Id":"ID for the new pipeline",
      "Notifications":{
         "Progressing":"SNS topic to notify when Elastic Transcoder has started to process the job",
         "Complete":"SNS topic to notify when Elastic Transcoder has finished processing the job",
         "Warning":"SNS topic to notify when Elastic Transcoder returns a warning",
         "Error":"SNS topic to notify when Elastic Transcoder returns an error"
      }
   }
}
```

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

Lorsque vous mettez à jour les notifications 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-notifications-request-body).

## Erreurs
<a name="update-pipeline-notifications-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="update-pipeline-notifications-examples"></a>

L'exemple de demande suivant met à jour les notifications pour un pipeline.

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

```
POST /2012-09-25/pipelines/1111111111111-abcde1/notifications 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
{
   "Id":"1111111111111-abcde1",
   "Notifications":{
      "Progressing":"",
      "Complete":"",
      "Warning":"",
      "Error":"arn:aws:sns:us-east-1:111222333444:ETS_Errors"
   }
}
```

### Exemple de réponse
<a name="update-pipeline-notifications-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",
   "Notifications":{
      "Progressing":"",
      "Complete":"",
      "Warning":"",
      "Error":"arn:aws:sns:us-east-1:111222333444:ETS_Errors"
   }
}
```