Mettre à jour les notifications de pipeline

Description

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

Syntaxe

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

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

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.

Corps de la requête

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 dans le Manuel du développeur d'Amazon Simple Notification Service.

Important

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.

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

Syntaxe

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

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.

Corps de la réponse

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.

Erreurs

Pour plus d'informations sur les exceptions et les messages d'erreur d'Elastic Transcoder, consultez. Gestion des erreurs dans Elastic Transcoder

Exemples

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

Exemple de demande

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

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"
   }
}