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 una versión del motor del agente de Amazon MQ
Amazon MQ proporciona habitualmente nuevas versiones de motor de agente para todos los tipos de motores de agente compatibles. Las nuevas versiones de motor incluyen parches de seguridad, correcciones de errores y otras mejoras del motor del agente.
Amazon MQ organiza los números de versión según la especificación semántica del control de versiones como `X.Y.Z`. En las implementaciones de Amazon MQ, `X` indica la versión principal, `Y` representa el número de versión secundaria y `Z` hace referencia al número de versión del parche. Amazon MQ admite dos tipos de actualizaciones:
+ **Actualización de versión principal**: se produce cuando cambian los números de la versión de motor principal. Por ejemplo, la actualización de la versión **3.13** de RabbitMQ a la versión **4.2** se considera una actualización de la versión principal.
+ **Actualización de versión secundaria**: se produce cuando solo cambia el número de la versión de motor secundaria. Por ejemplo, actualizar desde la versión 3. **11** a la versión 3. La versión **12** se considera una actualización de versión menor.
Puede actualizar manualmente su agente en cualquier momento a la siguiente versión principal o secundaria compatible. Amazon MQ gestiona la actualización a la última versión de parche compatible para todos los corredores durante el período de [mantenimiento](maintaining-brokers.md) programado. Las actualizaciones de las versiones, tanto manuales como automáticas, se producen durante el período de mantenimiento programado o después de [reiniciar el broker](amazon-mq-rebooting-broker.md). Amazon MQ actualiza su agente a la siguiente versión secundaria cuando la versión secundaria actual llega al fin del soporte.
## Actualización manual de la versión del motor
Puede actualizar la versión de motor de un bróker mediante la Consola de administración de AWS AWS CLI, la o la API de Amazon MQ.
### Consola de administración de AWS
**Para actualizar la versión de motor de un bróker mediante el Consola de administración de AWS**
1. En la página de detalles del agente, elija **Edit** (Editar).
1. Dentro de **Specifications** (Especificaciones), en **Broker engine version** (Versión de motor del agente), elija el número de la versión nueva de la lista desplegable.
1. Desplácese a 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 de versiones durante el próximo período de mantenimiento programado.
+ Seleccione **Immediately** (De inmediato) si desea reiniciar el agente y actualizar la versión del motor 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 la versión de motor de un bróker mediante el AWS CLI**
1. Use el comando [update-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. Puede consultar el ID a partir del ARN de su agente. Por ejemplo, si se le da el ARN `arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`, el ID del agente sería `b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`.
+ `--engine-version`: número de versión de motor al que se va a actualizar el motor del agente.
```
aws mq update-broker --broker-id {{broker-id}} --engine-version {{version-number}}
```
1. (Opcional) Utilice el comando CLI [reboot-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/reboot-broker.html) para reiniciar el broker si desea actualizar la versión del motor inmediatamente.
```
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 periodo 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 la versión de motor de un agente a través de la API de Amazon MQ**
1. Use 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 `engineVersion` en la carga de la solicitud para especificar el número de versión al que se va a actualizar el agente.
```
{
"engineVersion": "{{engine-version-number}}"
}
```
1. (Opcional) Utilice la operación de la [RebootBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id-reboot.html#RebootBroker)API para reiniciar el broker si desea actualizar la versión del motor de forma inmediata. `broker-id`se especifica 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 periodo 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.