Notifications de statuts des tâches - Amazon Elastic Transcoder

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.

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 (Amazon SNS). Amazon SNS propose diverses options de notification, notamment la possibilité d'envoyer des messages à des points de terminaison HTTP, à des adresses e-mail et à des files d'attente Amazon Simple Queue Service (Amazon SQS). 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 des notifications pour déterminer quand des tâches se sont terminées, vous pouvez éliminer l'interrogation et vous ne recevrez pas les exceptions Limit Exceeded (code de statut HTTP 429) quelquefois engendrées par l'interrogation.

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 l'API Elastic Transcoder :

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

    Si vous souhaitez déjà utiliser des rubriques Amazon SNS, 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 la rubrique Amazon SNS applicable que vous avez créée à 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 rubriques Amazon SNS au fur et à mesure que vous créez ou mettez à jour le pipeline. Cependant, vous devez toujours utiliser la console, l'API ou la CLI Amazon SNS pour vous abonner aux nouvelles rubriques.

Lorsqu'Elastic Transcoder vous envoie une notification concernant un changement de statut, le message renvoyé dans la notification est au format JSON suivant. 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"
   }
}