Tutorial: Use transformadores de entrada para transformar eventos em EventBridge

Você pode usar o transformador de entrada EventBridge para personalizar o texto de um evento antes de enviá-lo ao destino de uma regra.

Para fazer isso, defina vários caminhos JSON do evento e atribua as saídas para variáveis diferentes. Em seguida, use essas variáveis no modelo de entrada. Não é possível efetuar o escape dos caracteres < e >. Para ter mais informações, consulte Transformação EventBridge de insumos da Amazon

nota

Se você especificar uma variável para corresponder a um caminho JSON que não existe no evento, essa variável não será criada e não aparecerá na saída.

Neste tutorial, é criada uma regra que combina um evento comdetail-type: "customerCreated". O transformador de entrada mapeia a variável type para o caminho JSON do tipo $.detail-type a partir do evento. Em seguida, EventBridge coloca a variável no modelo de entrada “Este evento foi<type>”. O resultado é a seguinte mensagem do Amazon SNS.

"This event was of customerCreated type."

Etapa 1: criar um tópico do Amazon SNS

Crie um tópico para receber os eventos EventBridge.

Para criar um tópico

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

2. No painel de navegação, escolha Tópicos.

3. Escolha Criar tópico.

4. Em Tipo, escolha Padrão.

5. Insira eventbridge-IT-test como o nome do tópico.

6. Escolha Criar tópico.

Etapa 2: criar uma assinatura do Amazon SNS

Criar uma assinatura para receber e-mails com as informações transformadas.

Criar uma assinatura

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

2. No painel de navegação, escolha Subscriptions.

3. Selecione Create subscription.

4. Em ARN do tópico, escolha o tópico criado na etapa 1. Para este tutorial, escolha eventbridge-IT-test.

5. Em Protocolo, escolha Email.

6. Para Endpoint, insira seu endereço de e-mail.

7. Selecione Create subscription.

8. Confirme a assinatura escolhendo Confirmar assinatura no e-mail que você recebe das notificações AWS .

Etapa 3: criar uma regra

Crie uma regra para usar o transformador de entrada para personalizar as informações do estado da instância que vão para um destino.

Para criar uma regra do

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

2. No painel de navegação, escolha Regras.

3. Escolha Create rule.

4. Insira um nome e uma descrição para a regra. Por exemplo, nomeie a regra como ARTestRule

5. Em Barramento de Eventos, escolha o barramento de eventos que você deseja associar a essa regra. Se quiser que essa regra faça a correspondência com eventos provenientes da sua conta, selecione padrão. Quando um serviço da AWS em sua conta emite um evento, ele sempre vai para o barramento de eventos padrão da sua conta.

6. Em Tipo de Regra, escolha Regra com Padrão de Evento.

7. Escolha Próximo.

8. Em Fonte do evento, escolha Outra.

9. Em Padrão de evento, insira um do seguintes:

   {
     "detail-type": [
       "customerCreated"
     ]
   }

10. Escolha Next (Avançar).

11. Em Tipos de destino, escolha Serviço da AWS .

12. Em Selecionar um destino, escolha o tópico do SNS na lista suspensa.

13. Em Tópico escolha o nome do tópico do Amazon SNS criado na etapa 1. Para este tutorial, escolha eventbridge-IT-test.

14. Para Configurações de atualização, faça o seguinte:

    1. Em Configurar entrada de destino, escolha Transformador de entrada na lista suspensa.

    2. Escolha Configurar transformador de entrada

    3. em Eventos de amostra, insira o seguinte:

       {
         "detail-type": "customerCreated"
       }

    4. Para o Transformador de entrada de destino, faça o seguinte:

       1. Em Caminho de entrada, insira o seguinte:

          {"detail-type":"$.detail-type"}

       2. Em Modelo de entrada, insira o seguinte:

          "This event was of <detail-type> type."

    5. Escolha Confirmar.

15. Escolha Próximo.

16. Escolha Próximo.

17. Analise os detalhes da regra e selecione Criar regra.

Etapa 4: enviar eventos de teste

Agora que o tópico e a regra do SNS foram configurados, serão enviados eventos de teste para garantir que a regra esteja funcionando corretamente.

Para enviar eventos de teste (console)

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

2. No painel de navegação, selecione Event buses (Barramentos de eventos).

3. No quadro Barramento de eventos padrão, escolha Ações, Enviar eventos.

4. Insira a origem de eventos. Por exemplo, TestEvent.

5. Em Tipo de detalhe, insira customerCreated.

6. Em Detalhes do evento, insira {}.

7. Selecione Enviar.

Etapa 5: confirmar o êxito

Se você receber um e-mail de AWS notificações que corresponda à saída esperada, você concluiu o tutorial com êxito.

Etapa 6: limpar os recursos

Agora você pode excluir os recursos criados para este tutorial, a menos que queira mantê-los. Ao excluir AWS recursos que você não está mais usando, você evita cobranças desnecessárias em sua AWS conta.

Para excluir o tópico do SNS

1. Abra a página Tópicos do console do SNS.

2. Selecione o tópico que foi criado.

3. Escolha Excluir.

4. Digite delete me.

5. Escolha Excluir.

Para excluir a assinatura do SNS

1. Abra a página de Assinaturas no console do Amazon SNS.

2. Selecione a assinatura que foi criada.

3. Escolha Excluir.

4. Escolha Excluir.

Para excluir a (s) EventBridge regra (s)

1. Abra a página Regras do EventBridge console.

2. Selecione as regras que foram criadas.

3. Escolha Excluir.

4. Escolha Excluir.