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.
# Programación del período de mantenimiento de un agente de Amazon MQ
Amazon MQ realiza de forma periódica el mantenimiento del hardware, el sistema operativo o el software del motor de un agente de mensajes durante el período de mantenimiento. Por ejemplo, si cambió el tipo de instancias del agente, Amazon MQ aplicará los cambios durante el próximo periodo de mantenimiento programado. La duración del mantenimiento puede durar hasta dos horas, dependiendo de las operaciones programadas para el agente de mensajes. Puede minimizar el tiempo de inactividad durante un período de mantenimiento seleccionando un modo de implementación del agente con alta disponibilidad en varias zonas de disponibilidad (AZ).
Amazon MQ para ActiveMQ ofrece implementaciones de alta disponibilidad. [active/standby](amazon-mq-broker-architecture.md#active-standby-broker-deployment) En active/standby el modo, Amazon MQ realiza las operaciones de mantenimiento una instancia a la vez y permanece disponible al menos una instancia. Además, puede configurar una [red de agentes](network-of-brokers.md) con períodos de mantenimiento repartidos a lo largo de la semana. Amazon MQ para RabbitMQ proporciona implementaciones de [clúster](rabbitmq-broker-architecture.md#rabbitmq-broker-architecture-cluster) para alta disponibilidad. En las implementaciones de clúster, Amazon MQ realiza operaciones de mantenimiento a un nodo cada vez, manteniendo al menos dos nodos en funcionamiento en todo momento.
**nota**
Durante las operaciones de mantenimiento, Amazon MQ puede cancelar las instancias de intermediación existentes y lanzar nuevas instancias de reemplazo. En el caso de active/standby las implementaciones, las instancias se cancelan y se sustituyen de forma secuencial para mantener la disponibilidad de los agentes durante todo el período de mantenimiento. Los clientes conectados a la instancia activa pueden experimentar una breve conmutación por error a la instancia en espera durante este proceso.
Cuando se crea el agente por primera vez, puede programar que el período de mantenimiento se realice una vez por semana, a una hora determinada. Solo puede ajustar el período de mantenimiento de un agente hasta cuatro veces antes del próximo período de mantenimiento programado. Una vez completado el período de mantenimiento del agente, Amazon MQ restablece el límite, lo que le permite ajustar de nuevo la programación antes de que se produzca el siguiente período de mantenimiento. La disponibilidad del agente no se ve afectada al ajustar su período de mantenimiento.
Para ajustar el período de mantenimiento del agente, puede utilizar la Consola de administración de AWSAWS CLI, la o la API de Amazon MQ.
## Programe el período de mantenimiento del agente mediante elConsola de administración de AWS
**Para ajustar el período de mantenimiento del corredor mediante elConsola de administración de AWS**
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 **Maintenance** (Mantenimiento), haga lo siguiente.
1. En **Start day** (Día de inicio), elija un día de la semana, por ejemplo, **Sunday** (Domingo) en la lista desplegable.
1. En **Start time** (Hora de inicio), elija la hora y minuto del día que desea programar para el próximo período de mantenimiento del agente, por ejemplo, **12**:**00**.
**nota**
Las opciones de **hora de inicio** están configuradas en la zona horaria UTC\+0.
1. A continuación, seleccione **Programar modificaciones**. A continuación, seleccione **Después del siguiente reinicio** o **Inmediatamente**. Si selecciona **After the next reboot (Tras el siguiente reinicio)**, se actualizará inmediatamente el periodo de mantenimiento sin reiniciar el agente. Si selecciona **Inmediatamente**, el agente se reiniciará de inmediato.
1. En la página de detalles del agente, en **Maintenance window** (período de mantenimiento), compruebe que aparezca la nueva programación preferida.
## Programe el período de mantenimiento del corredor mediante elAWS CLI
**Para ajustar el período de mantenimiento del corredor mediante elAWS 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`.
+ `--maintenance-window-start-time`: parámetros que determinan la hora de inicio del período de mantenimiento semanal proporcionada en la siguiente estructura.
+ `DayOfWeek`: el día de la semana, en la siguiente sintaxis: `MONDAY| TUESDAY | WEDNESDAY | THURSDAY | FRIDAY | SATURDAY | SUNDAY`
+ `TimeOfDay`: la hora, en formato de 24 horas.
+ `TimeZone`— (Opcional) La zona horaria, en formato de desplazamiento UTC o UTC. Country/City De forma predeterminada, se configura en UTC.
```
aws mq update-broker --broker-id {{broker-id}} \
--maintenance-window-start-time DayOfWeek={{SUNDAY}},TimeOfDay={{13:00}},TimeZone={{America/Los_Angeles}}
```
1. (Opcional) Utilice el comando [describe-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/reboot-broker.html) de la CLI para comprobar que el período de mantenimiento se hay actualizado correctamente.
```
aws mq describe-broker --broker-id {{broker-id}}
```
## Programación del período de mantenimiento del agente a través de la API de Amazon MQ
**Para ajustar el período de mantenimiento del 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: Wed, 7 July 2021 12:00:00 GMT
x-amz-date: Wed, 7 July 2021 12:00:00 GMT
Authorization: {{authorization-string}}
```
Utilice el parámetro `maintenanceWindowStartTime` y tipo de recurso [`WeeklyStartTime`](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#brokers-broker-id-model-weeklystarttime) en la carga de la solicitud.
```
{
"maintenanceWindowStartTime": {
"dayOfWeek": {{"SUNDAY"}},
"timeZone": {{"America/Los_Angeles"}},
"timeOfDay": {{"13:00"}}
}
}
```
1. (Opcional) Utilice la operación de la [DescribeBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#brokers-broker-id-http-methods)API para comprobar que el período de mantenimiento se ha actualizado correctamente. `broker-id`se especifica como parámetro de ruta.
```
GET /v1/brokers/{{broker-id}} HTTP/1.1
Host: mq.us-west-2.amazonaws.com
Date: Wed, 7 July 2021 12:00:00 GMT
x-amz-date: Wed, 7 July 2021 12:00:00 GMT
Authorization: {{authorization-string}}
```