Options de planification de la fenêtre de maintenance et de période active - AWS Systems Manager
Exemple 1 : Spécification d'une date de début de fenêtre de maintenanceExemple 2 : Spécification de la date de début et de la date de fin d'une fenêtre de maintenanceExemple 3 : Création d'une fenêtre de maintenance ne s'exécutant qu'une seule foisExemple 4 : Spécifiez le nombre de jours de décalage programmé pour une fenêtre de maintenance

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.

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 Internet Assigned Numbers Authority (IANA). Par exemple : America/Chicago, Europe/Berlin ou Asia/Tokyo

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

Supposons que vous utilisiez le 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 est en retard de huit UTC heures.) 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. Ensemble, les --schedule valeurs --schedule-timezone et signifient que la fenêtre de maintenance s'ouvre à 9 h tous les mercredis dans le fuseau horaire du Pacifique américain (représenté par « America/Los Angeles » dans le IANA format). 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 est neuf heures en UTC avance.) Ensemble, les --schedule valeurs --schedule-timezone et signifient que la fenêtre de maintenance s'exécute à 3 h 15 tous les mardis dans le fuseau horaire standard du Japon (représenté par « Asia/Tokyo » dans IANA le format). 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 ne fonctionne qu'une seule fois, à 15 h UTC 55 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 CRON expression avant d'exécuter la fenêtre de maintenance.

Dans l'exemple précédent, l'CRONexpression planifie une fenêtre de maintenance pour qu'elle s'exécute le troisième mardi de chaque mois à 23 h 30 : 

--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 ne sont pris en charge que pour les CRON expressions.

Plus d'informations