Crear reglas en Amazon 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.

Crear reglas en Amazon EventBridge

Requisitos previos

Antes de comenzar, asegúrese de que dispone de lo siguiente:

  • Acceso a la EventBridge consola de Amazon

  • Permisos de IAM adecuados para crear reglas EventBridge

  • Comprensión básica de las arquitecturas basadas en eventos

Descripción general de

Para tomar medidas en función de los eventos que reciba EventBridge, puede crear reglas. Cuando un evento coincide con el patrón de eventos definido en la regla, EventBridge envía el evento al destino especificado.

En este tema se explica cómo crear una regla que se EventBridge utilice para hacer coincidir los eventos a medida que se envían al bus de eventos especificado.

La creación de EventBridge reglas consta de cuatro pasos principales:

  1. Elija los eventos que desee procesar

  2. Configure el filtrado y las pruebas de eventos

  3. Seleccione y configure los objetivos

  4. Configure los ajustes de la regla

Elija los eventos

Primero, elige los eventos que quieres enviar al objetivo.

Para seleccionar un evento
  1. Abre la EventBridge consola de Amazon en https://console.aws.amazon.com/events/.

  2. En el panel de navegación, selecciona Reglas y, a continuación, selecciona Crear regla.

  3. En la pestaña Eventos, busca los eventos que deseas enviar al destino:

    1. Elige Eventos AWS de servicio o Eventos personalizados.

    2. Usa el cuadro de búsqueda o navega por la lista de eventos para encontrar los eventos que deseas enviar al objetivo.

    3. Arrastra uno o más eventos al lienzo de creación y suéltalos en Triggering Events.

    EventBridge muestra la sección Eventos desencadenantes. Esta sección incluye:

    • Eventos, en la que se muestra el evento que ha elegido.

    • Esquema, que muestra el esquema del evento seleccionado, si está disponible.

      El esquema contiene tres pestañas:

      • Árbol: una vista en árbol del esquema de eventos.

      • Código: el esquema de eventos en formato JSON o con especificaciones de API abierta.

      • Información: información general sobre el esquema.

    • Ejemplo de evento, que muestra un ejemplo de un evento seleccionado, si está disponible.

    • Patrón de eventos (filtro), que contiene un patrón de eventos que selecciona todos los eventos que haya elegido.

Filtra los eventos para enviar solo lo que desees

Probablemente no quieras enviar todos los eventos de un tipo específico a un objetivo. Puedes hacer que tu patrón de eventos sea más específico para que solo seleccione los eventos que contienen los atributos y valores que te interesan.

Edita el patrón del evento (opcional)

En el panel Activar eventos, puede crear el patrón de eventos de dos maneras:

  • Visualmente, mediante la vista en árbol del esquema

  • Editando directamente el JSON en el panel de patrones de eventos

Para editar el patrón de eventos mediante la vista de árbol del esquema
  1. Seleccione la pestaña Árbol del panel Esquema.

  2. Añada y edite filtros para crear el patrón de eventos.

    1. Elija el icono de filtro situado junto al atributo que desee añadir como filtro al patrón de eventos.

    2. Elija un operador de comparación de la lista desplegable.

      Para obtener más información sobre los operadores de comparación, consulte Creación de patrones de eventos.

    3. Introduzca el valor que desee que coincida.

    4. Haga clic en la marca de verificación para terminar.

    EventBridge añade el filtro que ha creado al JSON en el panel de patrones de eventos.

  3. Añada filtros adicionales hasta que haya creado un patrón de eventos que coincida con todos los atributos de eventos que desee.

Prueba el patrón de eventos

Tras crear un patrón de eventos que coincida con todos los atributos de eventos que desee, compruebe que el patrón de eventos funciona según lo esperado.

