Wartungsfenster-Optionen für Planung und aktive Zeiträume

Wenn Sie ein Wartungsfenster erstellen, müssen Sie angeben, wie oft das Wartungsfenster ausgeführt werden soll. Verwenden Sie dazu einen Cron- oder Rate-Ausdruck. Optional können Sie einen Datumsbereich angeben, in dem das Wartungsfenster nach seinem regulären Zeitplan laufen kann, sowie eine Zeitzone, auf der dieser reguläre Zeitplan basieren soll.

Beachten Sie jedoch, dass die Zeitzonenoption und die Optionen für Start- und Enddatum voneinander unabhängig sind. Das von Ihnen angegebene Start- und Enddatum (mit oder ohne einen Versatz für Ihre Zeitzone) bestimmt ausschließlich den gültigen Zeitraum, während dem das Wartungsfenster entsprechend seinem Zeitplan ausgeführt werden kann. Die Zeitzonenoption bestimmt die internationale Zeitzone, auf dessen Basis der Wartungsfenster-Zeitplan während seines gültigen Zeitraums ausgeführt wird.

Anmerkung

Sie geben das Start- und Enddatum im ISO-8601-Zeitstempelformat an. Zum Beispiel: 2021-04-07T14:29:00-08:00

Sie geben Zeitzonen in Internet Assigned Numbers Authority (IANA)-Format an. Beispiel: America/Chicago, Europe/Berlin oder Asia/Tokyo.

Beispiel 1: Angeben eines Startdatums für das Wartungsfenster

Angenommen, Sie verwenden die AWS Command Line Interface (AWS CLI) zum Erstellen eines Wartungsfensters mit den folgenden Optionen:

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

• --schedule-timezone "America/Los_Angeles"

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

Zum Beispiel:

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 *)"

Das bedeutet, dass der erste Durchlauf des Wartungsfensters erst nach dem angegebenen Startdatum und -zeitpunkt, d. h. am Freitag, dem 1. Januar 2021, um 12:00 Uhr US-Pazifikzeit, stattfinden wird. (Diese Zeitzone liegt acht Stunden hinter der UTC-Zeit.) In diesem Fall entsprechen das Startdatum und die Startzeit des Zeitfensters nicht dem Zeitpunkt, zu dem das Wartungsfenster zum ersten Mal läuft. Zusammen betrachtet bedeuten die Werte --schedule-timezone und --schedule, dass das Wartungsfenster jeden Mittwoch um 9:00 Uhr in der US Pacific-Zeitzone ausgeführt wird (angegeben durch "Amerika/Los Angeles" im IANA-Format). Die erste Ausführung im aktivierten Zeitraum erfolgt Mittwoch, 4. Januar 2021, um 9.00 Uhr US Pacific-Zeitzone.

Beispiel 2: Angeben eines Start- und Enddatums für das Wartungsfenster

In diesem Beispiel gehen wir davon aus, dass Sie als Nächstes ein Wartungsfenster mit diesen Optionen erstellen:

• --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)"

Zum Beispiel:

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)"

Der aktivierte Zeitraum für dieses Wartungsfenster beginnt am 1. Januar 2019 um 3:15 Uhr japanische Standardzeit. Der gültige Zeitraum für dieses Wartungsfenster endet am Sonntag, 30. Juni 2019 um 6:15 Uhr japanische Standardzeit. (Diese Zeitzone liegt neun Stunden vor der UTC-Zeit.) Zusammen betrachtet bedeuten die Werte --schedule-timezone und --schedule, dass das Wartungsfenster jeden Dienstag um 3:15 Uhr in der japanischen Standardzeitzone ausgeführt wird (angegeben durch "Asien/Tokio" im IANA-Format). Der Grund hierfür ist, dass das Wartungsfenster alle sieben Tage ausgeführt wird und am Dienstag, 1. Januar um 3:15 Uhr aktiv wird. Die letzte Ausführung erfolgt am Dienstag, 25. Juni 2019 um 3:15 Uhr japanische Standardzeit. Dies ist der letzte Dienstag bevor der aktivierte Zeitraum für das Wartungsfenster fünf Tage später endet.

Beispiel 3: Erstellen eines Wartungsfensters, das nur einmal ausgeführt wird

Jetzt erstellen Sie ein Wartungsfenster mit dieser Option:

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

Zum Beispiel:

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

Dieses Wartungsfenster wird nur einmal ausgeführt und zwar am 7. Juli 2020 um 15:55 Uhr UTC-Zeit. Das Wartungsfenster wurde aktiviert, um bei Bedarf bis zu fünf Stunden ausgeführt zu werden, jedoch können zwei Stunden vor dem Ende des Wartungsfensters keine neuen Aufgaben mehr gestartet werden.

Beispiel 4: Angeben der Anzahl der Zeitplanversatztage für ein Wartungsfenster

Jetzt erstellen Sie ein Wartungsfenster mit dieser Option:

--schedule-offset 2

Zum Beispiel:

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

Ein Zeitplanversatz ist die Anzahl der Tage, die nach dem über einen CRON-Ausdruck angegebenen Datum und der angegebenen Uhrzeit gewartet werden soll, bevor das Wartungsfenster ausgeführt wird.

Im vorhergegangenen Beispiel wird mit dem CRON-Ausdruck die Ausführung eines Wartungsfensters um 23.30 Uhr am dritten Dienstag jedes Monats geplant:

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

Die Einbeziehung von --schedule-offset 2 bedeutet allerdings, dass das Wartungsfenster erst um 23.30 Uhr zwei Tage nach dem dritten Dienstag jedes Monats ausgeführt wird.

Zeitplanversätze werden nur für CRON Ausdrücke unterstützt.

Weitere Informationen

• Referenz: Cron- und Rate-Ausdrücke für System Manager

• Erstellen eines Wartungsfensters (Konsole)

• Tutorial: Erstellen und Konfigurieren eines Wartungsfensters (AWS CLI)

• CreateMaintenanceWindow in der AWS Systems Manager-API-Referenz

• create-maintenance-window im Abschnitt AWS Systems Manager der AWS CLI-Befehlsreferenz

• Zeitzonendatenbank auf der IANA-Website