Uso de expresiones cron y rate para programar reglas en Amazon EventBridge - Amazon EventBridge

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de expresiones cron y rate para programar reglas en Amazon EventBridge

Al crear una regla programada, puede EventBridge especificar un patrón de programación que determine cuándo se EventBridge ejecuta la regla:

  • Utilice una expresión cron para ejecutar la regla en fechas y horas específicas.

  • Utilice una expresión de velocidad para ejecutar la regla a intervalos regulares.

Expresiones cron

Las expresiones Cron tienen seis campos obligatorios, que están separados por un espacio en blanco.

Sintaxis

cron(fields)
Campo Valores Caracteres comodín

Minutos

0-59

, - * /

Horas

0-23

, - * /

D ay-of-month

1-31

, - * ? / L W

Mes

1-12 o - JAN DEC

, - * /

D ay-of-week

1-7 o SUN - SAT

, - * ? L #

Año

1970-2199

, - * /

Caracteres comodín
  • El carácter comodín , (coma) incluye valores adicionales. En el campo MesJAN,FEB, MAR incluye enero, febrero y marzo.

  • El carácter comodín - (guion) especifica los intervalos. En el campo Día, 1-15 incluiría los días del 1 al 15 del mes especificado.

  • El * (asterisco) incluye todos los valores del campo. En el campo Horas, * incluye cada hora. No puede usar * en los ay-of-week campos D ay-of-month y D. Si lo utiliza en uno, debe utilizar ? en el otro.

  • El comodín / (barra inclinada) especifica incrementos. En el campo Minutos, puede escribir 1/10 para especificar cada décimo minuto, empezando desde el primer minuto de la hora (por ejemplo, los minutos 11, 21 y 31, etc.).

  • El comodín ? (signo de interrogación) especifica uno u otro. En el ay-of-month campo D puede escribir 7 y si cualquier día de la semana es aceptable, ¿puede escribir? en el ay-of-week campo D.

  • El comodín L de los ay-of-week campos D ay-of-month o D especifica el último día del mes o de la semana.

  • El W comodín del ay-of-month campo D especifica un día de la semana. En el ay-of-month campo D, 3W especifica el día de la semana más cercano al tercer día del mes.

  • El comodín # en el ay-of-week campo D especifica una instancia determinada del día de la semana especificado dentro de un mes. Por ejemplo, 3#2 sería el segundo martes del mes: el número 3 hace referencia al martes, ya que es el tercer día de la semana en el calendario anglosajón, mientras que 2 hace referencia al segundo día de ese tipo dentro de un mes.

    nota

    Si utiliza el carácter «#», solo puede definir una expresión en el day-of-week campo. Por ejemplo, "3#1,6#3" no es válido porque se interpreta como dos expresiones.

Limitaciones
  • No puede especificar los ay-of-week campos D ay-of-month y D en la misma expresión cron. Si especifica un valor o un * (asterisco) en uno de los campos, debe utilizar un ? (signo de interrogación) en el otro.

  • No se admiten las expresiones Cron que conducen a frecuencias superiores a 1 minuto.

Ejemplos

Puede utilizar las siguientes cadenas cron de ejemplo al crear una regla con programa.

Minutos Horas Día del mes Mes Día de la semana Año Significado

0

10

*

*

?

*

Corre a las 10:00 a.m. (UTC+0) todos los días

15

12

*

*

?

*

Corre a las 12:15 p.m. (UTC+0) todos los días

0

18

?

*

MON-FRI

*

Corre a las 18:00 (UTC+0) de lunes a viernes

0

8

1

*

?

*

Corre a las 8:00 a.m. (UTC+0) el primer día del mes

0/15

*

*

*

?

*

Ejecutar cada 15 minutos

0/10

*

?

*

MON-FRI

*

Ejecutar cada 10 minutos de lunes a viernes

0/5

8-17

?

*

MON-FRI

*

Corre cada 5 minutos de lunes a viernes entre las 8:00 a.m. y las 17:55 p.m. (+0) UTC

0/30

20-2

?

*

MON-FRI

*

Corre cada 30 minutos de lunes a viernes, entre las 22:00 del día de inicio y las 2:00 del día siguiente () UTC

Corre de 12:00 a. m. a 2:00 a. m. el lunes por la mañana ()UTC.

En el siguiente ejemplo, se crea una regla que se ejecuta todos los días a las 12:00 UTC +0.

aws events put-rule --schedule-expression "cron(0 12 * * ? *)" --name MyRule1

En el siguiente ejemplo, se crea una regla que se ejecuta todos los días, a las 14:05 y 14:35 +0. UTC

aws events put-rule --schedule-expression "cron(5,35 14 * * ? *)" --name MyRule2

En el siguiente ejemplo, se crea una regla que se ejecuta a las 10:15 UTC +0 del último viernes de cada mes durante los años 2019 a 2022.

aws events put-rule --schedule-expression "cron(15 10 ? * 6L 2019-2022)" --name MyRule3

Expresiones de frecuencia

Una expresión de frecuencia comienza cuando se crea una regla de evento programado y, a continuación, se ejecuta en una programación definida.

Las expresiones de frecuencia tienen dos campos obligatorios, que están separados por un espacio en blanco.

Sintaxis

rate(value unit)
valor

Un número positivo.

unidad

La unidad de tiempo. Se requieren diferentes unidades para valores de 1, como minute, y valores superiores a 1, como minutes.

Valores válidos: minuto | minutos | hora | horas | día | días

Limitaciones

Si el valor es igual a 1, entonces la unidad debe ser singular. Si el valor es mayor que 1, la unidad debe ser plural. Por ejemplo, la frecuencia(1 horas) y la frecuencia(5 hora) no son válidas, pero la frecuencia(1 hora) y la frecuencia(5 horas) son válidas.

Ejemplos

En los siguientes ejemplos, se muestra cómo utilizar las expresiones de velocidad con el AWS CLI put-rule comando. El primer ejemplo activa la regla cada minuto, el siguiente ejemplo la activa cada cinco minutos, el tercer ejemplo la activa una vez cada hora y el último ejemplo la activa una vez al día.

aws events put-rule --schedule-expression "rate(1 minute)" --name MyRule2
aws events put-rule --schedule-expression "rate(5 minutes)" --name MyRule3
aws events put-rule --schedule-expression "rate(1 hour)" --name MyRule4
aws events put-rule --schedule-expression "rate(1 day)" --name MyRule5