Notificaciones de estado de la tarea

Elastic Transcoder puede notificarle cuando cambie el estado de una tarea. Puede configurar Elastic Transcoder para recibir notificaciones de cualquier combinación (o ninguna) de los siguientes cambios en el estado:

• En proceso: Elastic Transcoder ha comenzado a procesar una tarea en la canalización.

• Completa: Elastic Transcoder ha terminado de procesar una tarea en la canalización.

• Advertencia: Elastic Transcoder encontró una condición de advertencia durante el procesamiento de una tarea en la canalización.

• Error: Elastic Transcoder encontró una condición de error durante el procesamiento de una tarea en la canalización.

Elastic Transcoder envía las notificaciones mediante Amazon Simple Notification Service (Amazon). SNS Amazon SNS ofrece una variedad de opciones de notificación, incluida la posibilidad de enviar mensajes a HTTP puntos finales, direcciones de correo electrónico y colas de Amazon Simple Queue Service SQS (Amazon). Para obtener más información acerca de estas y otras opciones, consulte la Guía para desarrolladores de Amazon Simple Notification Service.

Las notificaciones son útiles para diseñar aplicaciones basadas en eventos. Si utilizas las notificaciones para determinar cuándo se han completado los trabajos, puedes eliminar las votaciones y no encontrarás las Limit Exceeded excepciones (código de HTTP estado 429) que a veces resultan de las votaciones.

Puede configurar notificaciones al crear o actualizar una canalización. Para cada tarea que envíe a la canalización, Elastic Transcoder enviará las notificaciones asociadas.

importante

Cuando realiza cambios en las notificaciones, estos surten efecto inmediatamente. Las tareas que ya ha enviado y que Elastic Transcoder no ha comenzado a procesar se ven afectadas además de las tareas que envíe después de cambiar las notificaciones.

Para configurar Elastic Transcoder para que le notifique los cambios en el estado del trabajo cuando utilice el Elastic Transcoder: API

1. Crea uno o más SNS temas de Amazon y suscríbete a cada tema. Para obtener más información, consulte Documentación de Amazon Simple Notification Service.

   Si ya tienes SNS temas de Amazon que quieras usar, puedes saltarte este paso.

2. Cree una canalización o actualice una existente. Para cada cambio de estado para el que desees recibir una notificación (en curso, completo, advertencia o error), especifica el SNS tema de Amazon correspondiente que creaste en el paso 1. Para obtener más información, consulte Crear canalización, Actualizar canalización, o Actualizar notificaciones de la canalización.

3. Pruebe las notificaciones para los estados Progressing y Complete enviando una tarea a Elastic Transcoder.

También puede utilizar la consola de Elastic Transcoder para configurar las notificaciones. Si utilizas la consola, puedes crear SNS temas de Amazon a medida que creas o actualizas la canalización. Sin embargo, aún necesitas usar la SNS consola de Amazon o suscribirte CLI a los nuevos temas. API

Cuando Elastic Transcoder le envía una notificación de un cambio de estado, el mensaje devuelto en la notificación tiene el siguiente formato. JSON Tenga en cuenta que en el mensaje se incluye el estado de cada salida, así como un estado de la tarea:

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