• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la [documentazione di Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# 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 della frequenza](reference-cron-and-rate-expressions.md). 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`
**Topics**
+ [Esempio 1: specificare la data di inizio di una finestra di manutenzione](#schedule-example-start-date)
+ [Esempio 2: specificare una data di inizio e fine di una finestra di manutenzione](#schedule-example-start-end-date)
+ [Esempio 3: creare una finestra di manutenzione che viene eseguita solo una volta](#schedule-example-one-time)
+ [Esempio 4: specificare il numero di giorni di offset di pianificazione per una finestra di manutenzione](#schedule-example-schedule-offset)
## Esempio 1: specificare la data di inizio di una finestra di manutenzione
Supponiamo di utilizzare il 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 *)"`
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 della frequenza per Systems Manager](reference-cron-and-rate-expressions.md)
+ [Creare una finestra di manutenzione utilizzando la console](sysman-maintenance-create-mw.md)
+ [Tutorial: Creare e configurare una finestra di manutenzione utilizzando il AWS CLI](maintenance-windows-cli-tutorials-create.md)
+ [CreateMaintenanceWindow](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_CreateMaintenanceWindow.html) nel *Documentazione di riferimento API di AWS Systems Manager *
+ [https://docs.aws.amazon.com/cli/latest/reference/ssm/create-maintenance-window.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-maintenance-window.html)nella *AWS Systems Manager sezione del AWS CLI Command Reference*
+ [Time Zone Database](https://www.iana.org/time-zones) sul sito Web IANA