Aviso de fim do suporte: em 13 de novembro de 2025, o suporte para o Amazon Elastic Transcoder AWS será interrompido. Depois de 13 de novembro de 2025, você não poderá mais acessar o console do Elastic Transcoder ou os recursos do Elastic Transcoder.

Para obter mais informações sobre a transição para AWS Elemental MediaConvert, visite esta [postagem do blog](https://aws.amazon.com/blogs/media/how-to-migrate-workflows-from-amazon-elastic-transcoder-to-aws-elemental-mediaconvert/).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Notificações de status de trabalho
<a name="notifications"></a>

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 utilizando o Amazon Simple Notification Service (Amazon SNS). O Amazon SNS oferece várias opções de notificação, inclusive a capacidade de enviar mensagens para endpoints HTTP, endereços de e-mail e filas do Amazon Simple Queue Service (SQS). Para obter mais informações sobre essas e outras opções, consulte o [Guia do desenvolvedor do Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/). 

As notificações são úteis para desenvolver aplicações orientadas por eventos. Usando notificações para determinar quando os trabalhos são concluídos, você pode eliminar sondagens e não encontra exceções de `Limit Exceeded` (código de status HTTP 429) que, às vezes, resultam de sondagens. 

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 de alterações no status de trabalhos quando estiver usando a API do Elastic Transcoder:

1. Crie um ou mais tópicos do Amazon SNS e se inscreva em cada tópico. Para obter mais informações, consulte a [documentação do Amazon Simple Notification Service](https://aws.amazon.com/documentation/sns/).

   Se você já tem tópicos do Amazon SNS que deseja usar, pule esta etapa.

1. Crie um pipeline ou atualize um existente. Para cada alteração no status sobre a qual você deseja se notificado (Em andamento, Concluído, Aviso, Erro), especifique o tópico do Amazon SNS aplicável criado na Etapa 1. Para obter mais informações, consulte [Criar pipeline](create-pipeline.md), [Atualizar pipeline](update-pipeline.md) ou [Atualizar notificações de pipeline](update-pipeline-notifications.md).

1. 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 usar o console, poderá criar tópicos do Amazon SNS à medida que criar ou atualizar o pipeline. No entanto, você ainda precisará usar o console do Amazon SNS, a API ou a CLI para assinar os novos tópicos.

Quando o Elastic Transcoder envia uma notificação de 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"
   }
}
```