Crear reglas de Amazon EventBridge que reaccionan a eventos - Amazon EventBridge
Crear una regla que reacciona a eventos

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 de Amazon EventBridge que reaccionan a eventos

Para tomar medidas en relación con los eventos recibidos por Amazon EventBridge, puede crear reglas. Cuando un evento coincide con el patrón de eventos definido en su regla, EventBridge envía el evento al destino especificado y activa la acción definida en la regla.

En el siguiente vídeo, se explica cómo crear diferentes tipos de reglas y someterlas a prueba:

Crear una regla que reacciona a eventos

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

Definir la regla

En primer lugar, escriba un nombre y la descripción de la regla para identificarla. También debe definir el bus de eventos en el que la regla busca los eventos que coincidan con un patrón de eventos.

Para definir los detalles de la 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. Seleccione Crear regla.

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

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

  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 Bus de eventos predeterminado de AWS. Cuando un Servicio de AWS en su cuenta emite un evento, siempre va al bus de eventos predeterminado de su cuenta.

  6. En Tipo de regla, elija Regla con un patrón de evento.

  7. Seleccione Siguiente.

Crear el patrón de eventos

A continuación, cree el patrón de eventos. Para ello, especifique el origen del evento, elija la base del patrón de eventos y defina los atributos y valores con los que debe coincidir. También puede generar el patrón de eventos en JSON y probarlo con un evento de muestra.

Crear el patrón de eventos

  1. En Origen del evento, seleccione Eventos de AWS o eventos de socios de EventBridge.

  2. (Opcional) En la sección Eventos de muestra, seleccione un tipo de evento de muestra con el que quiera probar su patrón de eventos.

    Están disponibles los siguientes eventos de muestra:

    • Eventos de AWS: seleccione uno de los eventos emitidos desde Servicios de AWS compatibles..

    • Eventos de socios de EventBridge: seleccione entre los eventos emitidos por servicios de terceros que admiten EventBridge, como Salesforce.

    • Introducir el mío: introduzca su propio evento en texto JSON.

      También puede usar un evento de AWS o un evento de socios como punto de partida para crear su propio evento personalizado.

      1. Seleccione eventos de AWS o eventos de socios de EventBridge.

      2. Use el menú desplegable Eventos de muestra para seleccionar el evento que desea usar como punto de partida para su evento personalizado.

        EventBridge muestra el evento de muestra.

      3. Seleccione Copiar.

      4. Seleccione Introducir el mío para Tipo de evento.

      5. Elimine la estructura del evento de muestra en el panel de edición de JSON y pegue el evento de AWS o el evento de socios en su lugar.

      6. Edite la JSON del evento para crear su propio evento de muestra.

  3. Seleccione un método de creación. Puede crear un patrón de eventos a partir de un esquema o plantilla de EventBridge, o puede crear un patrón de eventos personalizado.

    Existing schema

    Para utilizar un esquema de EventBridge existente con el objetivo de crear el patrón de eventos, haga lo siguiente:

    1. En la sección Método de creación, en Método, seleccione Usar esquema.

    2. En la sección Patrón de eventos, para Tipo de esquema, seleccione Seleccionar esquema del registro de esquemas.

    3. Para el Registro de esquemas, seleccione el cuadro desplegable e indique el nombre de un registro de esquemas, por ejemplo, aws.events. También puede seleccionar una opción de la lista desplegable que aparece.

    4. En Esquema, seleccione el cuadro desplegable e indique el nombre del esquema que se va a usar. Por ejemplo, aws.s3@ObjectDeleted. También puede seleccionar una opción de la lista desplegable que aparece.

    5. En la sección Modelos, seleccione el botón Editar situado junto a cualquier atributo para abrir sus propiedades. Configure los campos Relación y Valor según sea necesario y, a continuación, seleccione Configurar para guardar el atributo.

      nota

      Para obtener información sobre la definición de un atributo, selecciona el icono de información situado junto al nombre del atributo. Para obtener información sobre cómo configurar las propiedades de los atributos en su evento, abra la sección Nota del cuadro de diálogo de propiedades de los atributos.

      Para eliminar las propiedades de un atributo, seleccione el botón Editar de ese atributo y, a continuación, seleccione Borrar.

    6. Seleccione Generar patrón de eventos en JSON para generar y validar su patrón de eventos como texto JSON.

    7. (Opcional) Para probar el evento de muestra con su patrón de prueba, seleccione Patrón de prueba.

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

      Puede elegir una de las siguientes opciones:

      • Copiar: copia el patrón de eventos en el portapapeles de su dispositivo.

      • Prettify: facilita la lectura del texto JSON al añadir saltos de línea, tabulaciones y espacios.

    Custom schema

    Para escribir un esquema personalizado y convertirlo en un patrón de eventos, haga lo siguiente:

    1. En la sección Método de creación, en Método, seleccione Usar esquema.

    2. En la sección Patrón de eventos, en Tipo de esquema, seleccione Introducir esquema.

    3. Introduzca su esquema en el cuadro de texto. Debe formatear el esquema como texto JSON válido.

    4. En la sección Modelos, seleccione el botón Editar situado junto a cualquier atributo para abrir sus propiedades. Configure los campos Relación y Valor según sea necesario y, a continuación, seleccione Configurar para guardar el atributo.

      nota

      Para obtener información sobre la definición de un atributo, selecciona el icono de información situado junto al nombre del atributo. Para obtener información sobre cómo configurar las propiedades de los atributos en su evento, abra la sección Nota del cuadro de diálogo de propiedades de los atributos.

      Para eliminar las propiedades de un atributo, seleccione el botón Editar de ese atributo y, a continuación, seleccione Borrar.

    5. Seleccione Generar patrón de eventos en JSON para generar y validar su patrón de eventos como texto JSON.

    6. (Opcional) Para probar el evento de muestra con su patrón de prueba, seleccione Patrón de prueba.

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

      Puede elegir una de las siguientes opciones:

      • Copiar: copia el patrón de eventos en el portapapeles de su dispositivo.

      • Prettify: facilita la lectura del texto JSON al añadir saltos de línea, tabulaciones y espacios.

    Event pattern

    Para escribir un patrón de evento personalizado en formato JSON, haga lo siguiente:

    1. En la sección Método de creación, en Método, seleccione Patrón personalizado (editor JSON).

    2. En Patrón de eventos, introduzca su patrón de eventos personalizado en texto con formato JSON.

    3. (Opcional) Para probar el evento de muestra con su patrón de prueba, seleccione Patrón de prueba.

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

      Puede elegir una de las siguientes opciones:

      • Copiar: copia el patrón de eventos en el portapapeles de su dispositivo.

      • Prettify: facilita la lectura del texto JSON al añadir saltos de línea, tabulaciones y espacios.

      • Formulario de patrón de eventos: abre el patrón de eventos en Pattern Builder. Si el patrón no se puede representar en Pattern Builder tal cual, EventBridge le avisa antes de abrir Pattern Builder.

  4. Seleccione Siguiente.

