

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á.

# Configurando EventBridge regras
<a name="setting-up-cloudwatch-event-rules"></a>

Para configurar EventBridge as regras da Amazon: Crie uma regra que vincule o evento AWS Elemental MediaConvert e o serviço de destino que responde à mudança de status do seu trabalho, como Amazon Simple Notification Service (Amazon SNS) ou. AWS Lambda

Para obter um tutorial sobre como configurar uma EventBridge regra com AWS Elemental MediaConvert, consulte[Tutorial: configurar notificações de e-mail para trabalhos com falha](#mediaconvert_sns_tutorial).

Para obter uma lista dos eventos MediaConvert enviados no fluxo de EventBridge eventos, consulte[Lista de MediaConvert EventBridge eventos](mediaconvert_event_list.md).

Para obter mais informações gerais sobre o uso EventBridge, consulte o [Guia EventBridge do usuário da Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/).

Para obter informações sobre solução de problemas, consulte [Solução de problemas da Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-troubleshooting.html) *no Guia EventBridge do usuário da Amazon*. 

**Topics**
+ [Tutorial: configurar notificações de e-mail para trabalhos com falha](#mediaconvert_sns_tutorial)
+ [Etapa 1: criar um tópico no Amazon SNS](#mediaconvert_sns_create_topic)
+ [Etapa 2: especificar um padrão de evento em uma EventBridge regra](#mediaconvert_sns_rule_event_source)
+ [Etapa 3: adicionar o tópico do Amazon SNS e finalizar sua regra](#add-target-and-finish-rule)
+ [Etapa 4: testar a regra](#mediaconvert_sns_test_rule)

## Tutorial: configurar notificações de e-mail para trabalhos com falha
<a name="mediaconvert_sns_tutorial"></a>

Neste tutorial, você configura uma regra de EventBridge evento que captura eventos quando o status de um trabalho muda para `ERROR` e, em seguida, notifica você sobre o evento. Para fazer isso, você primeiro cria um tópico no Amazon SNS que enviará uma notificação por e-mail sobre o trabalho com falha. Em seguida, você cria uma regra EventBridge definindo uma fonte de eventos e referenciando o tópico do Amazon SNS (o “destino”).

## Etapa 1: criar um tópico no Amazon SNS
<a name="mediaconvert_sns_create_topic"></a>

A primeira parte da configuração de uma EventBridge regra é preparar a meta da regra. Nesse caso, isso significa criar e assinar um tópico do Amazon SNS.

**Para criar um tópico do Amazon SNS**

1. [Abra o console do Amazon SNS em https://console.aws.amazon.com/sns/ v3/home.](https://console.aws.amazon.com/sns/v3/home)

1. No painel de navegação, selecione **Topics (Tópicos)** e **Create topic (Criar tópico)**.

1. Em **Tipo**, escolha **Padrão**.

1. Em **Nome**, insira **MediaConvertJobErrorAlert** e, em seguida, escolha **Criar tópico**.

1. Escolha o tópico **Nome** para o tópico que você acabou de criar para visualizar os **Detalhes do tópico**.

1. Na página de **detalhes do **MediaConvertJobErrorAlert**tópico**, na seção **Assinaturas**, escolha **Criar** assinatura. 

1. Em **Protocolo**, escolha **E-mail**. Para **Endpoint**, insira o endereço de e-mail para o qual você deseja que o Amazon SNS envie a notificação.

1. Selecione **Criar assinatura**.

1. Você receberá uma notificação por e-mail do Amazon SNS. Quando você o receber, escolha o link **Confirm subscription** no e-mail. 

## Etapa 2: especificar um padrão de evento em uma EventBridge regra
<a name="mediaconvert_sns_rule_event_source"></a>

Esta etapa mostra como especificar seu padrão de evento em uma EventBridge regra. Essa regra capturará eventos enviados MediaConvert quando o status de um trabalho for alterado para`ERROR`. 

**Para configurar um padrão de evento em uma EventBridge regra**

1. Abra o EventBridge console da Amazon em [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. No painel de navegação, escolha **Regras**. Mantenha o **Barramento de eventos** **padrão** e escolha **Criar regra**.

1. Em **Nome**, digite **MediaConvertJobStateError** e escolha **Próximo**.

1. Na seção **Padrão de evento**, começando com **Origem do evento**, escolha as seguintes configurações:
   + **Origem do evento**: **AWS services**
   + **AWS serviço**: **MediaConvert**
   + **Tipo de evento**: **MediaConvert Job State Change**
   + **Tipo de evento, estados específicos**: **ERROR**

1. A caixa de **Padrão de evento** será como o exemplo a seguir. 

   ```
   {
     "source": ["aws.mediaconvert"],
     "detail-type": ["MediaConvert Job State Change"],
     "detail": {
       "status": ["ERROR"]
     }
   }
   ```

   Esse código define uma regra de EventBridge evento que corresponde a qualquer evento em que o status do trabalho seja alterado`ERROR`. Para obter mais informações sobre padrões de eventos, consulte [Eventos e padrões de eventos](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/CloudWatchEventsandEventPatterns.html) no *Guia CloudWatch do usuário da Amazon*.

1. Escolha **Próximo**.

## Etapa 3: adicionar o tópico do Amazon SNS e finalizar sua regra
<a name="add-target-and-finish-rule"></a>

Adicione o tópico do Amazon SNS que você criou na etapa 1 à EventBridge regra que você iniciou na etapa 2.

**Para adicionar o tópico do Amazon SNS e concluir a regra EventBridge**

1. Na seção **Selecionar destinos**, em **Selecionar um destino**, escolha o **Tópico do SNS**.

1. Em **Tópico**, escolha **MediaConvertJobErrorAlert**.

1. Escolha **Próximo**.

1. Opcionalmente, adicione tags. Escolha **Próximo**.

1. Examine suas configurações. Em seguida, escolha **Create rule** (Criar regra). 

## Etapa 4: testar a regra
<a name="mediaconvert_sns_test_rule"></a>

Para testar sua regra, envie um trabalho que você sabe que causará um erro. Por exemplo, especifique um local de entrada que não existe. Se você tiver configurado sua regra de evento corretamente, deverá receber um e-mail com a mensagem de texto do evento dentro de alguns minutos. 

**Para testar a regra**

1. Abra o AWS Elemental MediaConvert console em [https://console.aws.amazon.com/mediaconvert](https://console.aws.amazon.com/mediaconvert).

1. Envie um novo MediaConvert emprego. Para obter mais informações, consulte [Tutorial: Definindo as configurações do trabalho](setting-up-a-job.md).

1. Verifique a conta de e-mail que você especificou quando configurou seu tópico do Amazon SNS. Confirme se recebeu uma notificação por e-mail para o erro de trabalho.