Opzioni di pianificazione e periodo attivo per la finestra di manutenzione

Quando si crea una finestra di manutenzione, è necessario specificare la frequenza con la quale viene eseguita utilizzando un'espressione Cron o Rate. Facoltativamente, puoi specificare un intervallo di date durante il quale la finestra di manutenzione può essere eseguita in base alla pianificazione periodica, nonché un fuso orario sul quale basare la pianificazione periodica.

Tieni tuttavia presente che l'opzione relativa al fuso orario e le opzioni relative a data di inizio e fine non si influenzano a vicenda. Qualsiasi data/ora di inizio e fine specificata (con o senza un offset per il fuso orario) determina solo il periodo di validità durante il quale la finestra di manutenzione può essere eseguita in base alla pianificazione. Un'opzione relativa al fuso orario determina il fuso orario internazionale sul quale è basata la pianificazione per la finestra di manutenzione durante il suo periodo di validità.

Nota

Le date di inizio e fine devono essere specificate nel formato timestamp ISO-8601. Ad esempio: 2021-04-07T14:29:00-08:00

I fusi orari devono essere specificati nel formato IANA (Internet Assigned Numbers Authority). Ad esempio: America/Chicago, Europe/Berlin o Asia/Tokyo

Esempio 1: specificare la data di inizio di una finestra di manutenzione

Supponiamo che si utilizzi AWS Command Line Interface (AWS CLI) per creare una finestra di manutenzione con le seguenti opzioni:

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

• --schedule-timezone "America/Los_Angeles"

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

Ad esempio:

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

In questo caso, il primo utilizzo della finestra di manutenzione si verificherà solo dopo la data e l'ora di inizio specificate, che corrispondono alle 12:00 (fuso orario Stati Uniti/Pacifico) di venerdì 1° gennaio 2021, ovvero otto ore indietro rispetto all'orario UTC. In questo caso, la data e l'ora di inizio del periodo della finestra non rappresentano la prima esecuzione delle finestre di manutenzione. Complessivamente, i valori --schedule-timezone e --schedule indicano che la finestra di manutenzione verrà eseguita alle 09:00 di ogni mercoledì, in base al fuso orario Stati Uniti/Pacifico (rappresentato da "America/Los Angeles" nel formato IANA). La prima esecuzione nel periodo consentito avverrà mercoledì 4 gennaio 2021, alle 9:00 (fuso orario Stati Uniti/Pacifico).

Esempio 2: specificare una data di inizio e fine di una finestra di manutenzione

Supponiamo che in seguito si crei una finestra di manutenzione con queste opzioni:

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

Ad esempio:

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

Il periodo consentito per questa finestra di manutenzione inizia alle 03:15 del 1° gennaio 2019, nel fuso orario standard del Giappone. Il periodo valido per questa finestra di manutenzione termina alle 06:15 di domenica 30 giugno 2019, nel fuso orario standard del Giappone. ovvero nove ore in avanti rispetto all'ora UTC. Complessivamente i valori --schedule-timezone e --schedule indicano che la finestra di manutenzione verrà eseguita alle 03:15 ogni martedì, in base al fuso orario standard del Giappone (rappresentato da "Asia/Tokyo" nel formato IANA). Ciò è dovuto al fatto che la finestra di manutenzione viene eseguita ogni sette giorni e diventa attiva alle 03:15 di martedì 1° gennaio. L'ultima esecuzione sarà alle 03:15 del 25 giugno 2019, nel fuso orario standard del Giappone. Questo è l'ultimo martedì prima che il periodo della finestra di manutenzione consentita termini cinque giorni più tardi.

Esempio 3: creare una finestra di manutenzione che viene eseguita solo una volta

Ora è possibile creare una finestra di manutenzione con questa opzione:

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

Ad esempio:

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

Questa finestra di manutenzione viene eseguita solo una volta, alle ore 15:55 UTC del 7 luglio 2020. La finestra di manutenzione è abilitata per essere eseguita fino a cinque ore, a seconda delle esigenze, ma le nuove attività non possono iniziare due ore prima della fine del periodo di finestra di manutenzione.

Esempio 4: specificare il numero di giorni di offset di pianificazione per una finestra di manutenzione

Ora è possibile creare una finestra di manutenzione con questa opzione:

--schedule-offset 2

Ad esempio:

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 offset di pianificazione è il numero di giorni di attesa dopo la data e l'ora specificate da un'espressione CRON per l'avvio dell'esecuzione della finestra di manutenzione.

Nell'esempio precedente, l'espressione CRON pianifica l'esecuzione di una finestra di manutenzione il terzo martedì di ogni mese alle 23:30:

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

Tuttavia, includendo --schedule-offset 2, la finestra di manutenzione verrà eseguita due giorni dopo il terzo martedì di ogni mese alle 23:30.

Gli offset di pianificazione sono supportati solo per le espressioni CRON.

Ulteriori informazioni

• Riferimento: espressioni Cron e Rate per Systems Manager

• Creazione di una finestra di manutenzione (console).

• Tutorial: creazione e configurazione di una finestra di manutenzione (AWS CLI)

• CreateMaintenanceWindow in AWS Systems Manager API Reference

• create-maintenance-window nella sezione AWS Systems Manager della Guida di riferimento ai comandi AWS CLI

• Time Zone Database sul sito Web IANA