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.

Référence : Expressions Cron et Rate pour Systems Manager

Lorsque vous créez un State Manager association ou fenêtre de maintenance dans AWS Systems Manager, vous spécifiez un calendrier d'exécution de la fenêtre ou de l'association. Vous pouvez spécifier une planification sous la forme d'une entrée temporelle, appelée expression cron ou une entrée basée sur la fréquence appelée expression de fréquence.

Informations générales sur les expressions cron et rate

Les informations suivantes s'appliquent aux expressions cron et rate pour les fenêtres de maintenance et les associations.

Expressions cron et rate pour les associations

Cette section inclut des exemples d'expressions cron et rate pour State Manager associations. Avant de créer l'une de ces expressions, soyez conscient des informations suivantes :

Les associations prennent en charge les expressions cron qui incluent un jour de la semaine et le signe numérique (#) pour désigner le nième jour d'un mois pour diriger une association. Voici un exemple qui exécute un calendrier cron le troisième mardi de chaque mois à 23h30 : UTC

cron(30 23 ? * TUE#3 *)

Voici un exemple diffusé le deuxième jeudi de chaque mois à minuit UTC :

cron(0 0 ? * THU#2 *)

Les associations soutiennent également le signe (L) pour indiquer le dernier X jour du mois. Voici un exemple qui exécute un calendrier cron le dernier mardi de chaque mois à minuit UTC :

cron(0 0 ? * 3L *)

Pour contrôler davantage l'exécution d'une association, par exemple si vous souhaitez exécuter une association deux jours après le correctif mardi, vous pouvez spécifier un décalage. Un offset (décalage) définit le nombre de jours d'attente après le jour prévu pour exécuter une association. Par exemple, si vous avez spécifié une planification cron de cron(0 0 ? * THU#2 *), vous pouvez spécifier le numéro 3 dans le champ Schedule offset (Décalage de planification) pour exécuter l'association tous les dimanches après le deuxième jeudi du mois.

Pour utiliser des décalages, vous devez choisir le Apply association only at the next specified Cron interval (Appliquer l'association uniquement à l'intervalle Cron spécifié suivant) dans la console ou vous devez spécifier l'utilisation du paramètre --apply-only-at-cron-interval à partir de la ligne de commande. Cette option indique State Manager de ne pas lancer une association immédiatement après l'avoir créée.

Le tableau suivant présente des exemples d'expressions cron pour les associations.

Voici quelques exemples d'expressions rate pour les associations.

AWS CLI exemples pour les associations

Pour créer State Manager associations utilisant le AWS CLI, vous incluez le --schedule-expression paramètre dans une expression cron ou rate. Les exemples suivants utilisent le AWS CLI sur une machine Linux locale.

aws ssm create-association \
    --association-name "My-Cron-Association" \
    --schedule-expression "cron(0 2 ? * SUN *)" \
    --targets Key=tag:ServerRole,Values=WebServer \
    --name AWS-UpdateSSMAgent

aws ssm create-association \
    --association-name "My-Rate-Association" \
    --schedule-expression "rate(7 days)" \
    --targets Key=tag:ServerRole,Values=WebServer \
    --name AWS-UpdateSSMAgent

aws ssm create-association \
    --association-name "My-Rate-Association" \
    --schedule-expression "at(2020-07-07T15:55:00)" \
    --targets Key=tag:ServerRole,Values=WebServer \
    --name AWS-UpdateSSMAgent \
    --apply-only-at-cron-interval

Expressions cron et rate pour les fenêtres de maintenance

Cette section inclut des exemples d'expressions cron et rate pour les fenêtres de maintenance.

Contrairement State Manager associations, les fenêtres de maintenance supportent toutes les expressions cron et rate. Cela inclut la prise en charge des valeurs dans le champ secondes.

Par exemple, l'expression cron à 6 champs exécute une fenêtre de maintenance à 9 h 30 chaque jour.

cron(30 09 ? * * *)

Si l'on ajoute une valeur au champ Seconds, l'expression cron suivante à 7 champs exécute une fenêtre de maintenance tous les jours à 9 h 30 et 24 s.

cron(24 30 09 ? * * *)

Le tableau suivant fournit des exemples supplémentaires d'expressions cron à 6 champs pour les fenêtres de maintenance.

Le tableau suivant fournit des exemples rate pour les fenêtres de maintenance.

AWS CLI exemples de fenêtres de maintenance

Pour créer des fenêtres de maintenance à l'aide de AWS CLI, vous devez inclure le --schedule paramètre dans une expression cron ou rate ou un horodatage. Les exemples suivants utilisent le AWS CLI sur une machine Linux locale.

aws ssm create-maintenance-window \
    --name "My-Cron-Maintenance-Window" \
    --allow-unassociated-targets \
    --schedule "cron(0 16 ? * TUE *)" \
    --schedule-timezone "America/Los_Angeles" \
    --start-date 2021-01-01T00:00:00-08:00 \
    --end-date 2021-06-30T00:00:00-08:00 \
    --duration 4 \
    --cutoff 1

aws ssm create-maintenance-window \
    --name "My-Rate-Maintenance-Window" \
    --allow-unassociated-targets \
    --schedule "rate(7 days)" \
    --duration 4 \
    --schedule-timezone "America/Los_Angeles" \
    --cutoff 1

aws ssm create-maintenance-window \
    --name "My-TimeStamp-Maintenance-Window" \
    --allow-unassociated-targets \
    --schedule "at(2021-07-07T13:15:30)" \
    --duration 4 \
    --schedule-timezone "America/Los_Angeles" \
    --cutoff 1