Notifications de statuts des tâches - 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.

Notifications de statuts des tâches

Elastic Transcoder peut vous avertir lorsque le statut d'une tâche change. Vous pouvez configurer Elastic Transcoder pour qu'il vous envoie des notifications pour toute combinaison (ou aucune) des modifications de statut suivantes :

  • Progression : Elastic Transcoder a commencé à traiter une tâche en cours de préparation.

  • Terminé : Elastic Transcoder a terminé le traitement d'une tâche dans le pipeline.

  • Avertissement : Elastic Transcoder a rencontré un avertissement lors du traitement d'une tâche dans le pipeline.

  • Erreur : Elastic Transcoder a rencontré une erreur lors du traitement d'une tâche dans le pipeline.

Elastic Transcoder envoie des notifications à l'aide d'Amazon Simple Notification Service (AmazonSNS). Amazon SNS propose diverses options de notification, notamment la possibilité d'envoyer des messages aux HTTP points de terminaison, aux adresses e-mail et aux files d'attente Amazon Simple Queue Service (AmazonSQS). Pour plus d'informations sur ces options et sur d'autres, consultez le guide du développeur Amazon Simple Notification Service.

Les notifications sont utiles pour la conception d'applications déclenchées par des événements. Si vous utilisez les notifications pour déterminer quand les tâches sont terminées, vous pouvez supprimer le sondage et vous ne rencontrerez pas les Limit Exceeded exceptions (code de HTTP statut 429) qui résultent parfois du sondage.

Vous configurez les notifications lorsque vous créez ou mettez à jour un pipeline. Pour chaque tâche que vous soumettez à ce pipeline, Elastic Transcoder envoie les notifications associées.

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.

Pour configurer Elastic Transcoder afin qu'il vous informe des modifications du statut de la tâche lorsque vous utilisez Elastic Transcoder : API

  1. Créez un ou plusieurs SNS sujets Amazon et abonnez-vous à chaque sujet. Pour plus d'informations, consultez la documentation Amazon Simple Notification Service.

    Si vous avez déjà SNS des rubriques Amazon que vous souhaitez utiliser, vous pouvez ignorer cette étape.

  2. Créez un pipeline ou mettez à jour un pipeline existant. Pour chaque changement de statut pour lequel vous souhaitez recevoir une notification (en cours, terminé, avertissement, erreur), spécifiez le SNS sujet Amazon applicable que vous avez créé à l'étape 1. Pour plus d'informations, veuillez consulter Créer un pipeline, Mettre à jour un pipeline ou Mettre à jour les notifications de pipeline.

  3. Testez les notifications Progressing et les Complete statuts en soumettant une tâche à Elastic Transcoder.

Vous pouvez également utiliser la console Elastic Transcoder pour configurer les notifications. Si vous utilisez la console, vous pouvez créer des SNS sujets Amazon au fur et à mesure que vous créez ou mettez à jour le pipeline. Cependant, vous devez toujours utiliser la SNS console Amazon ou vous abonner CLI aux nouveaux sujets. API

Lorsqu'Elastic Transcoder vous envoie une notification concernant un changement de statut, le message renvoyé dans la notification est au format suivantJSON. Notez que le message comprend le statut de chaque sortie ainsi qu'un état pour la tâche :

{
   "state" : "PROGRESSING|COMPLETED|WARNING|ERROR",
   "errorCode" : "the code of any error that occurred",
   "messageDetails" : "the notification message you created in Amazon SNS",
   "version" : "API version that you used to create the job",
   "jobId" : "value of Job:Id object that Elastic Transcoder 
             returns in the response to a Create Job request",
   "pipelineId" : "value of PipelineId object 
                  in the Create Job request",
   "input" : {
      job Input settings
   },
   "outputKeyPrefix" : "prefix for file names in Amazon S3 bucket",
   "outputs": [
      {
         applicable job Outputs settings,
         "status" : "Progressing|Complete|Warning|Error"
      },
      {...}
   ],
   "playlists": [
      {
         applicable job playlists settings
      }
   ],
   "userMetadata": {
      "metadata key": "metadata value"
   }
}