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.
# Reglas en Amazon EventBridge
Usted especifica EventBridge qué hacer con los eventos entregados a cada bus de eventos. Para ello, debe crear *reglas*. Una regla especifica qué eventos enviar a qué [destinos](eb-targets.md) para su procesamiento. Una sola regla puede enviar un evento a varios destinos, que luego se ejecutan en paralelo.
Puede crear dos tipos de reglas: reglas que coincidan con los datos de los eventos a medida que se entregan los eventos y reglas que se ejecutan según una programación definida. Además, algunos AWS servicios también pueden crear y administrar reglas en tu cuenta.
## Reglas que coinciden con los datos del evento
Puede crear reglas que coincidan con los eventos entrantes en función de los criterios de los datos del evento (lo que se denomina *patrón de eventos*). Un patrón de eventos define la estructura del evento y los campos con los que coincide una regla. Si un evento coincide con los criterios definidos en el patrón de eventos, lo EventBridge envía a los destinos que especifique.
Para obtener más información, consulte [Crear reglas en Amazon EventBridge](eb-create-rule-visual.md).
## Reglas que se ejecutan según una programación
**nota**
Las reglas programadas son una característica heredada de EventBridge.
EventBridgeofrece una forma más flexible y potente de crear, ejecutar y gestionar las tareas programadas de forma centralizada y a escala: EventBridge Scheduler. Con EventBridge Scheduler, puede crear planificaciones utilizando expresiones cron y rate para patrones recurrentes, o configurar invocaciones únicas. Puede configurar intervalos de tiempo flexibles para la entrega, definir límites de reintentos y establecer el tiempo máximo de retención para las invocaciones de la API.
Scheduler es altamente personalizable y ofrece una escalabilidad mejorada en comparación con las reglas programadas, con un conjunto más amplio de operaciones y servicios de API de destino. AWS Se recomienda utilizar el Programador para invocar los destinos en una programación.
Para obtener más información, consulta la Guía del [Creación de una programación](using-eventbridge-scheduler.md#using-eventbridge-scheduler-create) usuario de *[EventBridge Scheduler](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html)*.
También puede crear reglas que envíen eventos a los destinos especificados a intervalos específicos. Por ejemplo, para ejecutar una Lambda función periódicamente, puede crear una regla que se ejecute según una programación.
Para obtener más información, consulte [Crear una regla programada (antigua) en Amazon EventBridge](eb-create-rule-schedule.md).
## Reglas administradas por AWS los servicios
Además de las reglas que usted cree, AWS los servicios pueden crear y administrar EventBridge reglas en su AWS cuenta que son necesarias para determinadas funciones de esos servicios. Se denominan *reglas administradas*.
Cuando un servicio crea una regla administrada, también puede crear una [política de IAM](eb-iam.md) que conceda permiso a dicho servicio para crear la regla. Las políticas de IAM creadas de esta manera se asignan de forma reducida con permisos de nivel de recursos, para permitir la creación solo de las reglas necesarias.
Puede eliminar las reglas administradas mediante la opción **Forzar eliminación**, pero solo debe eliminarlas si está seguro de que el otro servicio ya no necesita la regla. De lo contrario, eliminar una regla administrada hace que las características que dependen de ella dejen de funcionar.
# 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
1. Configure el filtrado y las pruebas de eventos
1. Seleccione y configure los objetivos
1. 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/](https://console.aws.amazon.com/events/).
1. En el panel de navegación, selecciona **Reglas** y, a continuación, selecciona **Crear regla**.
1. En la pestaña **Eventos**, busca los eventos que deseas enviar al destino:
1. Elige **Eventos AWS de servicio** o **Eventos personalizados**.
1. Usa el cuadro de búsqueda o navega por la lista de eventos para encontrar los eventos que deseas enviar al objetivo.
1. 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**: 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**.
1. 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.
1. 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](eb-create-pattern-operators.md).
1. Introduzca el valor que desee que coincida.
1. 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**.
1. 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**.
1. En **Ejemplo de evento desencadenante**, seleccione el evento que desee utilizar para las pruebas en la lista desplegable.
+ **Usa tu propio evento**
1. Elija **Usar el evento propio**.
EventBridge muestra un evento genérico con un `details` elemento vacío.
1. Edita el JSON del evento para crear el evento con el que quieres probar tu patrón de eventos.
**sugerencia**
Puede utilizar los eventos de ejemplo proporcionados como puntos de partida para crear sus eventos personalizados propios y utilizarlos en las pruebas:
Elija **Usar los eventos de ejemplos proporcionados**, elija un evento del **Evento desencadenante de ejemplo** y, a continuación, elija **Copiar**.
Elija **Usar el evento propio**.
Seleccione el evento completo en la ventana y pegue el evento de ejemplo sobre él.
Edite el evento como desee.
1. Elige **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.
1. Configure el objetivo en función del tipo de objetivo. Para ver los pasos de configuración detallados, consulte [EventBridge Objetivos](eb-targets.md).
### 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**.
1. En **Configuración de transformación de entrada**, elija **Activar**.
1. 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](eb-transform-target-input.md).
## Configuración dee la regla de
Por último, configure y cree la regla.
**Para configurar la regla (consola)**
1. Elija **Configurar**.
1. 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.
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 **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.
1. Para habilitar la regla tan pronto como se cree, en **Activación**, habilita **Activa**.
1. (Opcional) Introduzca una o varias etiquetas para la regla. Para obtener más información, consulte [Recursos de etiquetado en Amazon EventBridge](eb-tagging.md).
1. Elija **Crear**.
## Siguientes pasos
Tras crear la regla, puede:
+ [Supervise el rendimiento de las reglas mediante métricas](eb-monitoring.md)
+ [Pon a prueba tu regla con ejemplos de eventos](eb-event-pattern-sandbox.md)
+ [Modifique los patrones de eventos según sea necesario](eb-event-patterns.md)
+ [Añada objetivos adicionales a las reglas existentes](eb-targets.md)
## Recursos adicionales
Para obtener más información sobre EventBridge las reglas, consulte:
+ [EventBridge descripción general de las reglas](eb-rules.md)
+ [Creación de patrones de eventos](eb-event-patterns.md)
+ [EventBridge objetivos](eb-targets.md)
+ [ EventBridge Reglas de solución de problemas](eb-troubleshooting.md)
# Crear reglas que reaccionen a los eventos en Amazon EventBridge
Para tomar medidas en relación con los eventos recibidos por Amazon EventBridge, puedes crear [reglas](eb-rules.md). Cuando un evento coincide con el [patrón de eventos](eb-event-patterns.md) definido en tu regla, EventBridge envía el evento al [objetivo](eb-targets.md) especificado y desencadena la acción definida en la regla.
Los siguientes pasos explican 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.
**Topics**
+ [Definir la regla](#eb-create-rule-define)
+ [Crear el patrón de eventos](#eb-create-rule-event-pattern)
+ [Seleccionar los destinos](#eb-create-rule-target)
+ [Configure las etiquetas y revise la regla](#eb-create-rule-review)
## 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. Abre la EventBridge consola de Amazon en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. En el panel de navegación, seleccione **Reglas**.
1. Seleccione **Crear regla**.
1. 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.
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 **Bus de eventos predeterminado de AWS **. Cuando un Servicio de AWS elemento de tu cuenta emite un evento, siempre va al bus de eventos predeterminado de tu cuenta.
1. En **Tipo de regla**, elija **Regla con un patrón de evento**.
1. 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**, selecciona **AWS eventos o eventos EventBridge asociados**.
1. (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:
+ **AWS eventos**: seleccione entre los eventos emitidos desde los compatibles Servicios de AWS.
+ **EventBridge eventos de socios**: selecciona entre los eventos emitidos por servicios de terceros que ofrecen soporte EventBridge, como Salesforce.
+ **Escribir el mío**: introduzca su propio evento en texto JSON.
También puede utilizar un evento AWS o un evento asociado como punto de partida para crear su propio evento personalizado.
1. Selecciona **AWS eventos** o **eventos EventBridge asociados**.
1. 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.
1. Seleccione **Copiar**.
1. Seleccione **Escribir el mío** para el **tipo de evento.**
1. Elimine la estructura de eventos de ejemplo en el panel de edición de JSON y pegue el evento AWS o el asociado en su lugar.
1. Edite la JSON del evento para crear su propio evento de muestra.
1. Seleccione un **método de creación**. Puede crear un patrón de eventos a partir de un EventBridge esquema o una plantilla, o puede crear un patrón de eventos personalizado.
------
#### [ Existing schema ]
Para usar un EventBridge esquema existente para 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**.
1. En la sección **Patrón de eventos**, para **Tipo de esquema**, seleccione **Seleccione el esquema del registro de esquemas**.
1. 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.
1. 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.
1. 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**.
1. Seleccione **Generar patrón de eventos en JSON** para generar y validar el patrón de eventos como texto JSON.
1. (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**.
1. En la sección **Patrón de eventos**, en **Tipo de esquema**, seleccione **Introducir esquema**.
1. Introduzca el esquema en el cuadro de texto. Debe formatear el esquema como texto JSON válido.
1. 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**.
1. Seleccione **Generar patrón de eventos en JSON** para generar y validar el patrón de eventos como texto JSON.
1. (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 eventos 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)**.
1. En **Patrón de eventos**, introduzca el patrón de eventos personalizado en texto con formato JSON.
1. (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 renderizar en Pattern Builder tal cual, le EventBridge avisa antes de abrir Pattern Builder.
------
1. Elija **Siguiente**.
## Seleccionar los destinos
Elija uno o más destinos para recibir los eventos que coincidan con el patrón especificado. Los objetivos pueden incluir un bus de EventBridge eventos, destinos de EventBridge API, incluidos socios de SaaS como Salesforce u otros. Servicio de AWS
**Para seleccionar destinos**
1. En **Tipo de destino**, seleccione uno de los siguientes tipos de destinos:
------
#### [ Event bus ]
1. Seleccione el autobús de **EventBridge eventos**.
1. Elija el bus de eventos que desee utilizar como destino.
+ Para usar un bus de eventos de la Región de AWS misma manera que esta regla:
1. Seleccione **Bus de eventos en la misma cuenta y región**.
1. En **Bus de eventos para destino**, seleccione el cuadro desplegable e introduzca el nombre del bus de eventos. También puede seleccionar el bus de eventos en la lista desplegable.
Para obtener más información, consulte [Envío de eventos entre buses de eventos de la misma cuenta y región en Amazon EventBridge](eb-bus-to-bus.md).
+ Para usar un bus de eventos en una cuenta Región de AWS o cuenta diferente según esta regla:
1. Seleccione **Bus de eventos en una cuenta o región diferente**.
1. Para **Bus de eventos como destino**, introduzca el ARN del bus de eventos que desee utilizar.
Para obtener más información, consulte lo siguiente:
+ [Envío y recepción de eventos entre AWS cuentas de Amazon EventBridge](eb-cross-account.md)
+ [Envío y recepción de eventos entre AWS regiones de Amazon EventBridge](eb-cross-region.md)
1. Si hay muchos tipos de destino, EventBridge necesita permisos para enviar eventos al destino. En estos casos, EventBridge puede crear la función de IAM necesaria 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**.
1. 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**.
1. Introduzca o seleccione el nombre del rol de ejecución que se va a utilizar en la lista desplegable.
1. (Opcional) En **Configuración adicional**, especifique cualquiera de las configuraciones opcionales disponibles para su tipo de destino:
(Opcional) En el caso **de la cola de cartas sin salida**, elija si desea utilizar una cola estándar de Amazon SQS como cola de cartas sin salida. EventBridge envía los eventos que cumplen con esta regla a la lista de espera en caso de que no se entreguen correctamente al destino. Realice una de las siguientes acciones:
+ Seleccione **Ninguna** 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 adjuntar a la cola una política basada en recursos que le conceda EventBridge permiso para enviarle mensajes.
Para obtener más información, consulte [Concesión de permisos a la cola de mensajes fallidos](eb-rule-dlq.md#eb-dlq-perms).
------
#### [ API destination ]
1. **Selecciona el destino EventBridge de la API.**
1. Elija un destino de la API nuevo o existente:
+ Para usar un destino de la API existente, seleccione **Utilizar 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 **.** **\$1** **-** (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 **\$1** 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.
El 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.
1. Si hay muchos tipos de destino, EventBridge necesita permisos para enviar eventos al destino. En estos casos, EventBridge puede crear la función de IAM necesaria 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**.
1. 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**.
1. Introduzca o seleccione el nombre del rol de ejecución que se va a utilizar en la lista desplegable.
1. (Opcional) En **Configuración adicional**, especifique cualquiera de las configuraciones opcionales disponibles para su tipo de destino:
Tenga en cuenta que es EventBridge posible que no se muestren todos los campos siguientes para un AWS servicio determinado.
1. (Opcional) En Configurar entrada de destino, elija cómo desea personalizar el texto enviado al destino para los eventos coincidentes. Seleccione una de las siguientes opciones:
+ **Eventos coincidentes**: EventBridge envía todo el evento de origen original al destino. Es el valor predeterminado.
+ **Parte de los eventos coincidentes**: EventBridge solo envía la parte especificada del evento de origen original al destino.
En **Especifique la parte del evento coincidente**, especifique una ruta JSON que defina la parte del evento que desea enviar EventBridge 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 desea enviar EventBridge al destino en lugar del evento.
+ **Transformador** de entrada: configura un transformador de entrada para personalizar el texto que deseas EventBridge enviar al destino. Para obtener más información, consulte [Transformación EventBridge de entradas de Amazon](eb-transform-target-input.md).
1. Seleccione **Configurar transformador de entrada**.
1. Configure el transformador de entrada siguiendo los pasos que se indican en [Configurar un transformador de entrada al crear una regla en EventBridge](eb-transform-input-rule.md).
1. (Opcional) En la **política de reintentos**, especifique cómo se EventBridge debe volver a intentar enviar un evento a un destino después de que se produzca un error.
+ **Antigüedad máxima del evento**: introduce la cantidad máxima de tiempo (en horas, minutos y segundos) EventBridge para conservar los eventos sin procesar. El valor predeterminado es 24 horas.
+ **Intentos de reintento**: introduce el número máximo de veces que se EventBridge debe volver a intentar enviar un evento al destino después de que se produzca un error. El valor predeterminado es 185 veces.
1. (Opcional) En el caso **de la cola de cartas sin salida**, elija si desea utilizar una cola estándar de Amazon SQS como cola de cartas sin salida. EventBridge envía los eventos que cumplen con esta regla a la lista de espera en caso de que no se entreguen correctamente al destino. Realice una de las siguientes acciones:
+ Seleccione **Ninguna** para no usar una cola de mensajes fallidos.
+ Elija **Seleccione una cola de Amazon SQS en la AWS cuenta corriente para utilizarla como cola de letra muerta y, a continuación, seleccione la cola** que desee utilizar en la lista desplegable.
+ 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 adjuntar a la cola una política basada en recursos que le conceda permiso para enviarle mensajes. EventBridge
Para obtener más información, consulte [Concesión de permisos a la cola de mensajes fallidos](eb-rule-dlq.md#eb-dlq-perms).
Para obtener más información, consulte [Los destinos de la API como objetivos en Amazon EventBridge](eb-api-destinations.md).
------
#### [ Servicio de AWS ]
1. Seleccione **Servicio de AWS**.
1. En **Seleccionar un destino**, seleccione un Servicio de AWS para usarlo como destino.
1. Si elige un AWS servicio que admita los destinos multicuenta, puede seleccionar un destino en la misma cuenta que el bus de eventos o en una cuenta diferente.
+ Para un destino de la misma cuenta, en **Tipo de destino**, seleccione **Destino en esta cuenta**.
1. 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 del bus de eventos están disponibles en la EventBridge consola](eb-targets.md#eb-console-targets).
1. 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**.
1. 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**.
1. Introduzca o seleccione el nombre del rol de ejecución que se va a utilizar en la lista desplegable.
+ Para un destino de otra cuenta, en **Tipo de destino**, seleccione **Destino en otra AWS cuenta**.
1. Introduzca el ARN del recurso de destino al que desea enviar eventos.
1. Proporcione la información adicional solicitada para el servicio que seleccione.
1. Seleccione el nombre del rol de ejecución que se va a utilizar en la lista desplegable.
1. (Opcional) En **Configuración adicional**, especifique cualquiera de las configuraciones opcionales disponibles para su tipo de destino:
1. (Opcional) En Configurar entrada de destino, elija cómo desea personalizar el texto enviado al destino para los eventos coincidentes. Seleccione una de las siguientes opciones:
+ **Eventos coincidentes**: EventBridge envía todo el evento de origen original al destino. Es el valor predeterminado.
+ **Parte de los eventos coincidentes**: EventBridge solo envía la parte especificada del evento de origen original al destino.
En **Especifique la parte del evento coincidente**, especifique una ruta JSON que defina la parte del evento que desea enviar EventBridge 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 desea enviar EventBridge al destino en lugar del evento.
+ **Transformador** de entrada: configura un transformador de entrada para personalizar el texto que deseas EventBridge enviar al destino. Para obtener más información, consulte [Transformación EventBridge de entradas de Amazon](eb-transform-target-input.md).
1. Seleccione **Configurar transformador de entrada**.
1. Configure el transformador de entrada siguiendo los pasos que se indican en [Configurar un transformador de entrada al crear una regla en EventBridge](eb-transform-input-rule.md).
1. (Opcional) En la **política de reintentos**, especifique cómo se EventBridge debe volver a intentar enviar un evento a un destino después de que se produzca un error.
+ **Antigüedad máxima del evento**: introduce la cantidad máxima de tiempo (en horas, minutos y segundos) EventBridge para conservar los eventos sin procesar. El valor predeterminado es 24 horas.
+ **Intentos de reintento**: introduce el número máximo de veces que se EventBridge debe volver a intentar enviar un evento al destino después de que se produzca un error. El valor predeterminado es 185 veces.
1. (Opcional) En el caso **de la cola de cartas sin salida**, elija si desea utilizar una cola estándar de Amazon SQS como cola de cartas sin salida. EventBridge envía los eventos que cumplen con esta regla a la lista de espera en caso de que no se entreguen correctamente al destino. Realice una de las siguientes acciones:
+ Seleccione **Ninguna** para no usar una cola de mensajes fallidos.
+ Elija **Seleccione una cola de Amazon SQS en la AWS cuenta corriente para utilizarla como cola de letra muerta y, a continuación, seleccione la cola** que desee utilizar en la lista desplegable.
+ 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 adjuntar a la cola una política basada en recursos que le conceda permiso para enviarle mensajes. EventBridge
Para obtener más información, consulte [Concesión de permisos a la cola de mensajes fallidos](eb-rule-dlq.md#eb-dlq-perms).
------
1. (Opcional) Seleccione **Agregar otro destino** para agregar otro destino para esta regla.
1. Elija **Siguiente**.
## 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 [Recursos de etiquetado en Amazon EventBridge](eb-tagging.md).
1. Elija **Siguiente**.
1. 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**.
# Desactivar o eliminar una regla en Amazon EventBridge
Para impedir que una [regla](eb-rules.md) procese [eventos](eb-events.md) o se ejecute según una programación, puede eliminarla o deshabilitarla. En los pasos siguientes, se explica cómo eliminar o deshabilitar una EventBridge regla.
**Para eliminar o deshabilitar una regla**
1. Abre la EventBridge consola de Amazon en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. En el panel de navegación, seleccione **Reglas**.
En **Bus de eventos**, seleccione el bus de eventos asociado a la regla.
1. Realice una de las siguientes acciones:
1. Para eliminar una regla, seleccione el botón que aparece junto a la regla y seleccione **Acciones**, **Eliminar**, **Eliminar**.
Si la regla es una regla administrada, introduzca el nombre de la regla para confirmar que se trata de una regla administrada y que la eliminación puede detener la funcionalidad en el servicio que ha creado la regla. Para continuar, introduzca el nombre de la regla y elija **Forzar eliminación**.
1. Para deshabilitar temporalmente una regla, seleccione el botón que aparece junto a la regla y elija **Deshabilitar**, **Deshabilitar**.
No puede deshabilitar una regla administrada.
# Mejores prácticas a la hora de definir reglas en Amazon EventBridge
A continuación, se muestran algunas prácticas recomendadas que se deben tener en cuenta al crear reglas para los buses de eventos.
## Establecer un destino único para cada regla
Si bien puede especificar hasta cinco destinos para una regla determinada, le resultará más fácil administrar las reglas si especifica un único destino para cada regla. Si más de un destino necesita recibir el mismo conjunto de eventos, se recomienda duplicar la regla para enviar los mismos eventos a destinos diferentes. Esta encapsulación simplifica el mantenimiento de las reglas: si las necesidades de los destinos de eventos varían con el tiempo, puede actualizar cada regla y su patrón de eventos de forma independiente de las demás.
## Establecer permisos de reglas
Puede habilitar los componentes o servicios de la aplicación que consumen muchos eventos para que controlen la administración de sus propias reglas. Un enfoque arquitectónico común que adoptan los clientes consiste en aislar estos componentes o servicios de la aplicación mediante AWS cuentas independientes. Para habilitar el flujo de eventos de una cuenta a otra, debe crear una regla en un bus de eventos que dirija los eventos a un bus de eventos de otra cuenta. Puede habilitar los equipos o servicios que consumen muchos eventos para que controlen la administración de sus propias reglas. Para ello, especifique los permisos adecuados para sus cuentas mediante políticas de recursos. Esto funciona en todas las cuentas y regiones.
Para obtener más información, consulte [Permisos para autobuses de eventos en Amazon EventBridge](eb-event-bus-perms.md).
Para ver un ejemplo de políticas de recursos, consulta [Patrones de diseño de varias cuentas con Amazon EventBridge activado](https://github.com/aws-samples/amazon-eventbridge-resource-policy-samples/tree/main/patterns) GitHub.
## Supervisar el rendimiento de las reglas
Supervise sus reglas para asegurarse de que funcionan según lo esperado:
+ Supervisar la métrica `TriggeredRules` para detectar puntos de datos faltantes o anomalías puede ayudarte a detectar discrepancias si un publicador ha realizado un cambio radical. Para obtener más información, consulte [Supervisión de Amazon EventBridge](eb-monitoring.md).
+ La alarma en caso de anomalías o el recuento máximo esperado también pueden ayudar a detectar si una regla coincide con nuevos eventos. Esto puede suceder cuando los publicadores, incluidos los servicios de AWS y los socios de SaaS, introducen nuevos eventos al habilitar nuevos casos de uso y características. Cuando estos nuevos eventos son inesperados y generan un volumen superior a la velocidad de procesamiento del destino final, pueden provocar una acumulación de eventos pendientes.
Este procesamiento de eventos inesperados también puede generar cargos de facturación no deseados.
También puede provocar una limitación de las reglas cuando la cuenta supera su cuota de servicio objetivo total de invocaciones por segundo. EventBridge seguirá intentando entregar eventos que coincidan con reglas restringidas y lo volverá a intentar en un plazo máximo de 24 horas o según se describe en la política de reintentos personalizada del objetivo. Puede detectar y activar las reglas limitadas mediante la métrica `ThrottledRules`
+ En los casos de uso de baja latencia, también puede supervisar la latencia mediante `IngestionToInvocationStartLatency`, que proporciona una indicación del estado del bus de eventos. Cualquier período prolongado de alta latencia de más de 30 segundos puede indicar una interrupción del servicio o una limitación de las reglas.
# Uso de AWS Serverless Application Model plantillas para implementar EventBridge los recursos de Amazon
Puede crear y probar [reglas](eb-rules.md) manualmente en la EventBridge consola, lo que puede ayudar en el proceso de desarrollo a medida que refina [los patrones de eventos](eb-event-patterns.md). Sin embargo, una vez que esté preparado para implementar su aplicación, será más fácil utilizar un marco como [AWS SAM](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/what-is-sam.html) para lanzar todos los recursos sin servidor de forma coherente.
Usaremos esta [aplicación de ejemplo](https://github.com/aws-samples/amazon-eventbridge-producer-consumer-example) para analizar las formas en que puedes usar AWS SAM las plantillas para crear EventBridge recursos. El archivo template.yaml de este ejemplo es una AWS SAM plantilla que define cuatro [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)funciones y muestra dos formas diferentes de integrar las funciones de Lambda con. EventBridge
Para ver esta aplicación de ejemplo, consulte [Tutorial: Creación de una aplicación de muestra de Amazon EventBridge](eb-tutorial-get-started.md).
Existen dos enfoques de uso de las plantillas. EventBridge AWS SAM Para integraciones sencillas en las que una sola regla invoca una función de Lambda, se recomienda el método de **Plantilla combinada**. Si tiene una lógica de enrutamiento compleja o se está conectando a recursos externos a su AWS SAM plantilla, el enfoque de **plantillas separadas** es la mejor opción.
**Topics**
+ [Plantilla combinada](#eb-combined-template)
+ [Plantilla separada](#eb-separated-template)
## Plantilla combinada
El primer enfoque utiliza la `Events` propiedad para configurar la EventBridge regla. El siguiente código de ejemplo define un [evento](eb-events.md) que invoca la función de Lambda.
**nota**
En este ejemplo, se crea automáticamente la regla en el [bus de eventos](eb-event-bus.md) predeterminado, que existe en todas las AWS cuentas. Para asociar la regla a un bus de eventos personalizado, puede el `EventBusName` a la plantilla.
```
atmConsumerCase3Fn:
Type: AWS::Serverless::Function
Properties:
CodeUri: atmConsumer/
Handler: handler.case3Handler
Runtime: nodejs12.x
Events:
Trigger:
Type: CloudWatchEvent
Properties:
Pattern:
source:
- custom.myATMapp
detail-type:
- transaction
detail:
result:
- "anything-but": "approved"
```
Este código YAML equivale a un patrón de eventos de la EventBridge consola. En YAML, solo necesitas definir el patrón de eventos y crear AWS SAM automáticamente un rol de IAM con los permisos necesarios.
## Plantilla separada
En el segundo enfoque para definir una EventBridge configuración en AWS SAM, los recursos se separan más claramente en la plantilla.
1. En primer lugar, defina la función de Lambda:
```
atmConsumerCase1Fn:
Type: AWS::Serverless::Function
Properties:
CodeUri: atmConsumer/
Handler: handler.case1Handler
Runtime: nodejs12.x
```
1. A continuación, defina la regla mediante un recurso de `AWS::Events::Rule`. Las propiedades definen el patrón de eventos y también pueden especificar [destinos](eb-targets.md). Puede definir varios destino de forma explícita.
```
EventRuleCase1:
Type: AWS::Events::Rule
Properties:
Description: "Approved transactions"
EventPattern:
source:
- "custom.myATMapp"
detail-type:
- transaction
detail:
result:
- "approved"
State: "ENABLED"
Targets:
-
Arn:
Fn::GetAtt:
- "atmConsumerCase1Fn"
- "Arn"
Id: "atmConsumerTarget1"
```
1. Por último, defina un `AWS::Lambda::Permission` recurso que conceda permiso EventBridge para invocar el destino.
```
PermissionForEventsToInvokeLambda:
Type: AWS::Lambda::Permission
Properties:
FunctionName:
Ref: "atmConsumerCase1Fn"
Action: "lambda:InvokeFunction"
Principal: "events.amazonaws.com"
SourceArn:
Fn::GetAtt:
- "EventRuleCase1"
- "Arn"
```
# Generar una AWS CloudFormation plantilla a partir de una regla existente EventBridge
AWS CloudFormation le permite configurar y administrar sus AWS recursos en todas las cuentas y regiones de forma centralizada y repetible al tratar la infraestructura como un código. CloudFormation lo hace permitiéndole crear *plantillas* que definen los recursos que desea aprovisionar y administrar.
EventBridge le permite generar plantillas a partir de las reglas existentes en su cuenta, como ayuda para empezar a desarrollar CloudFormation plantillas con rapidez. Puede seleccionar una sola regla o varias reglas para incluirlas en la plantilla. A continuación, puede utilizar estas plantillas como base para [crear pilas](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) de recursos gestionados CloudFormation .
Para obtener más información, CloudFormation consulte la [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).
**nota**
EventBridge no incluye [reglas administradas](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) en la plantilla generada.
También puede [generar una plantilla a partir de un bus de eventos existente](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-generate-event-bus-template.html), incluidas las reglas que contiene el bus de eventos.
**Para generar una CloudFormation plantilla a partir de una o más reglas**
1. Abre la EventBridge consola de Amazon en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. En el panel de navegación, seleccione **Reglas**.
1. En **Seleccionar bus de eventos**, elija el bus de eventos que contenga las reglas que desee incluir en la plantilla.
1. En **Reglas**, elige las reglas que deseas incluir en la CloudFormation plantilla generada.
Para una sola regla, también puede elegir el nombre de la regla para mostrar la página de detalles de la regla.
1. Elige **CloudFormation Plantilla** y, a continuación, elige el formato en el que EventBridge quieres generar la plantilla: **JSON** o **YAML.**
EventBridge muestra la plantilla, generada en el formato seleccionado.
1. EventBridge le da la opción de descargar el archivo de plantilla o copiar la plantilla al portapapeles.
+ Seleccione **Descargar** para descargar el archivo de plantilla.
+ Para copiar la plantilla al portapapeles, seleccione **Copiar**.
1. Para salir de la plantilla, seleccione **Cancelar**.
Una vez que hayas personalizado la CloudFormation plantilla según sea necesario para tu caso de uso, podrás utilizarla para [crear pilas](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html). CloudFormation
## Consideraciones a la hora de utilizar CloudFormation plantillas generadas desde Amazon EventBridge
Ten en cuenta los siguientes factores cuando utilices una CloudFormation plantilla que hayas generado EventBridge:
+ EventBridge no incluye ninguna contraseña en la plantilla de generación.
Puede editar la plantilla para incluir [parámetros de plantilla](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html) que permitan a los usuarios especificar contraseñas u otra información confidencial al utilizar la plantilla para crear o actualizar una pila de CloudFormation.
Además, los usuarios pueden usar Secrets Manager para crear un secreto en la región deseada y, a continuación, editar la plantilla generada para emplear [parámetros dinámicos](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html#dynamic-references-secretsmanager).
+ Los destinos de la plantilla generada permanecen exactamente como se especificaron en el bus de eventos original. Esto puede provocar problemas entre regiones si no se edita correctamente la plantilla antes de utilizarla para crear pilas en otras regiones.
Además, la plantilla generada no crea automáticamente los destinos descendentes.