Tutorial: Utilice transformadores de entrada para transformar eventos en EventBridge - Amazon EventBridge

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: Utilice transformadores de entrada para transformar eventos en EventBridge

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

Para ello, defina las JSON rutas a partir del evento y asigne sus salidas a diferentes 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 especificas una variable para que coincida con una JSON ruta que no existe en el evento, esa 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 type variable a la JSON ruta $.detail-type del evento. <type>A continuación, EventBridge coloca la variable en la plantilla de entrada «Este evento fue». El resultado es el siguiente SNS mensaje de Amazon.

"This event was of customerCreated type."

Paso 1: Crea un SNS tema de Amazon

Crea un tema para recibir los eventos EventBridge.

Creación de un tema
  1. Abre la SNS consola de Amazon en la https://console.aws.amazon.com/sns/versión 3/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: Crea una SNS suscripción a Amazon

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

Para crear una suscripción
  1. Abre la SNS consola de Amazon en la https://console.aws.amazon.com/sns/versión 3/home.

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

  3. Seleccione Create subscription.

  4. ARNEn Tema, elige el tema que creaste 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. Elija 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. Abre la EventBridge consola de Amazon 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. Seleccione Siguiente.

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

  12. En Selecciona un objetivo, elige un SNStema de la lista desplegable.

  13. En Tema, selecciona el SNS tema de Amazon que creaste 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. Seleccione Siguiente.

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

Paso 4: Enviar eventos de prueba

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

Para enviar eventos de prueba (consola)
  1. Abre la EventBridge consola de Amazon 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 recibes un correo electrónico de AWS notificaciones que coincide con el resultado esperado, has completado correctamente el tutorial.

Paso 6: Eliminar los recursos

A menos que desee conservar los recursos que creó para este tutorial, puede eliminarlos ahora. Al eliminar AWS los recursos que ya no utilizas, evitas cargos innecesarios en tu AWS cuenta.

Para eliminar el SNS tema
  1. Abra la página de temas de la SNS consola.

  2. Seleccione el tema que creó.

  3. Elija Eliminar.

  4. Escriba delete me.

  5. Elija Eliminar.

Para eliminar la SNS suscripción
  1. Abre la página de suscripciones de la SNS consola.

  2. Seleccione la suscripción que creó.

  3. Elija Eliminar.

  4. Elija Eliminar.

Para eliminar la (s) EventBridge regla (s)
  1. Abre la página de reglas de la EventBridge consola.

  2. Seleccione las reglas que creó.

  3. Elija Eliminar.

  4. Elija Eliminar.