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

# Tutorial: usar transformadores de entrada para transformar eventos no EventBridge
<a name="eb-input-transformer-tutorial"></a>

É possível usar o texto de um [Transformador de entrada](eb-transform-target-input.md) no EventBridge para personalizar o texto de um [evento](eb-events.md) antes de enviá-lo a um destino de uma [regra](eb-rules.md). 

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](eb-transform-target-input.md)

**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 com`detail-type: "customerCreated"`. O transformador de entrada mapeia a variável `type` para o caminho JSON do tipo \$1.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."
```

**Topics**
+ [Etapa 1: criar um tópico do Amazon SNS](#eb-input-transformer-tutorial-create-topic)
+ [Etapa 2: criar uma assinatura do Amazon SNS](#eb-input-transformer-tutorial-create-sns)
+ [Etapa 3: criar uma regra](#eb-input-transformer-create-rule)
+ [Etapa 4: enviar eventos de teste](#eb-input-transformer-send-test-events)
+ [Etapa 5: confirmar o êxito](#success)
+ [Etapa 6: limpar os recursos](#cleanup)

## Etapa 1: criar um tópico do Amazon SNS
<a name="eb-input-transformer-tutorial-create-topic"></a>

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](https://console.aws.amazon.com/sns/v3/home).

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

1. Escolha **Criar tópico**.

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

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

1. Escolha **Criar tópico**.

## Etapa 2: criar uma assinatura do Amazon SNS
<a name="eb-input-transformer-tutorial-create-sns"></a>

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](https://console.aws.amazon.com/sns/v3/home).

1. No painel de navegação, escolha **Assinaturas**.

1. Selecione **Create subscription**.

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

1. Em **Protocolo**, escolha **Email**.

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

1. Selecione **Criar assinatura**.

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

## Etapa 3: criar uma regra
<a name="eb-input-transformer-create-rule"></a>

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.

**Como criar uma regra**

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

1. No painel de navegação, escolha **Regras**.

1. Escolha **Create rule**.

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

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

1. Em **Rule type**, escolha **Rule with an event pattern**.

1. Escolha **Próximo**.

1. Em **Fonte do evento**, escolha **Outra**.

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

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

1. Escolha **Próximo**.

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

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

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

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

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

   1. Escolha **Configurar transformador de entrada**

   1. em **Eventos de amostra**, insira o seguinte:

      ```
      {
        "detail-type": "customerCreated"
      }
      ```

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

      1. Em **Caminho de entrada**, insira o seguinte:

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

      1. Em **Modelo de entrada**, insira o seguinte:

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

   1. Escolha **Confirmar**.

1. Escolha **Próximo**.

1. Escolha **Próximo**.

1. Analise os detalhes da regra e selecione **Criar regra**.

## Etapa 4: enviar eventos de teste
<a name="eb-input-transformer-send-test-events"></a>

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/](https://console.aws.amazon.com/events/).

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

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

1. Insira a origem de eventos. Por exemplo, `TestEvent`.

1. Em **Tipo de detalhe**, insira `customerCreated`.

1. Em **Detalhes do evento**, insira `{}`.

1. Selecione **Enviar**.

## Etapa 5: confirmar o êxito
<a name="success"></a>

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
<a name="cleanup"></a>

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](https://console.aws.amazon.com/sns/v3/home#/topics) do console do SNS.

1. Selecione o tópico que foi criado.

1. Escolha **Excluir**.

1. Insira **delete me**.

1. Escolha **Excluir**.

**Para excluir a assinatura do SNS**

1. Abra a página de [Assinaturas](https://console.aws.amazon.com/sns/v3/home#/subscriptions) no console do Amazon SNS.

1. Selecione a assinatura que foi criada.

1. Escolha **Excluir**.

1. Escolha **Excluir**.

**Para excluir as regras do EventBridge**

1. Abra a página [Regras](https://console.aws.amazon.com/events/home#/rules) no console do EventBridge.

1. Selecione as regras que foram criadas.

1. Escolha **Excluir**.

1. Escolha **Excluir**.