Tutorial: usar o transformador de entrada para personalizar o que o EventBridge aprova para o evento de destino

É possível usar o texto de um Transformador de entrada no EventBridge para personalizar o texto de um evento antes de enviá-lo a um 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 obter 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, o 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 do 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 Topics (Tópicos).

3. Escolha Create topic.

4. Em Type (Tipo), escolha Standard (Padrão).

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

6. Escolha Create topic.

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 Protocol (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 console do Amazon EventBridge em https://console.aws.amazon.com/events/.

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

3. Escolha Create rule (Criar regra).

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

5. Em Event bus (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 default. 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 Rule type (Tipo de regra), escolha Rule with an event pattern (Regra com um padrão de evento).

7. Escolha Next (Próximo).

8. Em Event source (Origem do evento), escolha Other (Outra).

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

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

10. Escolha Next (Próximo).

11. Em Target types (Tipos de destinos), escolha AWS service (Serviço da ).

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 Next (Próximo).

16. Escolha Next (Próximo).

17. Analise os detalhes da regra e escolha Create rule (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 console do Amazon EventBridge 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 Send (Enviar).

Etapa 5: confirmar o êxito

Se receber um e-mail de notificações da AWS que corresponda à saída esperada, o tutorial terá sido concluído 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 os recursos da AWS que não estão mais sendo usados, são evitadas cobranças desnecessárias em sua conta da AWS.

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 Delete (Excluir).

4. Digite delete me.

5. Escolha Delete (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 Delete (Excluir).

4. Escolha Delete (Excluir).

Para excluir as regras do EventBridge

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

2. Selecione as regras que foram criadas.

3. Escolha Delete (Excluir).

4. Escolha Delete (Excluir).