

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à.

# Pianificazione della finestra di manutenzione per un broker Amazon MQ
<a name="maintaining-brokers"></a>

 Periodicamente, Amazon MQ esegue la manutenzione dell'hardware, del sistema operativo o del software del motore di un broker di messaggi durante la finestra di manutenzione. Ad esempio, se hai cambiato il tipo di istanza del broker, Amazon MQ applicherà le modifiche durante la successiva finestra di manutenzione programmata. La durata della manutenzione può durare fino a due ore a seconda delle operazioni pianificate per il tuo broker di messaggi. È possibile ridurre al minimo i tempi di inattività durante una finestra di manutenzione selezionando una modalità di implementazione del broker con elevata disponibilità su più zone di disponibilità (AZ). 

 Amazon MQ for ActiveMQ [fornisce](amazon-mq-broker-architecture.md#active-standby-broker-deployment) distribuzioni attive/in standby per un'elevata disponibilità. In active/standby modalità, Amazon MQ esegue le operazioni di manutenzione un'istanza alla volta e almeno un'istanza rimane disponibile. Inoltre, puoi configurare una [rete di broker](network-of-brokers.md) con finestre di manutenzione diverse nel corso della settimana. Amazon MQ for RabbitMQ fornisce le distribuzioni di [cluster](rabbitmq-broker-architecture.md#rabbitmq-broker-architecture-cluster) per l'alta disponibilità. Nelle implementazioni di cluster, Amazon MQ esegue le operazioni di manutenzione un nodo alla volta mantenendo almeno due nodi in esecuzione in ogni momento. 

 Quando crei il tuo broker per la prima volta, puoi pianificare la finestra di manutenzione in modo che si verifichi una volta alla settimana a un'ora specificata. È possibile regolare la finestra di manutenzione di un broker solo fino a quattro intervalli prima della prossima finestra di manutenzione pianificata. Una volta completata la finestra di manutenzione del broker, Amazon MQ reimposta il limite e puoi modificare nuovamente la pianificazione prima che si verifichi la finestra di manutenzione successiva. La disponibilità del broker non viene influenzata dalla regolazione della finestra di manutenzione del broker. 

 Per modificare la finestra di manutenzione del broker, puoi utilizzare l' Console di gestione AWS AWS CLI, la o l'API Amazon MQ. 

## Pianifica la finestra di manutenzione del broker utilizzando il Console di gestione AWS
<a name="maintaining-brokers-adjusting-maintenance-window-console"></a>

**Per modificare la finestra di manutenzione del broker utilizzando il Console di gestione AWS**

1. Accedere alla [console Amazon MQ](https://console.aws.amazon.com/amazon-mq/).

1. Nel pannello di navigazione a sinistra, scegli **Brokers** (broker) e quindi scegli dall'elenco il broker che desideri aggiornare.

1.  Nella pagina dei dettagli del broker, scegliere **Edit** (Modifica). 

1. In **Maintenance** (Manutenzione), eseguire queste operazioni.

   1.  Per **Start day** (Giorno di inizio) scegliere un giorno della settimana, ad esempio, **Sunday** (Domenica), dal menu a tendina. 

   1.  Per **Start time** (Ora di inizio), scegliere l'ora e i minuti del giorno che si desidera pianificare per la prossima finestra di manutenzione del broker, ad esempio,**12**:**00**. 
**Nota**  
 Le opzioni per **Start time** (Ora di inizio) sono configurate nel fuso orario UTC\+0. 

1. Quindi, seleziona **Modifiche alla pianificazione**. **Quindi scegli **Dopo il prossimo riavvio** o Immediatamente.** Scegliendo **Dopo il prossimo riavvio si** aggiornerà immediatamente la finestra di manutenzione senza riavviare il broker. Scegliendo **Immediatamente** si riavvierà immediatamente il broker.

1. Nella pagina dei dettagli del broker, in **Maintenance window** (Finestra di manutenzione), verificare che sia visualizzata la nuova pianificazione preferita.

## Pianifica la finestra di manutenzione del broker utilizzando il AWS CLI
<a name="maintaining-brokers-adjusting-maintenance-window-cli"></a>

**Per regolare la finestra di manutenzione del broker, utilizza il AWS CLI**

1.  Utilizzare il comando della CLI [update-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/update-broker.html) e specificare i parametri seguenti, come mostrato nell'esempio. 
   +  `--broker-id`: ID univoco che Amazon MQ genera per il broker. Puoi analizzare l'ID dall'ARN del broker. Ad esempio, con il seguente ARN, `arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`, l'ID del broker sarebbe `b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`. 
   +  `--maintenance-window-start-time`: parametri che determinano l'orario di inizio della finestra di manutenzione settimanale fornito nella seguente struttura. 
     + `DayOfWeek`: giorno della settimana, nella sintassi seguente: `MONDAY| TUESDAY | WEDNESDAY | THURSDAY | FRIDAY | SATURDAY | SUNDAY`
     + `TimeOfDay`: ora nel formato 24 ore.
     + `TimeZone`: (opzionale) fuso orario, nel formato paese/città o nel formato UTC. Impostato su UTC per impostazione predefinita.

   ```
   aws mq update-broker --broker-id {{broker-id}} \
   --maintenance-window-start-time DayOfWeek={{SUNDAY}},TimeOfDay={{13:00}},TimeZone={{America/Los_Angeles}}
   ```

1.  (Opzionale) Utilizzare il comando della CLI [describe-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/reboot-broker.html) per verificare che la finestra di manutenzione sia stata aggiornata correttamente. 

   ```
   aws mq describe-broker --broker-id {{broker-id}}
   ```

## Pianifica la finestra di manutenzione del broker utilizzando l'API Amazon MQ
<a name="maintaining-brokers-adjusting-maintenance-window-api"></a>

**Regolazione della finestra di manutenzione dell broker utilizzando l'API di Amazon MQ**

1.  Usa l'operazione API [UpdateBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#UpdateBroker). Specificare `broker-id`come parametro del percorso. Negli esempi seguenti si presuppone un broker nella regione `us-west-2`. Per ulteriori informazioni sugli endpoint Amazon MQ disponibili, consulta [Endpoint e quote Amazon MQ](https://docs.aws.amazon.com/general/latest/gr/amazon-mq.html#amazon-mq_region) nel. *Riferimenti generali di AWS* 

   ```
   PUT /v1/brokers/{{broker-id}} HTTP/1.1
   Host: mq.us-west-2.amazonaws.com
   Date: Wed, 7 July 2021 12:00:00 GMT
   x-amz-date: Wed, 7 July 2021 12:00:00 GMT
   Authorization: {{authorization-string}}
   ```

   Utilizzare il parametro `maintenanceWindowStartTime` e il tipo di risorsa[https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#brokers-broker-id-model-weeklystarttime](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#brokers-broker-id-model-weeklystarttime) nel payload della richiesta.

   ```
   {
   "maintenanceWindowStartTime": {
       "dayOfWeek": {{"SUNDAY"}},
       "timeZone": {{"America/Los_Angeles"}},
       "timeOfDay": {{"13:00"}}
     }
   }
   ```

1.  (Facoltativo) Utilizza l'operazione [DescribeBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#brokers-broker-id-http-methods)API per verificare che la finestra di manutenzione sia stata aggiornata correttamente. `broker-id`è specificato come parametro di percorso. 

   ```
   GET /v1/brokers/{{broker-id}} HTTP/1.1
   Host: mq.us-west-2.amazonaws.com
   Date: Wed, 7 July 2021 12:00:00 GMT
   x-amz-date: Wed, 7 July 2021 12:00:00 GMT
   Authorization: {{authorization-string}}
   ```