Seleccionar los destinos

Elija uno o más destinos para recibir los eventos que coincidan con el patrón especificado. Los destinos pueden incluir un bus de eventos de EventBridge, destinos de la API de EventBridge, incluidos socios de SaaS como Salesforce u otro Servicio de AWS.

Para seleccionar destinos

  1. En Tipo de destino, seleccione uno de los siguientes tipos de destinos:

    Event bus

    Para seleccionar un bus de eventos de EventBridge, seleccione Bus de eventos de EventBridge y, a continuación, haga lo siguiente:

    API destination

    Para usar un destino de la API de EventBridge, seleccione Destino de la API de EventBridge y, a continuación, realice una de las siguientes acciones:

    • Para usar un destino de la API existente, selecciona Usar un destino de la API existente. A continuación, seleccione un destino de la API en la lista desplegable.

    • Para crear un nuevo destino de la API, seleccione Crear un nuevo destino de la API. A continuación, proporcione los detalles del destino:

      • Nombre: introduzca un nombre para el destino.

        Los nombres deben ser únicos en su Cuenta de AWS. Los nombres pueden tener un máximo de 64 caracteres. Los caracteres válidos son A-Z, a-z, 0-9 y . _ - (guion).

      • (Opcional) Descripción: introduzca una descripción para el destino.

        Las descripciones pueden tener hasta 512 caracteres.

      • Punto de conexión de destino de la API: el punto de conexión de la URL del destino.

        La URL del punto de conexión debe empezar por https. Puede incluir el * como carácter comodín del parámetro de ruta. Puede establecer los parámetros de ruta a partir del atributo HttpParameters del destino.

      • Método HTTP: seleccione el método HTTP utilizado al invocar el punto de conexión.

      • (Opcional) Límite de la tasa de invocación por segundo: introduzca el número máximo de invocaciones aceptadas por segundo para este destino.

        Este valor debe ser mayor que cero. De forma predeterminada, este valor se establece en 300.

      • Conexión: elija usar una conexión nueva o existente:

        • Para usar una conexión existente, seleccione Usar una conexión existente y seleccione la conexión en la lista desplegable.

        • Para crear una conexión nueva para este destino, seleccione Crear una conexión nueva y, a continuación, defina el nombre de la conexión, el tipo de destino y el tipo de autorización. También puede agregar una descripción opcional para esta conexión.

    Para obtener más información, consulte Destinos de la API.

    Servicio de AWS

    Para usar un Servicio de AWS, seleccione y Servicio de AWS, a continuación, haga lo siguiente:

    1. En Seleccionar un destino, seleccione un Servicio de AWS para usarlo como destino. Proporcione la información solicitada para el servicio que seleccione.

      nota

      Los campos que se muestran varían en función del servicio seleccionado. Para obtener más información sobre los destinos disponibles, consulte Los objetivos están disponibles en la EventBridge consola.

  2. Si hay muchos tipos de destino, EventBridge necesita permisos para enviar eventos al destino. En estos casos, EventBridge puede crear el rol de IAM necesario para que se ejecute la regla.

    En Rol de ejecución, haga una de estas operaciones:

    • Para crear un nuevo rol de ejecución para esta regla:

      1. Seleccione Crear un rol nuevo para este recurso específico.

      2. Introduzca un nombre para este rol de ejecución o utilice el nombre generado por EventBridge.

    • Para usar un rol de ejecución existente para esta regla:

      1. Seleccione Usar un rol existente.

      2. Introduzca o seleccione el nombre del rol de ejecución que se va a utilizar en la lista desplegable.

  3. (Opcional) En Configuración adicional, especifique cualquiera de las configuraciones opcionales disponibles para su tipo de destino:

    Event bus

    (Opcional) En Cola de mensajes fallidos, elija si desea utilizar una cola de Amazon SQS estándar como cola de mensajes fallidos. EventBridge envía eventos que coincidan con esta regla a la cola de mensajes fallidos si no se entregan correctamente al destino. Haga una de las siguientes acciones:

    • Elija None (Ninguno) para no usar una cola de mensajes fallidos.

    • Elija Seleccionar una cola de Amazon SQS en la cuenta de AWS actual para utilizarla como cola de mensajes fallidos y, a continuación, seleccione de la lista desplegable la cola que quiera usar.

    • Elija Seleccionar una cola de Amazon SQS en otra cuenta de AWS como cola de mensajes fallidos y luego ingrese el ARN de la cola que quiera usar. Debe asociar una política basada en recursos a la cola que conceda permiso a EventBridge para enviarle mensajes.

      Para obtener más información, consulte Concesión de permisos a la cola de mensajes fallidos.

    API destination

    1. (Opcional) En Configurar entrada de destino, elija cómo desea personalizar el texto enviado al destino para los eventos coincidentes. Elija una de las siguientes opciones:

      • Eventos coincidentes: EventBridge envía todo el evento de origen original al destino. Esta es la opción predeterminada.

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

        En Especificar la parte del evento coincidente, especifique una ruta JSON que defina la parte del evento que quiere que EventBridge envíe 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.

        En Especificar la constante en JSON, especifique el texto JSON que quiere que EventBridge envíe al destino en lugar del evento.

      • Transformador de entrada: configure un transformador de entrada para personalizar el texto que quiere que EventBridge envíe al destino. Para obtener más información, consulte Transformación EventBridge de entradas de Amazon.

        1. Seleccione Configurar transformador de entrada.

        2. Configure el transformador de entrada siguiendo los pasos que se indican en Configuración de un transformador de entrada como parte de la creación de una regla.

    2. (Opcional) En Política de reintentos, especifique cómo debe volver a intentar EventBridge enviar un evento a un destino después de que se produzca un error.

      • Antigüedad máxima del evento: introduzca la cantidad máxima de tiempo (en horas, minutos y segundos) para que EventBridge retenga los eventos sin procesar. El valor predeterminado es 24 horas.

      • Número de reintentos: introduzca el número máximo de veces que EventBridge debe volver a intentar enviar un evento al destino tras producirse un error. El valor predeterminado es 185 veces.

    3. (Opcional) En Cola de mensajes fallidos, elija si desea utilizar una cola de Amazon SQS estándar como cola de mensajes fallidos. EventBridge envía eventos que coincidan con esta regla a la cola de mensajes fallidos si no se entregan correctamente al destino. Haga una de las siguientes acciones:

      • Elija None (Ninguno) para no usar una cola de mensajes fallidos.

      • Elija Seleccionar una cola de Amazon SQS en la cuenta de AWS actual para utilizarla como cola de mensajes fallidos y, a continuación, seleccione de la lista desplegable la cola que quiera usar.

      • Elija Seleccionar una cola de Amazon SQS en otra cuenta de AWS como cola de mensajes fallidos y luego ingrese el ARN de la cola que quiera usar. Debe asociar una política basada en recursos a la cola que conceda permiso a EventBridge para enviarle mensajes.

        Para obtener más información, consulte Concesión de permisos a la cola de mensajes fallidos.

    AWS service

    Tenga en cuenta que es posible que EventBridge no muestre todos los campos siguientes para un servicio de AWS determinado.

    1. (Opcional) En Configurar entrada de destino, elija cómo desea personalizar el texto enviado al destino para los eventos coincidentes. Elija una de las siguientes opciones:

      • Eventos coincidentes: EventBridge envía todo el evento de origen original al destino. Esta es la opción predeterminada.

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

        En Especificar la parte del evento coincidente, especifique una ruta JSON que defina la parte del evento que quiere que EventBridge envíe 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.

        En Especificar la constante en JSON, especifique el texto JSON que quiere que EventBridge envíe al destino en lugar del evento.

      • Transformador de entrada: configure un transformador de entrada para personalizar el texto que quiere que EventBridge envíe al destino. Para obtener más información, consulte Transformación EventBridge de entradas de Amazon.

        1. Seleccione Configurar transformador de entrada.

        2. Configure el transformador de entrada siguiendo los pasos que se indican en Configuración de un transformador de entrada como parte de la creación de una regla.

    2. (Opcional) En Política de reintentos, especifique cómo debe volver a intentar EventBridge enviar un evento a un destino después de que se produzca un error.

      • Antigüedad máxima del evento: introduzca la cantidad máxima de tiempo (en horas, minutos y segundos) para que EventBridge retenga los eventos sin procesar. El valor predeterminado es 24 horas.

      • Número de reintentos: introduzca el número máximo de veces que EventBridge debe volver a intentar enviar un evento al destino tras producirse un error. El valor predeterminado es 185 veces.

    3. (Opcional) En Cola de mensajes fallidos, elija si desea utilizar una cola de Amazon SQS estándar como cola de mensajes fallidos. EventBridge envía eventos que coincidan con esta regla a la cola de mensajes fallidos si no se entregan correctamente al destino. Haga una de las siguientes acciones:

      • Elija None (Ninguno) para no usar una cola de mensajes fallidos.

      • Elija Seleccionar una cola de Amazon SQS en la cuenta de AWS actual para utilizarla como cola de mensajes fallidos y, a continuación, seleccione de la lista desplegable la cola que quiera usar.

      • Elija Seleccionar una cola de Amazon SQS en otra cuenta de AWS como cola de mensajes fallidos y luego ingrese el ARN de la cola que quiera usar. Debe asociar una política basada en recursos a la cola que conceda permiso a EventBridge para enviarle mensajes.

        Para obtener más información, consulte Concesión de permisos a la cola de mensajes fallidos.

  4. (Opcional) Seleccione Agregar otro destino para agregar otro destino para esta regla.

  5. Seleccione Siguiente.

Tenga en cuenta que es posible que EventBridge no muestre todos los campos siguientes para un servicio de AWS determinado.

Configure las etiquetas y revise la regla

Por último, introduzca las etiquetas que desee para la regla y, a continuación, revise y cree la regla.

Para configurar las etiquetas y revisar y crear la regla

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

  2. Seleccione Siguiente.

  3. Revise los detalles de la nueva regla. Para realizar cambios en cualquier sección, pulse el botón Editar situado junto a esa sección.

    Cuando esté satisfecho con los detalles de la regla, seleccione Crear regla.