Mettre à jour les notifications de pipeline - Amazon Elastic Transcoder

Réduisez les coûts et bénéficiez de davantage de fonctionnalités avec AWS Elemental MediaConvert

MediaConvert est un nouveau service de transcodage vidéo basé sur des fichiers qui fournit une suite complète de fonctionnalités de transcodage avancées, avec des tarifs à la demande à partir de 0,0075 $/minute. En savoir plus

Vous utilisez déjà Amazon Elastic Transcoder ? La migration vers cette solution est simple MediaConvert. Pour plus d'informations, consultez cette présentation qui inclut des informations précieuses sur le processus de migration et des liens vers des ressources supplémentaires.

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

Description

Pour mettre à jour uniquement les notifications Amazon Simple Notification Service (Amazon SNS) pour un pipeline, envoyez une demande POST à l'/2012-09-25/pipelines/pipelineId/notificationsressource.

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 commencé à traiter sont affectées en plus des tâches que vous soumettez après avoir modifié les notifications.

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 demande

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

La rubrique ARN de la rubrique Amazon Simple Notification Service (Amazon SNS) que vous souhaitez avertir quand Elastic Transcoder a commencé à traiter une tâche dans ce pipeline. Il s'agit de l'ARN qu'Amazon SNS a renvoyé lors de la création de la rubrique. 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 offre diverses options de notification, notamment la possibilité d'envoyer des messages Amazon SNS à des files d'attente Amazon Simple Queue Service. Pour de plus amples informations, veuillez consulter dans le Guide du développeur Amazon Simple Notification Service.

Notifications:Completed

La rubrique ARN de la rubrique Amazon SNS que vous souhaitez avertir quand Elastic Transcoder a terminé de traiter une tâche dans ce pipeline. Il s'agit de l'ARN qu'Amazon SNS a renvoyé lors de la création de la rubrique.

Notifications:Warning

La rubrique ARN de la rubrique Amazon SNS que vous souhaitez notifier lorsque Elastic Transcoder rencontre une condition d'avertissement lors du traitement d'une tâche dans ce pipeline. Il s'agit de l'ARN qu'Amazon SNS a renvoyé lors de la création de la rubrique.

Notifications:Error

La rubrique ARN de la rubrique Amazon SNS que vous souhaitez notifier lorsque Elastic Transcoder rencontre une condition d'erreur lors du traitement d'une tâche dans ce pipeline. Il s'agit de l'ARN qu'Amazon SNS a renvoyé lors de la création de la rubrique.

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 des notifications pour un pipeline, Elastic Transcoder renvoie les valeurs que vous avez spécifiées dans la demande. Pour plus d'informations, consultez Corps de la demande.

Erreurs

Pour plus d'informations sur les exceptions et les messages d'erreur Elastic Transcoder, consultezGestion 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" } }