Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Mise à niveau d'un type d'instance de courtier Amazon MQ
**Important**
`mq.m7g.x`les instances ne sont disponibles que pour Amazon MQ pour les courtiers RabbitMQ. Les courtiers Amazon MQ pour ActiveMQ utilisent uniquement des instances. `mq.m5.x`
La description combinée de la classe d'instance de courtier (`m7g`) et de la taille (`large`) est appelée type d'instance de courtier (par exemple,`mq.m7g.large`). Lorsque vous choisissez un type d'instance, il est important de prendre en compte les facteurs qui affecteront les performances du courtier :
+ le nombre de clients et de files d'attente
+ le volume de messages envoyés
+ messages conservés en mémoire
+ messages redondants
Les types d'instances de broker plus petits (`mq.m7g.medium`) sont recommandés uniquement pour tester les performances des applications. Nous recommandons des types d'instances de broker plus grands (`mq.m7g.large `et supérieurs) pour les niveaux de production des clients et des files d'attente, le débit élevé, les messages en mémoire et les messages redondants.
Nous vous recommandons de passer à un type d'instance plus important (c'est-à-dire de `micro` vers`large`) si vous rencontrez des problèmes de performances ou si vous passez d'un environnement de test à un environnement de production. Pour mettre à niveau votre type d'instance, vous pouvez utiliser l'API AWS Management Console AWS CLI, la ou l'API Amazon MQ.
## AWS Management Console
**Pour effectuer une mise à niveau vers un type d'instance plus important à l'aide du AWS Management Console, procédez comme suit :**
1. Connectez-vous à la [console Amazon MQ](https://console.aws.amazon.com/amazon-mq/).
1. Dans le panneau de navigation de gauche, choisissez**Brokers (Agents)**, puis choisissez l’agent que vous souhaitez mettre à niveau dans la liste.
1. Sur la page Details (Informations), choisissez **Edit (Modifier)**.
1. Sous **Spécifications**, pour le **type d'instance Broker**, choisissez le nouveau type d'instance dans la liste déroulante.
1. Au bas de la page, sélectionnez **Planifier les modifications**.
1. Dans la page **Schedule broker modifications (Planifier les modifications de l'agent)**, pour **When to apply modifications (Quand appliquer les modifications)**, choisissez l'une des options suivantes.
+ Choisissez **Après le prochain redémarrage**, si vous souhaitez qu'Amazon MQ termine la mise à niveau lors de la prochaine fenêtre de maintenance planifiée.
+ Choisissez **Immédiatement** si vous souhaitez redémarrer le broker et mettre à niveau le type d'instance immédiatement.
**Important**
Les courtiers à instance unique sont hors ligne lors du redémarrage. Pour les courtiers en clusters, un seul nœud est en panne à la fois lorsque le courtier redémarre.
1. Choisissez **Apply (Appliquer)**pour terminer l'application des modifications.
## AWS CLI
**Pour mettre à niveau le type d'instance d'un courtier à l'aide du AWS CLI**
1. Utilisez la commande [modify-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/update-broker.html) CLI et spécifiez les paramètres suivants, comme indiqué dans l'exemple.
+ `--broker-id` – ID unique généré par Amazon MQ pour l’agent.
+ `--host-instance-type` – Numéro de version du moteur de l'agent vers lequel effectuer la mise à niveau.
```
aws mq modify-broker --broker-id {{broker-id}} --host-instance-type {{instance-type}}
```
1. (Facultatif) Utilisez la commande CLI [reboot-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/reboot-broker.html) pour redémarrer votre courtier si vous souhaitez mettre à niveau le type d'instance immédiatement.
```
aws mq reboot-broker --broker-id {{broker-id}}
```
Si vous ne souhaitez pas redémarrer votre agent et appliquer les modifications immédiatement, Amazon MQ mettra à niveau l'agent au cours de la prochaine fenêtre de maintenance planifiée.
**Important**
Les courtiers à instance unique sont hors ligne lors du redémarrage. Pour les courtiers en clusters, un seul nœud est en panne à la fois lorsque le courtier redémarre.
## API Amazon MQ
**Pour mettre à niveau le type d'instance d'un broker à l'aide de l'API Amazon MQ**
1. Utilisez l'opération d'API [UpdateBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#UpdateBroker). Précisez `broker-id` comme un paramètre de chemin. Les exemples suivants supposent qu’un agent est dans la région `us-west-2`. Pour plus d'informations sur les points de terminaison Amazon MQ disponibles, consultez la section Points de terminaison et quotas [Amazon MQ](https://docs.aws.amazon.com/general/latest/gr/amazon-mq.html#amazon-mq_region) dans le. *Références générales 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}}
```
`host-instance-type`À utiliser dans la charge utile de la demande pour spécifier le type d'instance vers lequel le broker doit effectuer la mise à niveau.
```
{
"host-instance-type": "{{host-instance-type}}"
}
```
1. (Facultatif) Utilisez l'opération [RebootBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id-reboot.html#RebootBroker)API pour redémarrer votre broker, si vous souhaitez mettre à niveau la version du moteur immédiatement. `broker-id`est spécifié en tant que paramètre de chemin.
```
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}}
```
Si vous ne souhaitez pas redémarrer votre agent et appliquer les modifications immédiatement, Amazon MQ mettra à niveau l'agent au cours de la prochaine fenêtre de maintenance planifiée.
**Important**
Les courtiers à instance unique sont hors ligne lors du redémarrage. Pour les courtiers en clusters, un seul nœud est en panne à la fois lorsque le courtier redémarre.