Options de planification de la fenêtre de maintenance et de période active

Lorsque vous créez une fenêtre de maintenance, vous devez spécifier la fréquence à laquelle celle-ci s'exécute à l'aide d'une expression Cron ou Rate. Si vous le souhaitez, vous pouvez spécifier une plage de dates pendant laquelle la fenêtre de maintenance peut s'exécuter conformément à une planification régulière, ainsi qu'un fuseau horaire sur lequel baser cette dernière.

Vous devez cependant savoir que l'option de fuseau horaire et les options de date de début et date de fin n'ont aucune influence les unes sur les autres. Toutes les dates de début et de fin que vous spécifiez (avec ou sans décalage par rapport à votre fuseau horaire) déterminent uniquement la période de validité pendant laquelle la fenêtre de maintenance peut s'exécuter aux dates et heures prévues. Une option de fuseau horaire détermine le fuseau horaire international sur lequel est basée la planification de la fenêtre de maintenance pendant sa période de validité.

Note

Vous spécifiez les dates de début et de fin au format d'horodatage ISO 8601. Par exemple : 2021-04-07T14:29:00-08:00

Vous spécifiez les fuseaux horaires au format IANA (Internet Assigned Numbers Authority). Par exemple : America/Chicago, Europe/Berlin ou Asia/Tokyo

Exemple 1 : Spécification d'une date de début de fenêtre de maintenance

Imaginons que vous utilisiez l'AWS Command Line Interface (AWS CLI) pour créer une fenêtre de maintenance avec les options suivantes :

• --start-date 2021-01-01T00:00:00-08:00

• --schedule-timezone "America/Los_Angeles"

• --schedule "cron(0 09 ? * WED *)"

Par exemple :

Linux & macOS

aws ssm create-maintenance-window \
    --name "My-LAX-Maintenance-Window" \
    --allow-unassociated-targets \
    --duration 3 \
    --cutoff 1 \
    --start-date 2021-01-01T00:00:00-08:00 \
    --schedule-timezone "America/Los_Angeles" \
    --schedule "cron(0 09 ? * WED *)"

Windows

aws ssm create-maintenance-window ^
    --name "My-LAX-Maintenance-Window" ^
    --allow-unassociated-targets ^
    --duration 3 ^
    --cutoff 1 ^
    --start-date 2021-01-01T00:00:00-08:00 ^
    --schedule-timezone "America/Los_Angeles" ^
    --schedule "cron(0 09 ? * WED *)"

