Définition d'un modèle de planification pour les règles planifiées (anciennes) dans Amazon EventBridge - Amazon EventBridge
Expressions CronExpressions de fréquence

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Définition d'un modèle de planification pour les règles planifiées (anciennes) dans Amazon EventBridge

Note

Les règles planifiées sont une fonctionnalité héritée de EventBridge.

EventBridgepropose un moyen plus flexible et plus puissant de créer, exécuter et gérer des tâches planifiées de manière centralisée et à grande échelle : EventBridge Scheduler. Avec EventBridge Scheduler, vous pouvez créer des plannings à l'aide d'expressions cron et rate pour les modèles récurrents, ou configurer des appels ponctuels. Vous pouvez configurer des fenêtres de temps flexibles pour la livraison, définir des limites de nouvelles tentatives ainsi que la durée de conservation maximale pour les invocations d'API en échec.

Le planificateur est hautement personnalisable et offre une évolutivité améliorée par rapport aux règles planifiées, avec un ensemble plus large d'opérations et de services d'API cibles. AWS Nous vous recommandons d'utiliser le planificateur pour appeler des cibles selon un calendrier.

Pour plus d'informations, consultez le Créer une planification guide de l'utilisateur du EventBridge planificateur.

Lorsque vous créez une règle planifiée dans, EventBridge vous pouvez spécifier un modèle de planification qui détermine le moment où la règle est EventBridge exécutée :

  • Utilisez une expression cron pour exécuter la règle à des heures et à des dates spécifiques.

  • Utilisez une expression de taux pour exécuter la règle à intervalles réguliers.

Expressions Cron

Ces expressions se composent de six champs obligatoires qui sont séparés par des espaces.

Syntaxe

cron(fields)
Champ Valeurs Caractères génériques

Minutes

0-59

, - * /

Heures

0-23

, - * /

D ay-of-month

1-31

, - * ? / L W

Mois

1-12 ou JAN-DEC

, - * /

D ay-of-week

1-7 ou DIM-SAM

, - * ? L #

Année

1970-2199

, - * /
Caractères génériques

  • Le caractère générique , (virgule) inclut des valeurs supplémentaires. Dans le champ Month, JAN,FEB,MAR englobe January, February et March.

  • Le caractère générique - (tiret) spécifie des plages. Dans le champ Day, 1-15 englobe les jours 1 à 15 du mois spécifié.

  • Le caractère générique * (astérisque) inclut toutes les valeurs du champ. Dans le champ Hours (Heures), * inclut toutes les heures. Vous ne pouvez pas utiliser * à la fois dans les Day-of-week champs Day-of-month et. Si vous l'utilisez dans un champ, vous devez utiliser ? dans l'autre.

  • Le caractère générique / (barre oblique) spécifie les incréments. Dans le champ Minutes, vous pouvez entrer 1/10 pour spécifier toutes les dix minutes, à partir de la première minute de l'heure (par exemple, les 11e, 21e, 31e minutes, et ainsi de suite).

  • Le caractère générique ? (point d’interrogation) indique l’un ou l’autre. Dans le Day-of-month champ, vous pouvez saisir 7 et si un jour de la semaine vous convient, vous pouvez saisir ? sur le Day-of-week terrain.

  • Le caractère générique L dans les champs ou spécifie le dernier jour du mois ou de la semaine. Day-of-month Day-of-week

  • Le W caractère générique dans le Day-of-month champ indique un jour de la semaine. Dans le Day-of-month champ, 3W indique le jour de la semaine le plus proche du troisième jour du mois.

  • Le caractère générique # dans le Day-of-week champ indique une certaine instance du jour de la semaine spécifié dans un délai d'un mois. Par exemple, 3#2 correspond au deuxième mardi du mois : le 3 fait référence à mardi, car c’est le troisième jour de chaque semaine, et le 2 fait référence à la deuxième journée de ce type dans le mois.

    Note

    Si vous utilisez un caractère « # », vous ne pouvez définir qu'une seule expression dans le day-of-week champ. Par exemple, "3#1,6#3" n'est pas valide, car il est interprété comme deux expressions.

Limitations

  • Vous ne pouvez pas spécifier les champs Day-of-month et Day-of-week de la même expression cron. Si vous spécifiez une valeur ou le caractère * (astérisque) dans l’un de ces champs, vous devez utiliser le caractère ? (point d’interrogation) dans l’autre.

  • Les expressions cron qui entraînent des fréquences d'une rapidité supérieure à 1 minute ne sont pas prises en charge.

Exemples

Vous pouvez utiliser les exemples de chaînes cron suivants lorsque vous créez une règle avec planification.

Minutes Heures Jour du mois Mois Jour de la semaine Année Signification

0 USD

10

*

*

?

*

Exécution à 10 h 00 (UTC+0) tous les jours

15

12

*

*

?

*

Exécution à 12 h 15 (UTC+0) tous les jours

0

18

?

*

MON-FRI

*

Exécution à 18 h 00 (UTC+0) du lundi au vendredi

0

8

1

*

?

*

Exécution à 8 h 00 (UTC+0) chaque 1er jour du mois

0/15

*

*

*

?

*

Exécuter toutes les 15 minutes

0/10

*

?

*

MON-FRI

*

Exécuter toutes les 10 minutes du lundi au vendredi

0/5

8-17

?

*

MON-FRI

*

Exécution toutes les 5 minutes du lundi au vendredi entre 8 h 00 et 17 h 55 (UTC+0)

0/30

20-2

?

*

MON-FRI

*

Exécution toutes les 30 minutes du lundi au vendredi entre 22 h 00 le jour de départ et 2 h 00 le jour suivant (UTC)

Exécution de 00 h 00 à 2 h 00 le lundi matin (UTC).

L’exemple suivant crée une règle qui s’exécute tous les jours à 12 h 00 (UTC+0).

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

L’exemple suivant crée une règle qui s’exécute tous les jours à 14 h 05 et 14 h 35 (UTC+0).

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

L’exemple suivant crée une règle qui s’exécute à 10 h 15 (UTC+0) le dernier vendredi de chaque mois, pendant les années 2019 à 2022.

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

Expressions de fréquence

Une valeur de déclenchement démarre au moment où vous créez la règle d’événement planifiée, puis s’exécute selon un calendrier défini.

Les valeurs de déclenchement se composent de deux champs obligatoires séparés par des espaces.

Syntaxe

rate(value unit)
value

Nombre positif.

unité

Unité de temps. Des unités différentes sont nécessaires pour les valeurs de 1 (par exemple minute) et les valeurs supérieures à 1, (par exemple, minutes).

Valeurs valides : minute | minutes | heure | heures | jour | jours

Limitations

Si la valeur est égale à 1, l'unité doit être au singulier. Si la valeur est supérieure à 1, l’unité doit être au pluriel. Par exemple, rate(1 hours) et rate(5 hour) ne sont pas valides, mais rate(1 hour) et rate(5 hours) sont valides.

Exemples

Les exemples suivants montrent comment utiliser des expressions de débit avec la AWS CLI put-rule commande. Le premier exemple déclenche la règle toutes les minutes, le deuxième toutes les cinq minutes, le troisième une fois par heure et le quatrième une fois par jour.

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