

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.

# Establecer un patrón de programación para las reglas programadas (antiguas) en Amazon EventBridge
<a name="eb-scheduled-rule-pattern"></a>

**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)*.

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 *frecuencia* para ejecutar la regla a intervalos regulares.

## Expresiones cron
<a name="eb-cron-expressions"></a>

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  |  , - \$1 /  | 
|  Horas  |  0-23  |  , - \$1 /  | 
|  D ay-of-month  |  1-31  |  , - \$1 ? / L W  | 
|  Mes  |  1-12 o JAN-DEC  |  , - \$1 /  | 
|  D ay-of-week  |  1-7 o SUN-SAT  |  , - \$1 ? L \$1  | 
|  Año  |  1970-2199  |  , - \$1 /  | 

**Caracteres comodín**
+ El carácter comodín **,** (coma) incluye valores adicionales. En el campo Mes, JAN, FEB, MAR incluiría 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 **\$1** (asterisco) incluye todos los valores del campo. En el campo Horas, **\$1** incluye cada hora. No puedes usar el **asterisco (\$1**) en Day-of-week los campos Day-of-month y. 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 Day-of-month campo puede escribir **7** y si cualquier día de la semana es aceptable, ¿puede escribir**?** en el Day-of-week campo.
+ El comodín **L** en los campos Day-of-month o Day-of-week especifica el último día del mes o de la semana.
+ El **W** comodín del Day-of-month campo especifica un día de la semana. En el Day-of-month campo, **3W** especifica el día de la semana más cercano al tercer día del mes.
+ El comodín **\$1** del Day-of-week campo especifica una instancia determinada del día de la semana especificado dentro de un mes. Por ejemplo, 3\$12 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 «\$1», 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 se pueden especificar los campos Day-of-month y Day-of-week en la misma expresión Cron. Si especifica un valor o un \$1 (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  |  \$1  |  \$1  |  ?  |  \$1  |  Ejecutar a las 10:00 h (UTC\$10) todos los días  | 
|  15  |  12  |  \$1  |  \$1  |  ?  |  \$1  |  Ejecutar a las 12:15 h (UTC\$10) todos los días  | 
|  0  |  18  |  ?  |  \$1  |  MON-FRI  |  \$1  |  Ejecutar a las 18:00 h (UTC\$10) de lunes a viernes  | 
|  0  |  8  |  1  |  \$1  |  ?  |  \$1  |  Ejecutar a las 8:00 h (UTC\$10) cada primer día del mes  | 
|  0/15  |  \$1  |  \$1  |  \$1  |  ?  |  \$1  |  Ejecutar cada 15 minutos  | 
|  0/10  |  \$1  |  ?  |  \$1  |  MON-FRI  |  \$1  |  Ejecutar cada 10 minutos de lunes a viernes  | 
|  0/5  |  8-17  |  ?  |  \$1  |  MON-FRI  |  \$1  |  Ejecutar cada 5 minutos de lunes a viernes entre las 8:00 y las 17:55 h (UTC\$10)  | 
|  0/30  |  20-2  |  ?  |  \$1  |  MON-FRI  |  \$1  |  Ejecutar cada 30 minutos de lunes a viernes, entre las 22:00 h del día de inicio y las 2:00 h del día siguiente (UTC) Ejecutar de 12:00 a 2:00 h el lunes por la mañana (UTC).  | 



En el siguiente ejemplo se crea una regla que se ejecuta cada día a las 12:00 h UTC\$10.

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

En el siguiente ejemplo se crea una regla que se ejecuta cada día a las 14:05 y a las 14:35 h UTC\$10.

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

El siguiente ejemplo crea una regla que se activa a las 10:15 UTC\$10 el último viernes de cada mes, entre los años 2019 y 2022.

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

## Expresiones de frecuencia
<a name="eb-rate-expressions"></a>

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 \$1 minutos \$1 hora \$1 horas \$1 día \$1 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**  
Los siguientes ejemplos muestran 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
```