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à.
# Aggiornamento di una versione del motore del broker Amazon MQ
Amazon MQ fornisce regolarmente nuove versioni del motore di brokeraggio per tutti i tipi di motori di broker supportati. Le nuove versioni del motore includono patch di sicurezza, correzioni di bug e altri miglioramenti del motore del broker.
Amazon MQ organizza i numeri di versione in base alle specifiche di versioning semantico as. `X.Y.Z` Nelle implementazioni di Amazon MQ, `X` indica la versione principale, `Y` rappresenta la versione secondaria e `Z` indica il numero di versione della patch. Amazon MQ supporta due tipi di upgrade:
+ **Aggiornamento della versione principale**: si verifica quando cambiano i numeri della versione principale del motore. **Ad esempio, l'aggiornamento dalla versione **3.13** di RabbitMQ alla versione 4.2 è considerato un aggiornamento della versione principale.**
+ **Aggiornamento della versione secondaria**: si verifica quando cambiano i numeri della versione secondaria del motore. Ad esempio, l'aggiornamento dalla versione 3. **11** alla versione 3. **12** è considerato un aggiornamento secondario della versione.
Puoi aggiornare manualmente il tuo broker in qualsiasi momento alla successiva versione principale o secondaria supportata. Amazon MQ gestisce l'aggiornamento all'ultima versione di patch supportata per tutti i broker durante la [finestra di manutenzione](maintaining-brokers.md) programmata. Gli aggiornamenti di versione manuali e automatici avvengono durante la finestra di manutenzione programmata o dopo il [riavvio](amazon-mq-rebooting-broker.md) del broker. Amazon MQ aggiorna il tuo broker alla versione secondaria successiva quando la versione secondaria corrente raggiunge la fine del supporto.
## Aggiornamento manuale della versione del motore
Puoi aggiornare la versione del motore di un broker utilizzando l' Console di gestione AWS AWS CLI, la o l'API Amazon MQ.
### Console di gestione AWS
**Per aggiornare la versione del motore di un broker utilizzando il Console di gestione AWS**
1. Nella pagina dei dettagli del broker, scegliere **Edit** (Modifica).
1. In **Specifications** (Specifiche), per **Broker engine version** (Versione del motore del broker), scegliere il numero della nuova versione dall'elenco a discesa.
1. Scorrere fino alla parte inferiore della pagina e selezionare **Schedule modifications** (Pianifica modifiche).
1. Alla pagina **Schedule broker modifications** (Pianifica modifiche del broker), per **When to apply modifications** (Quando applicare le modifiche), scegliere una delle opzioni seguenti.
+ Scegliere **After the next reboot** (Al prossimo riavvio) se si desidera che Amazon MQ completi l'aggiornamento della versione durante la prossima finestra di manutenzione pianificata.
+ Scegliere **Immediately** (Subito), se si desidera riavviare il broker e aggiornare immediatamente la versione del motore.
**Importante**
I broker a istanza singola sono offline durante il riavvio. Per i broker di cluster, durante il riavvio del broker viene interrotto solo un nodo alla volta.
1. Scegliere **Apply** (Applica) per completare l'applicazione delle modifiche.
### AWS CLI
**Per aggiornare la versione del motore di un broker utilizzando 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`.
+ `--engine-version`: numero di versione del motore del broker a cui effettuare l'aggiornamento.
```
aws mq update-broker --broker-id broker-id --engine-version version-number
```
1. (Facoltativo) Utilizzate il comando CLI [reboot-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/reboot-broker.html) per riavviare il broker se desiderate aggiornare immediatamente la versione del motore.
```
aws mq reboot-broker --broker-id broker-id
```
Se non si desidera riavviare il broker e applicare immediatamente le modifiche, Amazon MQ aggiornerà il broker durante la prossima finestra di manutenzione pianificata.
**Importante**
I broker a istanza singola sono offline durante il riavvio. Per i broker di cluster, durante il riavvio del broker viene interrotto solo un nodo alla volta.
### API di Amazon MQ
**Aggiornamento della versione del motore di un broker tramite 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, consultare Quote ed endpoint di Amazon MQ in Riferimenti generali di .
```
PUT /v1/brokers/broker-id HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Mon, 7 June 2021 12:00:00 GMT
x-amz-date: Mon, 7 June 2021 12:00:00 GMT
Authorization: authorization-string
```
Utilizzare `engineVersion` nel payload della richiesta per specificare il numero di versione a cui eseguire l'aggiornamento del broker.
```
{
"engineVersion": "engine-version-number"
}
```
1. (Facoltativo) Utilizza l'operazione [RebootBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id-reboot.html#RebootBroker)API per riavviare il broker se desideri aggiornare immediatamente la versione del motore. `broker-id`è specificato come parametro di percorso.
```
POST /v1/brokers/broker-id/reboot-broker HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Mon, 7 June 2021 12:00:00 GMT
x-amz-date: Mon, 7 June 2021 12:00:00 GMT
Authorization: authorization-string
```
Se non si desidera riavviare il broker e applicare immediatamente le modifiche, Amazon MQ aggiornerà il broker durante la prossima finestra di manutenzione pianificata.
**Importante**
I broker a istanza singola sono offline durante il riavvio. Per i broker di cluster, durante il riavvio del broker viene interrotto solo un nodo alla volta.