Cela signifie que la première exécution de la fenêtre de maintenance n'aura lieu qu'après la date et l'heure de début spécifiées, c'est-à-dire le vendredi 1er janvier 2021 à minuit heure des États-Unis/Pacifique. (Ce fuseau horaire a huit heures de retard par rapport à l'heure UTC.) Dans ce cas, la date et l'heure de début de la période de fenêtre ne représentent pas le moment où les fenêtres de maintenance s'exécutent pour la première fois. Si l'on considère les deux valeurs ensemble, les valeurs --schedule-timezone et --schedule signifient que la fenêtre de maintenance démarrera à 9 heures tous les mercredis dans le fuseau horaire États-Unis/Pacifique (représenté par « America/Los Angeles » en format IANA). La première exécution durant la période d'activité aura lieu le mercredi 4 janvier 2021, à 9 heures, heure des États-Unis/Pacifique.

Exemple 2 : Spécification de la date de début et de la date de fin d'une fenêtre de maintenance

Supposons que vous créiez une fenêtre de maintenance avec les options suivantes :

• --start-date 2019-01-01T00:03:15+09:00

• --end-date 2019-06-30T00:06:15+09:00

• --schedule-timezone "Asia/Tokyo"

• --schedule "rate(7 days)"

Par exemple :

Linux & macOS

aws ssm create-maintenance-window \
    --name "My-NRT-Maintenance-Window" \
    --allow-unassociated-targets \
    --duration 3 \
    --cutoff 1 \
    --start-date 2019-01-01T00:03:15+09:00 \
    --end-date 2019-06-30T00:06:15+09:00 \
    --schedule-timezone "Asia/Tokyo" \
    --schedule "rate(7 days)"

Windows

aws ssm create-maintenance-window ^
    --name "My-NRT-Maintenance-Window" ^
    --allow-unassociated-targets ^
    --duration 3 ^
    --cutoff 1 ^
    --start-date 2019-01-01T00:03:15+09:00 ^
    --end-date 2019-06-30T00:06:15+09:00 ^
    --schedule-timezone "Asia/Tokyo" ^
    --schedule "rate(7 days)"

La période activée pour cette fenêtre de maintenance commence à 15 h 15, heure normale du Japon, le 1er janvier 2019. La période de validité de cette fenêtre de maintenance se termine à 6 h 15, heure normale du Japon, le dimanche 30 juin 2019. (Ce fuseau horaire à neuf heures d'avance par rapport à l'heure UTC.) Si l'on considère les deux valeurs ensemble, les valeurs --schedule-timezone et --schedule signifient que la fenêtre de maintenance s'exécutera à 3 h 15 tous les mardis dans le fuseau horaire standard du Japon (représenté par « Asia/Tokyo » en format IANA). Cela est dû au fait que la fenêtre de maintenance s'exécute tous les sept jours et qu'elle devient active à 3 h 15 le mardi 1er janvier. La dernière exécution aura lieu à 3 h 15, heure normale du Japon, le mardi 25 juin 2019. Il s'agit du dernier mardi avant que la période de la fenêtre de maintenance activée se termine cinq jours plus tard.

Exemple 3 : Création d'une fenêtre de maintenance ne s'exécutant qu'une seule fois

Vous avez à présent créé une fenêtre de maintenance avec cette option :

• --schedule "at(2020-07-07T15:55:00)"

Par exemple :

Linux & macOS

aws ssm create-maintenance-window \
    --name "My-One-Time-Maintenance-Window" \
    --schedule "at(2020-07-07T15:55:00)" \
    --duration 5 \
    --cutoff 2 \
    --allow-unassociated-targets

Windows

aws ssm create-maintenance-window ^
    --name "My-One-Time-Maintenance-Window" ^
    --schedule "at(2020-07-07T15:55:00)" ^
    --duration 5 ^
    --cutoff 2 ^
    --allow-unassociated-targets

Cette fenêtre de maintenance s'exécute une seule fois, à 15 h 55 (UTC), le 7 juillet 2020. La fenêtre de maintenance est activée pour s'exécuter pendant près de cinq heures, selon les besoins, mais aucune nouvelle tâche ne peut démarrer deux heures avant la fin de la période de la fenêtre de maintenance.

Exemple 4 : Spécifiez le nombre de jours de décalage programmé pour une fenêtre de maintenance

Vous avez à présent créé une fenêtre de maintenance avec cette option :

--schedule-offset 2

Par exemple :

Linux & macOS

aws ssm create-maintenance-window \
    --name "My-Cron-Offset-Maintenance-Window" \
    --schedule "cron(0 30 23 ? * TUE#3 *)" \
    --duration 4 \
    --cutoff 1 \
    --schedule-offset 2 \
    --allow-unassociated-targets

Windows

aws ssm create-maintenance-window ^
    --name "My-Cron-Offset-Maintenance-Window" ^
    --schedule "cron(0 30 23 ? * TUE#3 *)" ^
    --duration 4 ^
    --cutoff 1 ^
    --schedule-offset 2 ^
    --allow-unassociated-targets

Un décalage de planification est le nombre de jours à attendre après la date et l'heure spécifiées par une expression CRON avant d'exécuter la fenêtre de maintenance.

Dans l'exemple ci-dessus, l'expression CRON planifie une fenêtre de maintenance à exécuter le troisième mardi de chaque mois à 23h30 :

--schedule "cron(0 30 23 ? * TUE#3 *)

Cependant, l'inclusion de --schedule-offset 2 signifie que la fenêtre de maintenance ne sera pas exécutée avant 23h30 deux jours après le troisième mardi de chaque mois.

Les décalages de planification sont pris en charge uniquement pour les expressions CRON.

Plus d'informations

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

• Créer une fenêtre de maintenance (console)

• Didacticiel : Créer et configurer une fenêtre de maintenance (AWS CLI)

• CreateMaintenanceWindow dans la Référence d'API AWS Systems Manager

• create-maintenance-window dans la section AWS Systems Manager de la Référence des commandes AWS CLI

• Time Zone Database sur le site web de l'IANA