Tutorial: Uso de transformadores de entrada para transformar eventos en EventBridge - Amazon EventBridge
Paso 1: Crear un tema de Amazon SNSPaso 2: Crear una suscripción de Amazon SNSPaso 3: Crear una reglaPaso 4: Enviar eventos de pruebaPaso 5: Confirmar el éxitoPaso 6: Eliminar los recursos

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

Puede usar el transformador de entrada de EventBridge para personalizar el texto de un evento antes de enviarlo al destino de una regla.

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

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 $.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."

Paso 1: Crear un tema de Amazon SNS

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.

  2. En el panel de navegación, elija Temas.

  3. Elija Crear nuevo tema.

  4. En Tipo, seleccione Estándar.

  5. Escriba eventbridge-IT-test como nombre del tema.

  6. Elija Crear nuevo tema.

Paso 2: Crear una suscripción de Amazon SNS

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.

  2. En el panel de navegación, seleccione Subscriptions.

  3. Seleccione Create subscription.

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

  5. En Protocolo, elija Correo electrónico.

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

  7. Seleccione Crear una suscripción.

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

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

  2. En el panel de navegación, seleccione Reglas.

  3. Elija Crear regla.

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

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

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

  7. Seleccione Siguiente.

  8. En Origen del evento, seleccione Otro.

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

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

  10. Elija Siguiente.

  11. En Tipos de destino, seleccione Servicio de AWS.

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

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

  14. En Configuración adicional, haga lo siguiente:

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

    2. Elija Configurar transformador de entrada

    3. En Eventos de muestra, introduzca lo siguiente:

      {
  "detail-type": "customerCreated"
}

    4. En Transformador de entrada de destino, haga lo siguiente:

      1. En Ruta de entrada, introduzca lo siguiente:

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

      2. En Plantilla de entrada, introduzca lo siguiente:

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

    5. Elija Confirmar.

  15. Elija Siguiente.

  16. Elija Siguiente.

  17. Revise los detalles de la regla y seleccione Crear regla.

Paso 4: Enviar eventos de prueba

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

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

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

  4. Introduzca un origen de eventos. Por ejemplo, TestEvent.

  5. En Detail type (Tipo de detalle), introduzca customerCreated.

  6. En Detalle del evento, introduzca {}.

  7. Seleccione Enviar.

Paso 5: Confirmar el éxito

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 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 de la consola de SNS.

  2. Seleccione el tema que creó.

  3. Elija Eliminar.

  4. Escriba delete me.

  5. Elija Eliminar.

Para eliminar la suscripción a SNS

  1. Abra la página Suscripciones en la consola de SNS.

  2. Seleccione la suscripción que creó.

  3. Elija Eliminar.

  4. Elija Eliminar.

Para eliminar las reglas de EventBridge

  1. Abra la página Reglas en la consola de EventBridge.

  2. Seleccione las reglas que creó.

  3. Elija Eliminar.

  4. Elija Eliminar.