Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Puede usar el [transformador de entrada](eb-transform-target-input.md) de EventBridge para personalizar el texto de un [evento](eb-events.md) antes de enviarlo al destino de una [regla](eb-rules.md). 

Para ello, debe definir varias rutas de JSON a partir del evento y asignar sus salidas a distintas variables. A continuación, puede utilizar esas variables en la plantilla de entrada. Los caracteres < y > no pueden utilizar un carácter de escape. Para obtener más información, consulte [Transformación EventBridge de entradas de Amazon](eb-transform-target-input.md)

**nota**  
Si especifica una variable que coincida con una ruta JSON que no existe en el evento, dicha variable no se crea ni aparece en la salida.

En este tutorial, creará una regla que haga coincidir un evento con `detail-type: "customerCreated"`. El transformador de entrada asigna la variable `type` a la ruta JSON \$1.detail-type desde el evento. A continuación, EventBridge coloca la variable en la plantilla de entrada “Este evento era <tipo>.” El resultado es el siguiente mensaje de Amazon SNS.

```
"This event was of customerCreated type."
```

**Topics**
+ [Paso 1: Crear un tema de Amazon SNS](#eb-input-transformer-tutorial-create-topic)
+ [Paso 2: Crear una suscripción de Amazon SNS](#eb-input-transformer-tutorial-create-sns)
+ [Paso 3: Crear una regla](#eb-input-transformer-create-rule)
+ [Paso 4: Enviar eventos de prueba](#eb-input-transformer-send-test-events)
+ [Paso 5: Confirmar el éxito](#success)
+ [Paso 6: Eliminar los recursos](#cleanup)

## Paso 1: Crear un tema de Amazon SNS
<a name="eb-input-transformer-tutorial-create-topic"></a>

Cree un tema para recibir los eventos de EventBridge.

**Creación de un tema**

1. Abra la consola de Amazon SNS en [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home).

1. En el panel de navegación, elija **Temas**.

1. Elija **Crear nuevo tema**.

1. En **Tipo**, seleccione **Estándar**.

1. Escriba **eventbridge-IT-test** como nombre del tema.

1. Seleccione **Crear tema**.

## Paso 2: Crear una suscripción de Amazon SNS
<a name="eb-input-transformer-tutorial-create-sns"></a>

Cree una suscripción para recibir correos electrónicos con la información transformada.

**Para crear una suscripción**

1. Abra la consola de Amazon SNS en [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home).

1. En el panel de navegación, seleccione **Subscriptions**.

1. Seleccione **Create subscription**.

1. En la lista **ARN de tema**, seleccione el tema que creó en el paso 1. Para este tutorial, elija **eventbridge-IT-test**.

1. En **Protocolo**, elija **Correo electrónico**.

1. Para **punto de conexión**, introduzca su dirección de correo electrónico.

1. Elija **Crear suscripción**.

1. Confirme la suscripción seleccionando **Confirmar suscripción** en el correo electrónico que reciba de las notificaciones de AWS.

## Paso 3: Crear una regla
<a name="eb-input-transformer-create-rule"></a>

Cree una regla para usar el transformador de entrada para personalizar la información del estado de la instancia que se envía a un destino.

**Para crear una regla**

1. Abra la consola de Amazon EventBridge en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. En el panel de navegación, seleccione **Reglas**.

1. Elija **Creación de regla**.

1. Escriba un nombre y una descripción para la regla. Por ejemplo, llame a la regla `ARTestRule`

1. En **Bus de eventos**, elija el bus de eventos que desea asociar a esta regla. Si desea que esta regla coincida con eventos procedentes de su cuenta, seleccione **predeterminado**. Cuando un servicio de AWS en la cuenta emite un evento, siempre va al bus de eventos predeterminado de la cuenta.

1. En **Tipo de regla**, seleccione **Regla con un patrón de eventos**.

1. Seleccione **Siguiente**.

1. En **Origen del evento**, seleccione **Otro**.

1. En **Patrón de evento**, introduzca lo siguiente:

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

1. Elija **Siguiente**.

1. En **Tipos de destino**, seleccione **Servicio de AWS**.

1. En **Seleccionar un destino**, elija **Tema de SNS** en la lista desplegable.

1. En **Tema**, seleccione el tema de Amazon SNS que creó en el paso 1. Para este tutorial, elija **eventbridge-IT-test**.

1. En **Configuración adicional**, haga lo siguiente:

   1. En **Configurar entrada de destino**, seleccione **Transformador de entrada** en la lista desplegable.

   1. Elija **Configurar transformador de entrada**

   1. En **Eventos de muestra**, introduzca lo siguiente:

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

   1. En **Transformador de entrada de destino**, haga lo siguiente:

      1. En **Ruta de entrada**, introduzca lo siguiente:

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

      1. En **Plantilla de entrada**, introduzca lo siguiente:

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

   1. Elija **Confirmar**.

1. Elija **Siguiente**.

1. Elija **Siguiente**.

1. Revise los detalles de la regla y seleccione **Creación de regla**.

## Paso 4: Enviar eventos de prueba
<a name="eb-input-transformer-send-test-events"></a>

Ahora que ha configurado el tema de SNS y la regla, enviaremos los eventos de prueba para asegurarnos de que la regla funciona correctamente.

**Para enviar eventos de prueba (consola)**

1. Abra la consola de Amazon EventBridge en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. En el panel de navegación, seleccione **Buses de eventos**.

1. En el icono del **bus de eventos predeterminado**, elija **Acciones**, **Enviar eventos**.

1. Introduzca un origen de eventos. Por ejemplo, `TestEvent`.

1. En **Detail type** (Tipo de detalle), introduzca `customerCreated`.

1. En **Detalle del evento**, introduzca `{}`.

1. Seleccione **Enviar**.

## Paso 5: Confirmar el éxito
<a name="success"></a>

Si recibe un correo electrónico de notificaciones de AWS que coincide con el resultado esperado, ha completado correctamente el tutorial.

## Paso 6: Eliminar los recursos
<a name="cleanup"></a>

A menos que desee conservar los recursos que creó para este tutorial, puede eliminarlos ahora. Si elimina los recursos de AWS que ya no utiliza, evitará gastos innecesarios en su cuenta de AWS.

**Para eliminar el tema de SNS**

1. Abra la página [Temas](https://console.aws.amazon.com/sns/v3/home#/topics) de la consola de SNS.

1. Seleccione el tema que creó.

1. Elija **Eliminar**.

1. Escriba **delete me**.

1. Elija **Eliminar**.

**Para eliminar la suscripción a SNS**

1. Abra la página [Suscripciones](https://console.aws.amazon.com/sns/v3/home#/subscriptions) en la consola de SNS.

1. Seleccione la suscripción que creó.

1. Elija **Eliminar**.

1. Elija **Eliminar**.

**Para eliminar las reglas de EventBridge**

1. Abra la página [Reglas](https://console.aws.amazon.com/events/home#/rules) en la consola de EventBridge.

1. Seleccione las reglas que creó.

1. Elija **Eliminar**.

1. Elija **Eliminar**.