Pruebe el patrón de eventos (opcional)

  1. Elige un ejemplo de evento para probarlo o usa el tuyo propio.

    • Utilice los ejemplos de eventos proporcionados

      1. Elija Usar los eventos de muestra proporcionados.

      2. En Ejemplo de evento desencadenante, seleccione el evento que desee utilizar para las pruebas en la lista desplegable.

    • Usa tu propio evento

      1. Elige Usa tu propio evento.

        EventBridge muestra un evento genérico con un details elemento vacío.

      2. Edita el JSON del evento para crear el evento con el que quieres probar tu patrón de eventos.

        sugerencia

        Puedes usar los eventos de muestra proporcionados como puntos de partida para crear tus propios eventos personalizados y usarlos en tus pruebas:

        1. Selecciona Usar los eventos de muestra proporcionados, elige un evento del ejemplo del evento desencadenante y, a continuación, selecciona Copiar.

        2. Elige Usa tu propio evento.

        3. Selecciona el evento completo en la ventana y pega el evento de muestra sobre él.

        4. Edite el evento como desee.

  2. Seleccione Ejecutar prueba.

    EventBridge muestra un mensaje que indica si el evento de prueba coincide con el patrón de eventos.

Seleccionar los destinos

Arrastra uno (y hasta cinco) objetivos al lienzo de construcción y suéltalo sobre los objetivos para recibir los eventos que coincidan con el patrón de eventos especificado. Los objetivos pueden incluir:

  • Otros autobuses de EventBridge eventos, en el mismo autobús o en uno diferente Cuenta de AWS

  • EventBridge Destinos de API, incluidos socios de SaaS como Salesforce

  • Una gama de recursos de AWS servicio, como colas de Amazon SQS o temas de Amazon SNS

Para seleccionar destinos
  1. Seleccione el tipo de objetivo en el panel Objetivos y colóquelo en la forma Objetivos del lienzo Construir.

    EventBridge muestra la sección Objetivo en la compilación, con las opciones de configuración aplicables en función del tipo de objetivo que haya seleccionado.

    sugerencia

    Si ha especificado más de un objetivo, al seleccionar la forma del objetivo, se muestra la sección de configuración de ese objetivo.

  2. Configure el objetivo en función del tipo de objetivo. Para ver los pasos de configuración detallados, consulte EventBridge Objetivos.

Personalice los datos del evento enviados al destino

Si selecciona un destino que no sea un bus de EventBridge eventos o un destino de EventBridge API, tiene la opción de personalizar los datos que realmente se envían al destino.

Transforma o reemplaza los datos del evento enviados (opcional)

  1. En el lienzo de diseño de Build, elija el icono de transformación de entrada en la forma Objetivos.

    EventBridge muestra la sección Transformación de entrada.

  2. En Configuración de transformación de entrada, elija Activar.

  3. Seleccione el método de transformación para elegir cómo desea personalizar el texto enviado al destino para los eventos coincidentes:

    • Parte de los eventos coincidentes: EventBridge solo envía la parte especificada del evento de origen original al destino.

    • Constante (texto JSON): EventBridge envía solo el texto JSON especificado al destino. No se envía ninguna parte del evento de origen original.

    • Transformador de entrada: configura un transformador de entrada para personalizar el texto que deseas EventBridge enviar al objetivo. Para obtener más información, consulte Transformar la entrada de destino.

Configuración dee la regla de

Por último, configure y cree la regla.

Para configurar la regla (consola)
  1. Elija Configurar.

  2. Indique un nombre para la regla y, opcionalmente, una descripción.

    Una regla no puede tener el mismo nombre que otra regla en el mismo Región de AWS y en el mismo bus de eventos.

  3. 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 Bus de eventos predeterminado de AWS . Cuando un Servicio de AWS miembro de tu cuenta envía un evento, siempre va al bus de eventos predeterminado de tu cuenta.

  4. Para habilitar la regla tan pronto como se cree, en Activación, habilita Activa.

  5. (Opcional) Introduzca una o varias etiquetas para la regla. Para obtener más información, consulte Etiquetado de recursos en Amazon EventBridge.

  6. Elija Crear.

Siguientes pasos

Tras crear la regla, puede:

Recursos adicionales

Para obtener más información sobre EventBridge las reglas, consulte: