Planification d'exécutions de scripts Canary à l'aide de cron - Amazon CloudWatch

Planification d'exécutions de scripts Canary à l'aide de cron

L'utilisation d'une expression cron vous donne de la flexibilité lorsque vous planifiez un script Canary. Les expressions cron contiennent cinq ou six champs dans l'ordre indiqué dans le tableau suivant. Les champs sont séparés par des espaces. La syntaxe diffère selon que vous utilisez la console CloudWatch pour créer le script Canary ou les kits SDK AWS CLI ou AWS. Lorsque vous utilisez la console, vous spécifiez uniquement les cinq premiers champs. Lorsque vous utilisez le kit SDK AWS CLI ou AWS, vous spécifiez les six champs et vous devez spécifier * pour le champ Year.

Champ Valeurs autorisées Caractères spéciaux autorisés

Minutes

0-59

, - * /

Heures

0-23

, - * /

Jour du mois

1-31

, - * ? / L W

Mois

1-12 ou JAN-DEC

, - * /

Jour de la semaine

1-7 ou DIM-SAM

, - * ? L #

Année

*

Caractères spéciaux

  • Le caractère spécial , (virgule) inclut plusieurs valeurs dans l'expression d'un champ. Dans le champ Month (Mois), JAN,FEB,MAR englobe janvier, février et mars.

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

  • Le caractère spécial * (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 champs Day-of-month (Jour du mois) et Day-of-week (Jour de la semaine) d'une même expression. Si vous l'utilisez dans un champ, vous devez utiliser ? dans l'autre.

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

  • Le caractère spécial ? (point d'interrogation) indique l'un ou l'autre. Si vous saisissez 7 dans le champ Day-of-month (Jour du mois) et que le jour de la semaine correspondant au 7e jour n'a pas d'importance, vous pouvez saisir ? dans le champ Day-of-week (Jour de la semaine).

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

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

  • Le caractère générique # dans le champ Jour de la semaine spécifie une certaine instance du jour de la semaine spécifié dans un mois. Par exemple, 3#2 est le deuxième mardi du mois. Le 3 fait référence au 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.

Limites

  • Vous ne pouvez pas spécifier les champs Jour du mois et Jour de la semaine dans une 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 un caractère ? (point d'interrogation) dans l'autre.

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

  • Vous ne pouvez pas configurer un script Canary pour qu'il attende plus d'un an avant son exécution. Vous ne pouvez donc spécifier que * dans le champ Year.

Exemples

Vous pouvez vous référer aux exemples de chaînes cron suivants lorsque vous créez un script Canary. Les exemples suivants sont la syntaxe correcte pour utiliser les kits SDK AWS CLI ou AWS pour créer ou mettre à jour un script Canary. Si vous utilisez la console CloudWatch, omettez le caractère * final dans chaque exemple.

Expression Signification

0 10 * * ? *

Exécuter à 10 h 00 (UTC) chaque jour

15 12 * * ? *

Exécuter à 12 h 15 (UTC) chaque jour

0 18 ? * MON-FRI *

Exécuter à 18 h 00 (UTC) du lundi au vendredi

0 8 1 * ? *

Exécuter à 8 h 00 (UTC) le premier jour du mois

0/10 * ? * MON-SAT *

Exécuter toutes les 10 minutes du lundi au samedi de chaque semaine

0/5 8-17 ? * MON-FRI *

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