Notificações de status de trabalho

O Elastic Transcoder pode notificá-lo quando o status de um trabalho muda. Você pode configurar o Elastic Transcoder para enviar notificações para qualquer combinação (ou nenhuma) das seguintes alterações no status:

• Em andamento: o Elastic Transcoder começou a processar um trabalho no pipeline.

• Concluído: o Elastic Transcoder finalizou o processamento de um trabalho no pipeline.

• Aviso: o Elastic Transcoder encontrou uma condição de aviso ao processar um trabalho no pipeline.

• Erro: o Elastic Transcoder encontrou uma condição de erro ao processar um trabalho no pipeline.

O Elastic Transcoder envia notificações usando o Amazon Simple Notification Service (Amazon). SNS SNSA Amazon oferece uma variedade de opções de notificação, incluindo a capacidade de enviar mensagens para HTTP endpoints, endereços de e-mail e filas do Amazon Simple Queue Service SQS (Amazon). Para obter mais informações sobre essas e outras opções, consulte o Guia do desenvolvedor do Amazon Simple Notification Service.

As notificações são úteis para desenvolver aplicações orientadas por eventos. Se você usar notificações para determinar quando os trabalhos foram concluídos, poderá eliminar a pesquisa e não encontrará as Limit Exceeded exceções (código de HTTP status 429) que às vezes resultam da pesquisa.

Configure notificações quando criar ou atualizar um pipeline. Para cada trabalho que você envia para o pipeline, o Elastic Transcoder envia as notificações associadas.

Importante

Quando você altera notificações, as alterações entram em vigor imediatamente. Os trabalhos já enviados que o Elastic Transcoder não começou a processar são afetados, além daqueles que você enviar depois de alterar as notificações.

Para configurar o Elastic Transcoder para notificá-lo sobre mudanças no status do trabalho quando você estiver usando o Elastic Transcoder: API

1. Crie um ou mais SNS tópicos da Amazon e assine cada tópico. Para obter mais informações, consulte a documentação do Amazon Simple Notification Service.

   Se você já tem SNS tópicos da Amazon que deseja usar, pode pular esta etapa.

2. Crie um pipeline ou atualize um existente. Para cada alteração no status para a qual você deseja uma notificação (Progressiva, Concluída, Advertência, Erro), especifique o SNS tópico aplicável da Amazon que você criou na Etapa 1. Para obter mais informações, consulte Criar pipeline, Atualizar pipeline ou Atualizar notificações de pipeline.

3. Teste notificações dos status Progressing e Complete enviando um trabalho para o Elastic Transcoder.

Também é possível usar o console do Elastic Transcoder para configurar notificações. Se você usa o console, pode criar SNS tópicos da Amazon ao criar ou atualizar o pipeline. No entanto, você ainda precisa usar o SNS console da Amazon ou CLI se inscrever nos novos tópicos. API

Quando o Elastic Transcoder envia uma notificação sobre uma alteração no status, a mensagem retornada na notificação está no seguinte formato. JSON Observe que a mensagem inclui o status de cada saída, bem como o estado do trabalho:

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