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 un tipo di istanza del broker Amazon MQ Aggiornamento del tipo di istanza **Importante** `mq.m7g.x`le istanze sono disponibili solo per i broker Amazon MQ for RabbitMQ. I broker Amazon MQ for ActiveMQ utilizzano solo istanze. `mq.m5.x` La descrizione combinata della classe dell'istanza del broker (`m7g`) e della dimensione (`large`) è denominata tipo di istanza del broker (ad esempio,). `mq.m7g.large` Quando si sceglie un tipo di istanza, è importante considerare i fattori che influiranno sulle prestazioni del broker: + il numero di client e di code + il volume dei messaggi inviati + messaggi conservati in memoria + messaggi ridondanti I tipi di istanze di broker più piccoli (`mq.m7g.medium`) sono consigliati solo per testare le prestazioni delle applicazioni. Consigliamo tipi di istanze broker più grandi (`mq.m7g.large `e superiori) per livelli di produzione di client e code, throughput elevato, messaggi in memoria e messaggi ridondanti. Ti consigliamo di passare a un tipo di istanza più grande (ad esempio from `micro` to`large`) se riscontri problemi di prestazioni o se stai passando da un ambiente di test a un ambiente di produzione. Per aggiornare il tipo di istanza, puoi utilizzare l' Console di gestione AWS AWS CLI, o l'API Amazon MQ. ## Console di gestione AWS **Per eseguire l'aggiornamento a un tipo di istanza più grande utilizzando il Console di gestione AWS, procedi come segue:** 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 **Specifiche**, per **Tipo di istanza Broker** scegli il nuovo tipo di istanza dall'elenco a discesa. 1. Nella parte inferiore della pagina, scegli **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. + Scegli **Dopo il prossimo riavvio**, se desideri che Amazon MQ completi l'aggiornamento durante la successiva finestra di manutenzione programmata. + Scegli **Immediatamente** se desideri riavviare il broker e aggiornare immediatamente il tipo di istanza. **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 il tipo di istanza di un broker utilizzando il AWS CLI** 1. Utilizzate il comando [CLI modify-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/update-broker.html) e specificate i seguenti parametri, come mostrato nell'esempio. + `--broker-id`: ID univoco che Amazon MQ genera per il broker. + `--host-instance-type`: numero di versione del motore del broker a cui effettuare l'aggiornamento. ``` aws mq modify-broker --broker-id broker-id --host-instance-type instance-type ``` 1. (Facoltativo) Utilizza il comando CLI [reboot-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/reboot-broker.html) per riavviare il broker se desideri aggiornare immediatamente il tipo di istanza. ``` 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 **Per aggiornare il tipo di istanza di un broker utilizzando l'API 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: Mon, 7 June 2021 12:00:00 GMT x-amz-date: Mon, 7 June 2021 12:00:00 GMT Authorization: authorization-string ``` Utilizzalo `host-instance-type` nel payload della richiesta per specificare il tipo di istanza a cui il broker deve effettuare l'upgrade. ``` { "host-instance-type": "host-instance-type" } ``` 1. (Facoltativo) Utilizzate 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 desiderate 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.