Crear una EventBridge regla de Amazon que se ejecute según un cronograma - Amazon EventBridge
Cree una regla que se ejecute según un cronograma

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 EventBridge regla de Amazon que se ejecute según un cronograma

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

nota

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

Te recomendamos que utilices EventBridge Scheduler para invocar los objetivos según un cronograma. Para obtener más información, consulte Uso de Amazon EventBridge Scheduler con Amazon EventBridge.

En EventBridge, puede crear dos tipos de reglas programadas:

  • Reglas que se ejecutan a un ritmo regular

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

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

  • Reglas que se ejecutan en momentos específicos

    EventBridge ejecuta estas reglas en fechas y horas específicas; por ejemplo, a las 8:00 a.m. El primer lunes de cada mes (hora del Pacífico).

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

Las expresiones de velocidad 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 específica y un día determinado de cada semana o mes. Por el contrario, las expresiones de tasa ejecutan una regla a un ritmo normal, por ejemplo, una vez cada hora o una vez al día.

Todos los eventos programados utilizan la zona horaria UTC+0 y la precisión mínima de un horario es de un minuto.

nota

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

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

Temas

Cree una regla que se ejecute según un cronograma

En los pasos siguientes, se explica cómo crear una EventBridge regla que se ejecute de forma regular.

nota

Solo puede crear reglas programadas mediante el bus de eventos predeterminado.

Defina la regla

En primer lugar, introduzca un nombre y una descripción para la regla para identificarla.

Para definir los detalles de la regla

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

  2. En el panel de navegación, seleccione Rules (Reglas).

  3. Elija Create rule (Crear regla).

  4. Introduce un nombre y, si lo deseas, una descripción para la regla.

    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. Para el bus de eventos, elija el bus de eventos predeterminado. Solo puede crear reglas programadas utilizando el bus de eventos predeterminado.

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

  7. En Rule type (Tipo de regla), elija Schedule (Programación).

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

  8. Elija cómo quiere continuar:

    • Usa EventBridge Scheduler para crear tu horario

      nota

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

      Te recomendamos que utilices EventBridge Scheduler para invocar los objetivos según un cronograma. Para obtener más información, consulte ¿Qué es Amazon EventBridge Scheduler? en la Guía del usuario de Amazon EventBridge Scheduler.

      1. Selecciona Continuar en Scheduler EventBridge

        EventBridge abre la consola del EventBridge Scheduler en la página de creación de horarios.

      2. Cree la programación en la consola del EventBridge Scheduler.

    • Continúe EventBridge utilizándola para crear una regla programada para el bus de eventos predeterminado

      1. Seleccione Continuar para crear la regla.

Defina el cronograma

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

Para definir el patrón de programación

  1. En el patrón de programación, elija si desea que la programación se ejecute a una hora específica o a un ritmo regular:

    Specific time

    1. Elige un horario detallado que se ejecute a una hora específica, como las 8:00 a. m. El primer lunes de cada mes (hora del Pacífico).

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

      Una vez que haya especificado todos los campos, EventBridge muestra las diez fechas siguientes en las que se 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 cómo crear una expresión cron, consulteReferencia a expresiones cron.

    Regular rate

    1. Elija un horario que se ejecute a un ritmo regular, por ejemplo, cada 10 minutos.

    2. Para la expresión de velocidad, especifique los campos Valor y Unidad para definir la velocidad a la que se EventBridge debe ejecutar esta regla programada.

      Para obtener más información sobre cómo crear una expresión de velocidad, consulteReferencia de expresiones tarifarias.

  2. Elija Siguiente.

Seleccione los objetivos

Elija uno o más objetivos 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 los objetivos

  1. En Tipo de objetivo, elija uno de los siguientes tipos de objetivo:

    Event bus

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

    API destination

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

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

    • Para crear un nuevo destino de API, selecciona Crear un nuevo destino de API. A continuación, proporciona los siguientes detalles para el destino:

      • Nombre: introduzca un nombre para el destino.

        Los nombres deben ser únicos dentro de suCuenta de AWS. Los nombres pueden tener hasta 64 caracteres. Los caracteres válidos son A-Z, a-z, 0-9 y. _ - (guión).

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

        Las descripciones pueden tener hasta 512 caracteres.

      • Punto final de destino de la API: punto final de la URL del destino.

        La URL del punto final debe empezar porhttps. Puede incluir el comodín * como parámetro de ruta. Puede establecer los parámetros de ruta a partir del HttpParameters atributo del objetivo.

      • Método HTTP: seleccione el método HTTP utilizado al invocar el punto final.

      • (Opcional) Límite de velocidad 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 está establecido en 300.

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

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

        • Para crear una nueva conexión para este destino, seleccione Crear una nueva conexión 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 API.

    Servicio de AWS

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

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

      nota

      Los campos que se muestran varían según el servicio seleccionado. Para obtener más información sobre los objetivos disponibles, consulteObjetivos 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 la función de IAM necesaria para que se ejecute la regla.

    Para el rol de ejecución, realice una de las siguientes acciones:

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

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

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

    • Para usar una función 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 objetivo:

    Event bus

    (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. Haga una de las siguientes acciones:

    • Elija None (Ninguno) 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 Otorgar permisos a la cola de letra muerta.

    API destination

    1. (Opcional) En Configurar la 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 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.

        1. Seleccione Configurar el transformador de entrada.

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

    2. (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.

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

    3. (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. Haga una de las siguientes acciones:

      • Elija None (Ninguno) 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 Otorgar permisos a la cola de letra muerta.

    AWS service

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

    1. (Opcional) En Configurar la 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 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.

        1. Seleccione Configurar el transformador de entrada.

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

    2. (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.

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

    3. (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. Haga una de las siguientes acciones:

      • Elija None (Ninguno) 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 Otorgar permisos a la cola de letra muerta.

  4. (Opcional) Elija Add another target (Agregar otro destino) para agregar otro destino para esta regla.

  5. 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 Amazon EventBridge etiquetas.

  2. Elija Siguiente.

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

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