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 est différente selon que vous utilisez la CloudWatch console pour créer le canary ou AWS CLI or AWS SDKs. Lorsque vous utilisez la console, vous spécifiez uniquement les cinq premiers champs. Lorsque vous utilisez le AWS CLI or AWS SDKs, vous spécifiez les six champs, et vous devez spécifier * pour le Year champ.

Champ	Valeurs autorisées	Caractères spéciaux autorisés
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 SUN - SAT	, - * ? L #
Année	*

Caractères spéciaux

• Le caractère spécial , (virgule) inclut plusieurs valeurs dans l'expression d'un champ. Par exemple, dans le champ Mois, JANFEB, MAR inclurait les mois de 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 ay-of-week champs D ay-of-month et D 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 entrez 7 dans le ay-of-month champ D et que vous ne vous souciez pas du jour de la semaine le septième, pouvez-vous participer ? dans le ay-of-week champ D.

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

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

• Le caractère générique # dans le ay-of-week champ D indique une certaine instance du jour de la semaine spécifié dans un délai d'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 ay-of-week champs D ay-of-month et D dans 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 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 présentent la syntaxe correcte pour utiliser le AWS CLI or AWS SDKspour créer ou mettre à jour un canari. Si vous utilisez la CloudWatch console, omettez le final * dans chaque exemple.

Expression	Signification
0 10 * * ? *	Courez à 10 h (UTC) tous les jours
15 12 * * ? *	Courez à 12 h 15 (UTC) tous les jours
0 18 ? * MON-FRI *	Ouvert à 18 h 00 (UTC) du lundi au vendredi
0 8 1 * ? *	Courez à 8 h 00 (UTC) le premier jour de chaque mois
0/10 * ? * MON-SAT *	Exécuter toutes les 10 minutes du lundi au samedi de chaque semaine
0/5 8-17 ? * MON-FRI *	Ouvert toutes les cinq minutes du lundi au vendredi entre 8 h 00 et 17 h 55 () UTC