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.
# Planification de la fenêtre de maintenance pour un courtier Amazon MQ
Amazon MQ effectue régulièrement la maintenance du matériel, du système d'exploitation ou du logiciel moteur d'un courtier de messages pendant la période de maintenance. Par exemple, si vous avez modifié le type d'instance de courtier, Amazon MQ appliquera vos modifications lors de la prochaine fenêtre de maintenance planifiée. La durée de la maintenance peut durer jusqu'à deux heures en fonction des opérations planifiées pour votre courtier de messages. Vous pouvez minimiser les temps d'arrêt pendant une période de maintenance en sélectionnant un mode de déploiement de courtier offrant une haute disponibilité sur plusieurs zones de disponibilité (AZ).
[Amazon MQ pour ActiveMQ propose des déploiements actifs/en veille pour une haute disponibilité.](amazon-mq-broker-architecture.md#active-standby-broker-deployment) En active/standby mode, Amazon MQ effectue les opérations de maintenance une instance à la fois, et au moins une instance reste disponible. De plus, vous pouvez configurer un [réseau de courtiers avec des](network-of-brokers.md) fenêtres de maintenance variées au cours de la semaine. Amazon MQ pour RabbitMQ fournit les déploiements de [clusters](rabbitmq-broker-architecture.md#rabbitmq-broker-architecture-cluster) pour une haute disponibilité. Dans les déploiements de clusters, Amazon MQ effectue les opérations de maintenance un nœud à la fois en conservant au moins deux nœuds actifs à tout moment.
Lorsque vous créez votre courtier pour la première fois, vous pouvez planifier la période de maintenance une fois par semaine à une heure précise. Vous ne pouvez ajuster la fenêtre de maintenance d’un agent que quatre fois maximum avant la prochaine fenêtre de maintenance planifiée. Une fois la période de maintenance d'un courtier terminée, Amazon MQ réinitialise la limite et vous pouvez à nouveau ajuster le calendrier avant le début de la fenêtre de maintenance suivante. La disponibilité des courtiers n'est pas affectée lors de l'ajustement de la fenêtre de maintenance des courtiers.
Pour ajuster la fenêtre de maintenance des courtiers, vous pouvez utiliser l' AWS Management Console API AWS CLI, la ou l'API Amazon MQ.
## Planifiez la fenêtre de maintenance du courtier à l'aide du AWS Management Console
**Pour ajuster la fenêtre de maintenance du courtier à l'aide du AWS Management Console**
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 **Maintenance**, procédez comme suit :
1. Pour **Start day (Jour de début)**, choisissez un jour de la semaine, par exemple **Sunday (Dimanche)**, dans la liste déroulante.
1. Pour **Start time (Heure de début)**, choisissez l’heure et la minute que vous souhaitez définir pour la prochaine fenêtre de maintenance de l’agent, par exemple **12**:**00**.
**Note**
Les options **Start time (Heure de début)** sont configurées selon le fuseau horaire UTC\$10.
1. Ensuite, sélectionnez **Modifications du calendrier**. Choisissez ensuite **Après le prochain redémarrage** ou **Immédiatement**. Si vous choisissez **Après le prochain redémarrage**, la fenêtre de maintenance sera immédiatement mise à jour sans redémarrer le broker. Si vous **sélectionnez Immédiatement**, le courtier sera immédiatement redémarré.
1. Sur la page d’informations de l’agent, sous **Maintenance window (Fenêtre de maintenance)**, vérifiez que votre nouvelle préférence de planification s’affiche.
## Planifiez la fenêtre de maintenance du courtier à l'aide du AWS CLI
**Pour ajuster la fenêtre de maintenance du courtier à l'aide du AWS CLI**
1. Utilisez la commande CLI [update-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/update-broker.html) et spécifiez les paramètres suivants, comme illustré dans l’exemple.
+ `--broker-id` – ID unique généré par Amazon MQ pour l’agent. Vous pouvez analyser l’ID de votre ARN d’agent. Par exemple, avec l’ARN suivant, `arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`, l’ID de l’agent serait `b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`.
+ `--maintenance-window-start-time` – Les paramètres qui déterminent l’heure de début de la fenêtre de maintenance hebdomadaire fournie dans la structure suivante.
+ `DayOfWeek` – Le jour de la semaine, dans la syntaxe suivante : `MONDAY| TUESDAY | WEDNESDAY | THURSDAY | FRIDAY | SATURDAY | SUNDAY`
+ `TimeOfDay` – L’heure au format 24 heures.
+ `TimeZone` – (Facultatif) Le fuseau horaire, soit au format Pays/Ville, soit en indiquant le décalage par rapport à l’heure UTC. Définie sur UTC par défaut.
```
aws mq update-broker --broker-id broker-id \
--maintenance-window-start-time DayOfWeek=SUNDAY,TimeOfDay=13:00,TimeZone=America/Los_Angeles
```
1. (Facultatif) Utilisez la commande de CLI [describe-agent](https://docs.aws.amazon.com/cli/latest/reference/mq/reboot-broker.html) pour vérifier que la fenêtre de maintenance est correctement mise à jour.
```
aws mq describe-broker --broker-id broker-id
```
## Planifiez la fenêtre de maintenance du courtier à l'aide de l'API Amazon MQ
**Pour ajuster la fenêtre de maintenance de l’agent à 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: Wed, 7 July 2021 12:00:00 GMT
x-amz-date: Wed, 7 July 2021 12:00:00 GMT
Authorization: authorization-string
```
Utilisez le paramètre `maintenanceWindowStartTime` et le type de ressource [https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#brokers-broker-id-model-weeklystarttime](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#brokers-broker-id-model-weeklystarttime) dans la charge utile de la demande.
```
{
"maintenanceWindowStartTime": {
"dayOfWeek": "SUNDAY",
"timeZone": "America/Los_Angeles",
"timeOfDay": "13:00"
}
}
```
1. (Facultatif) Utilisez l'opération [DescribeBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#brokers-broker-id-http-methods)API pour vérifier que la fenêtre de maintenance a été correctement mise à jour. `broker-id`est spécifié en tant que paramètre de chemin.
```
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
```