Crear una regla de Amazon EventBridge que se ejecuta según una programación - Amazon EventBridge
Crear una regla que se ejecuta según una programación

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 una regla de Amazon EventBridge que se ejecuta según una programación

Una regla se puede ejecutar en respuesta a un evento o en determinados intervalos de tiempo. Por ejemplo, para ejecutar una función AWS Lambda periódicamente, puede crear una regla que se ejecute según una programación.

nota

El Programador de Amazon EventBridge es un programador sin servidor que le permite crear, ejecutar y administrar tareas desde un servicio administrado y centralizado. El programador de EventBridge es altamente personalizable y ofrece una escalabilidad mejorada en comparación con las reglas programadas de EventBridge, con un conjunto más amplio de operaciones de API y servicios de AWS de destino.

Se recomienda utilizar el Programador de EventBridge para invocar los destinos en una programación. Para obtener más información, consulte Usar el Programador de Amazon EventBridge con Amazon EventBridge.

En EventBridge, puede crear dos tipos de reglas programadas:

  • Reglas que se ejecutan con una frecuencia regular

    EventBridge ejecuta estas reglas a intervalos regulares; por ejemplo, cada 20 minutos.

    Para especificar la frecuencia de una regla programada, debe definir una expresión de frecuencia.

  • Reglas que se ejecutan en momentos concretos

    EventBridge ejecuta estas reglas a horas y fechas específicas; por ejemplo, a las 8:00 a.m. PST el primer lunes de cada mes.

    Para especificar la hora y las fechas en que se ejecuta una regla programada, debe definir una expresión cron.

Las expresiones de frecuencia son más sencillas de definir, mientras que las expresiones cron ofrecen un control detallado de la programación. Por ejemplo, con una expresión cron, puede definir una regla que se ejecute a una hora especificada de un determinado día de cada semana o mes. Por el contrario, las expresiones de frecuencia ejecutan una regla con una frecuencia regular, como una vez cada hora o una vez cada día.

Todos los eventos programados utilizan la zona horaria UTC+0 y la precisión mínima para una programación es de 1 minuto.

nota

EventBridge no proporciona precisión de segundo nivel en expresiones de programación. La mejor resolución al utilizar una expresión cron es 1 minuto. Debido a la naturaleza distribuida de EventBridge y los servicios de destino, puede producirse un retraso de varios segundos entre el momento en que la regla programada se activa y el momento en que el servicio de destino ejecuta el recurso de destino.

En el siguiente vídeo se ofrece una visión general de la programación de tareas:

Temas

Crear una regla que se ejecuta según una programación

En los pasos siguientes, se explica cómo crear una regla de EventBridge que se ejecuta según una programación regular.

nota

Puede crear reglas programadas utilizando solo el bus de eventos predeterminado.

Definir la regla

En primer lugar, escriba un nombre y la descripción de la regla para identificarla.

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, seleccione el bus de eventos predeterminado. Puede crear reglas programadas utilizando solo el bus de eventos predeterminado.

  6. Para que la regla surta efecto en cuanto la cree, asegúrese de que la opción Activar la regla en el bus de eventos seleccionado esté habilitada.

  7. En Tipo de regla, seleccione Programación.

    En este punto, puede elegir continuar con la creación de una regla que se ejecute según una programación o usar el Programador de Amazon EventBridge.

  8. Elija cómo quiere continuar:

    • Usar el Programador de Amazon EventBridge para crear su programación

      nota

      El Programador de Amazon EventBridge es un programador sin servidor que le permite crear, ejecutar y administrar tareas desde un servicio administrado y centralizado. Proporciona una funcionalidad de programación única y recurrente, independientemente de las reglas y los buses de eventos. El programador de EventBridge es altamente personalizable y ofrece una escalabilidad mejorada en comparación con las reglas programadas de EventBridge, con un conjunto más amplio de operaciones de API y servicios de AWS de destino.

      Se recomienda utilizar el Programador de EventBridge para invocar los destinos en una programación. Para obtener más información, consulte ¿Qué es el Programador de Amazon EventBridge? en la Guía del usuario del Programador de Amazon EventBridge.

      1. Seleccione Continuar en el Programador de EventBridge

        EventBridge abre la consola del Programador de EventBridge en la página Crear programación.

      2. Cree la programación en la consola del Programador de EventBridge.

    • Siga utilizando EventBridge para crear una regla programada para el bus de eventos predeterminado

      1. Seleccione Continuar para crear la regla.

Definir la programación

A continuación, defina el patrón de programación.

Para definir el patrón de programación

  1. En Patrón de programación, elija si desea que la programación se ejecute a una hora concreta o con una frecuencia regular:

    Specific time

    1. Seleccione Una programación detallada que se ejecute a una hora concreta, como las 8:00 a. m. PST el primer lunes de cada mes.

    2. En Expresión Cron, especifique los campos para definir la expresión cron que EventBridge debe utilizar para determinar cuándo ejecutar esta regla programada.

      Una vez que haya especificado todos los campos, EventBridge mostrará las diez fechas siguientes en las que EventBridge ejecutará esta regla programada. Puede elegir si desea mostrar esas fechas en UTC o en la zona horaria local.

      Para obtener más información sobre la creación de una expresión cron, consulte Referencia de expresiones cron.

    Regular rate

    1. Seleccione Una programación que se ejecute con una frecuencia regular, por ejemplo, cada 10 minutos.

    2. En Expresión de frecuencia, especifique los campos Valor y Unidad para definir la frecuencia con la que EventBridge debe ejecutar esta regla programada.

      Para obtener más información sobre la creación de una expresión de frecuencia, consulte Referencia de expresiones de frecuencia.

  2. Seleccione Siguiente.

Seleccionar los destinos

Elija uno o más destinos para recibir los eventos que coincidan con el patrón especificado. Los destino 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 el 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:

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

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.