Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Actualización de un tipo de instancia del agente de Amazon MQ
**importante**
Las instancias `mq.m7g.x` solo están disponibles en Amazon MQ para agentes de RabbitMQ. Los agentes de Amazon MQ para ActiveMQ solo usan instancias `mq.m5.x`.
La descripción combinada de la instancia del agente clase (`m7g`) y tamaño (`large`) es un tipo de instancias del agente (por ejemplo, `mq.m7g.large`). Al elegir un tipo de instancia, es importante tener en cuenta los factores que afectarán al rendimiento del agente:
+ el número de clientes y colas
+ el volumen de mensajes enviados
+ mensajes guardados en la memoria
+ mensajes redundantes
Se recomienda usar los tipos de instancias de agente más pequeños (`mq.m7g.medium`) para probar el rendimiento de las aplicaciones. Asimismo, se aconsejan los tipos de instancias de agente más grandes (`mq.m7g.large ` o superiores) para los niveles de producción de clientes y colas, rendimientos altos, los mensajes en memoria y los mensajes redundantes.
Le recomendamos que actualice a un tipo de instancia mayor (es decir, de `micro` a `large`) si tiene problemas de rendimiento o si va a pasar de un entorno de pruebas a un entorno de producción. Para actualizar el tipo de instancia, puede usar la Consola de administración de AWS, la AWS CLI o la API de Amazon MQ.
## Consola de administración de AWS
**Para actualizar a un tipo de instancia más grande a través de la Consola de administración de AWS, haga lo siguiente:**
1. Inicie sesión en la [consola de Amazon MQ](https://console.aws.amazon.com/amazon-mq/).
1. En el panel de navegación izquierdo, elija **Brokers** (Agentes) y seleccione el agente que desea actualizar de la lista.
1. En la página de detalles del agente, elija **Edit** (Editar).
1. En **Specifications (Especificaciones)**, para el **tipo de instancia del agente**, elija el nuevo tipo de instancia en la lista desplegable.
1. En la parte inferior de la página y elija **Schedule modifications** (Programar modificaciones).
1. En la página **Schedule broker modifications**(Programar modificaciones del agente), para **When to apply modifications** (Cuándo aplicar modificaciones), elija una de las siguientes opciones.
+ Seleccione **After the next reboot** (Después del próximo reinicio) si desea que Amazon MQ complete la actualización durante el próximo período de mantenimiento programado.
+ Seleccione **Immediately** (De inmediato) si desea reiniciar el agente y actualizar el tipo de instancia inmediatamente.
**importante**
Los agentes de instancia única están desconectados mientras se reinician. En el caso de los agentes de clústeres, solo un nodo está inactivo a la vez mientras el agente se reinicia.
1. Seleccione **Apply** (Aplicar) para terminar de aplicar los cambios.
## AWS CLI
**Para actualizar el tipo de instancia de un agente a través de la AWS CLI**
1. Use el comando [modify-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/update-broker.html) de la CLI y especifique los siguientes parámetros, como se muestra en el ejemplo.
+ `--broker-id`: ID único que genera Amazon MQ para el agente.
+ `--host-instance-type`: número de versión de motor al que se va a actualizar el motor del agente.
```
aws mq modify-broker --broker-id {{broker-id}} --host-instance-type {{instance-type}}
```
1. (Opcional) Utilice el comando [reboot-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/reboot-broker.html) de la CLI para reiniciar su agente si desea actualizar el tipo de instancia de inmediato.
```
aws mq reboot-broker --broker-id {{broker-id}}
```
Si no desea reiniciar el agente y aplicar los cambios de inmediato, Amazon MQ lo actualizará durante el próximo período de mantenimiento programado.
**importante**
Los agentes de instancia única están desconectados mientras se reinician. En el caso de los agentes de clústeres, solo un nodo está inactivo a la vez mientras el agente se reinicia.
## API de Amazon MQ
**Para actualizar el tipo de instancia de un agente a través de la API de Amazon MQ**
1. Utilice la operación [UpdateBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#UpdateBroker) de la API. Especifique `broker-id` como parámetro de ruta. En los siguientes ejemplos, se asume que el agente está en la región `us-west-2`. Para obtener más información acerca de los puntos de conexión de Amazon MQ disponibles, consulte [cuotas y puntos de conexión de Amazon MQ](https://docs.aws.amazon.com/general/latest/gr/amazon-mq.html#amazon-mq_region) en *Referencia general de 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}}
```
Utilice `host-instance-type` en la carga útil de la solicitud para especificar el tipo de instancia al que se va a actualizar el agente.
```
{
"host-instance-type": "{{host-instance-type}}"
}
```
1. (Opcional) Utilice la operación [RebootBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id-reboot.html#RebootBroker) de la API para reiniciar su agente si desea actualizar la versión de motor de inmediato. Se especifica `broker-id` como parámetro de ruta.
```
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 no desea reiniciar el agente y aplicar los cambios de inmediato, Amazon MQ lo actualizará durante el próximo período de mantenimiento programado.
**importante**
Los agentes de instancia única están desconectados mientras se reinician. En el caso de los agentes de clústeres, solo un nodo está inactivo a la vez mientras el agente se reinicia.