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.
# Gestion d'Amazon DocumentDB
Amazon DocumentDB effectue régulièrement la maintenance des ressources Amazon DocumentDB. La maintenance implique le plus souvent des mises à jour du moteur de base de données (maintenance de cluster) ou du système d'exploitation sous-jacent de l'instance (maintenance de l'instance). Les mises à jour du moteur de base de données sont des correctifs obligatoires et incluent des correctifs de sécurité, des corrections de bogues et des améliorations du moteur de base de données. Bien que la plupart des correctifs du système d'exploitation soient facultatifs, si vous ne les appliquez pas pendant un certain temps, ils peuvent être nécessaires et appliqués automatiquement pour maintenir votre niveau de sécurité. Nous vous recommandons donc d'appliquer les mises à jour du système d'exploitation à vos instances Amazon DocumentDB dès qu'elles sont disponibles.
Les correctifs du moteur de base de données nécessitent que vous mettiez vos clusters Amazon DocumentDB hors ligne pendant une courte période. Une fois disponibles, ces correctifs sont automatiquement programmés pour s'appliquer lors d'une prochaine période de maintenance planifiée de votre cluster Amazon DocumentDB.
La maintenance du cluster et celle des instances ont leurs propres fenêtres de maintenance. Les modifications de cluster et d'instance que vous avez choisi de ne pas appliquer immédiatement sont également appliquées pendant la fenêtre de maintenance. Par défaut, lorsque vous créez un cluster, Amazon DocumentDB attribue une fenêtre de maintenance à la fois au cluster et à chaque instance individuelle. Vous pouvez choisir la fenêtre de maintenance lors de la création d'un cluster ou d'une instance. Vous pouvez également modifier les fenêtres de maintenance à tout moment en fonction de vos planifications ou pratiques métier. Il est généralement conseillé de choisir des fenêtres de maintenance qui limitent l'impact de la maintenance sur votre application (par exemple, le soir ou le week-end).
**Topics**
+ [Notifications relatives aux correctifs du moteur Amazon DocumentDB](#patch-notifications)
+ [Affichage des actions de maintenance Amazon DocumentDB en attente](#view-pending-maintenance)
+ [Mises à jour du moteur Amazon DocumentDB](#db-instance-updates-apply)
+ [Mises à jour initiées par](#user-initiated-updates)
+ [Gestion de vos fenêtres de maintenance Amazon DocumentDB](#maintenance-window)
+ [Mises à jour du système d'exploitation Amazon DocumentDB](#os-system-updates)
+ [Application de correctifs aux clusters mondiaux](#global-clusters-patching)
## Notifications relatives aux correctifs du moteur Amazon DocumentDB
Vous recevrez des notifications de maintenance pour les correctifs de moteur de base de données requis par le biais d'événements de santé dans le Tableau de bord Health (AHD) de la AWS console et par e-mail. Lorsqu'un correctif de maintenance du moteur Amazon DocumentDB est disponible dans une AWS région donnée, tous les comptes utilisateurs Amazon DocumentDB concernés de la région reçoivent un AHD et une notification par e-mail pour chaque version d'Amazon DocumentDB affectée par le correctif. Vous pouvez consulter ces notifications dans la section **Modifications planifiées** de l'AHD dans la AWS console. La notification contiendra des détails sur le calendrier de disponibilité des correctifs, le calendrier d'application automatique, la liste des clusters concernés et les notes de mise à jour. Cette notification sera également envoyée par e-mail à l'adresse e-mail de l'utilisateur root du AWS compte.
![\[La console Amazon DocumentDB affiche l'onglet Modifications planifiées pour les mises à niveau des correctifs du moteur.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/scheduled-changes.png)
Une fois que vous aurez reçu cette notification, vous pourrez choisir d'appliquer automatiquement ces correctifs de moteur à vos clusters Amazon DocumentDB avant la date d'application automatique prévue. Vous pouvez également attendre que les correctifs du moteur soient appliqués automatiquement lors d'une prochaine fenêtre de maintenance (option par défaut).
**Note**
Le **statut** de la notification dans l'AHD sera défini sur « En cours » jusqu'à ce qu'un nouveau correctif du moteur Amazon DocumentDB contenant une nouvelle version du correctif soit publié.
Une fois le correctif du moteur appliqué à votre cluster Amazon DocumentDB, la version du correctif du moteur du cluster sera mise à jour pour refléter la version indiquée dans la notification. Vous pouvez exécuter la `db.runCommand({getEngineVersion: 1})` commande pour vérifier cette mise à jour.
AWS Health s'intègre également à Amazon EventBridge , qui utilise des événements pour créer des applications évolutives axées sur les événements et s'intègre à plus de 20 cibles AWS Lambda, dont Amazon Simple Queue Service (SQS), entre autres. Vous pouvez utiliser le code `AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_SCHEDULED` d'événement pour configurer Amazon EventBridge avant que les correctifs du moteur ne soient disponibles. Vous pouvez le configurer EventBridge pour répondre à l'événement et exécuter automatiquement des actions telles que la capture des informations relatives à l'événement, le lancement d'événements supplémentaires, l'envoi de notifications via des canaux supplémentaires tels que les notifications push au AWS Console Mobile Application, et la prise de mesures correctives ou autres lorsqu'un correctif du moteur Amazon DocumentDB est disponible dans votre région.
Dans les rares cas où Amazon DocumentDB annule un correctif moteur, vous recevrez une notification AHD ainsi qu'un e-mail vous informant de l'annulation. Par conséquent, vous pouvez utiliser le code `AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_CANCELLED` d'événement pour configurer Amazon EventBridge afin qu'il réponde à cet événement. Consultez le *guide de EventBridge l'utilisateur Amazon* pour en savoir plus sur l'utilisation [ EventBridge des règles Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html).
## Affichage des actions de maintenance Amazon DocumentDB en attente
Vous pouvez voir si une mise à jour de maintenance est disponible pour votre cluster en utilisant le AWS Management Console ou le AWS CLI.
Si une mise à jour est disponible, vous pouvez procéder de l’une des manières suivantes :
+ Reportez une action de maintenance actuellement planifiée pour la prochaine fenêtre de maintenance (pour les correctifs du système d'exploitation uniquement).
+ Appliquer immédiatement les actions de maintenance.
+ Planifier le début des actions de maintenance au cours de votre prochaine fenêtre de maintenance.
**Note**
Si vous ne prenez aucune mesure, les actions de maintenance requises, telles que les correctifs du moteur, seront appliquées automatiquement lors d'une prochaine fenêtre de maintenance planifiée.
Le réglage de la fenêtre de maintenance détermine quand les opérations en attente démarrent, mais il ne limite pas la durée d'exécution totale de ces opérations.
------
#### [ Using the AWS Management Console ]
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le panneau de navigation, choisissez **Clusters**.
1. Si une mise à jour est disponible, elle est indiquée par le mot **Available**, **Required** ou **Next Window** dans la colonne **Maintenance** du cluster sur la console Amazon DocumentDB, comme indiqué ici :
![\[La console Amazon DocumentDB affiche la colonne Maintenance pour les clusters.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/db-cluster-maintenance-updates-status.png)
1. Pour effectuer une action, choisissez le cluster pour afficher ses détails, puis choisissez **Maintenance et sauvegardes**. Les éléments de **maintenance en attente** apparaissent.
![\[La console Amazon DocumentDB affiche la fenêtre de maintenance du cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/cluster-maint-3.png)
------
#### [ Using the AWS CLI ]
Utilisez l' AWS CLI opération suivante pour déterminer les actions de maintenance en attente. Le résultats obtenu ici n'indique aucune action de maintenance en attente.
```
aws docdb describe-pending-maintenance-actions
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
"PendingMaintenanceActions": []
}
```
------
## Mises à jour du moteur Amazon DocumentDB
Avec Amazon DocumentDB, vous pouvez choisir à quel moment appliquer les opérations de maintenance. Vous pouvez décider quand Amazon DocumentDB applique les mises à jour à l'aide du AWS Management Console ou. AWS CLI
Utilisez les procédures décrites dans cette rubrique pour effectuer une mise à niveau immédiate ou planifier une mise à niveau pour votre cluster.
------
#### [ Using the AWS Management Console ]
Vous pouvez utiliser la console pour gérer les mises à jour de vos clusters Amazon DocumentDB.
**Pour gérer une mise à jour pour un cluster**
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le panneau de navigation, choisissez **Clusters**.
1. Dans la liste des clusters, choisissez le bouton en regard du nom du cluster auquel vous voulez appliquer l'opération de maintenance.
1. Dans le menu **Actions**, choisissez l'une des options suivantes :
+ **Mettre à niveau maintenant** pour exécuter immédiatement les tâches de maintenance en attente.
+ **Mettre à niveau lors du créneau suivant** pour exécuter les tâches de maintenance en attente pendant le créneau de maintenance suivant du cluster.
Vous pouvez également cliquer sur **Appliquer maintenant** ou sur **Appliquer dans la fenêtre de maintenance suivante** dans la section Maintenance en attente de l'onglet **Maintenance et sauvegardes** du cluster (voir **Utilisation du AWS Management Console** dans la section précédente).
**Note**
S'il n'y a aucune tâche de maintenance en attente, toutes les options précédentes sont inactives.
------
#### [ Using the AWS CLI ]
Pour appliquer une mise à jour en attente à un cluster, utilisez l'`apply-pending-maintenance-action` AWS CLI opération.
**Parameters**
+ **--resource-identifier**—Le nom de ressource Amazon (ARN) Amazon DocumentDB de la ressource à laquelle s'applique l'action de maintenance en attente.
+ **--apply-action**: action de maintenance en attente à appliquer à cette ressource.
Valeurs valables : `system-update` et `db-upgrade`.
+ **--opt-in-type**—Une valeur qui spécifie le type de demande d'opt-in ou qui annule une demande d'opt-in. Un type demande de confirmation de l'acceptation de type `immediate` ne peut pas être annulée.
Valeurs valides :
+ `immediate`—Appliquez immédiatement l'action de maintenance.
+ `next-maintenance`—Appliquez l'action de maintenance lors de la fenêtre de maintenance suivante pour la ressource.
+ `undo-opt-in`—Annulez toutes les demandes d'`next-maintenance`opt-in existantes.
**Example**
Pour Linux, macOS ou Unix :
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb \
--apply-action system-update \
--opt-in-type immediate
```
Pour Windows :
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:123456789012:db:docdb ^
--apply-action system-update ^
--opt-in-type immediate
```
Pour renvoyer une liste des ressources dont au moins une mise à jour est en attente, utilisez la `describe-pending-maintenance-actions` AWS CLI commande.
**Example**
Pour Linux, macOS ou Unix :
```
aws docdb describe-pending-maintenance-actions \
--resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb
```
Pour Windows :
```
aws docdb describe-pending-maintenance-actions ^
--resource-identifier arn:aws:rds:us-east-1:001234567890:db:docdb
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:sample-cluster",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"CurrentApplyDate": "2019-01-11T03:01:00Z",
"Description": "db-version-upgrade",
"ForcedApplyDate": "2019-01-18T03:01:00Z",
"AutoAppliedAfterDate": "2019-01-11T03:01:00Z"
}
]
}
]
}
```
Vous pouvez également renvoyer une liste de ressources pour un cluster en spécifiant le `--filters` paramètre de l'`describe-pending-maintenance-actions` AWS CLI opération. Le format de l'opération `--filters` est `Name=filter-name,Values=resource-id,...`.
`db-cluster-id`est la valeur acceptable pour le `Name` paramètre du filtre. Cette valeur accepte une liste d'identifiants de cluster ou ARNs. La liste renvoyée inclut uniquement les actions de maintenance en attente pour les clusters identifiés par ces identifiants ou ARNs.
L'exemple suivant renvoie les actions de maintenance en attente pour les clusters `sample-cluster1` et `sample-cluster2`.
**Example**
Pour Linux, macOS ou Unix :
```
aws docdb describe-pending-maintenance-actions \
--filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2
```
Pour Windows :
```
aws docdb describe-pending-maintenance-actions ^
--filters Name=db-cluster-id,Values=sample-cluster1,sample-cluster2
```
------
### Appliquer les dates
Chaque action de maintenance a une date d'application que vous pouvez trouver lors de la description des actions de maintenance en attente. Lorsque vous lisez le résultat des actions de maintenance en attente à partir du AWS CLI, trois dates sont répertoriées. Ces valeurs de date indiquent `null` lorsque la maintenance est facultative. Les valeurs sont renseignées une fois que l'action de maintenance correspondante est planifiée ou appliquée.
+ **CurrentApplyDate**: date à laquelle l'action de maintenance sera appliquée soit immédiatement, soit lors de la fenêtre de maintenance suivante.
+ **ForcedApplyDate**—La date à laquelle la maintenance sera automatiquement appliquée, indépendamment de votre fenêtre de maintenance.
+ **AutoAppliedAfterDate**: date après laquelle la maintenance sera appliquée pendant la fenêtre de maintenance du cluster.
## Mises à jour initiées par
En tant qu'utilisateur d'Amazon DocumentDB, vous pouvez initier des mises à jour de vos clusters ou instances. Par exemple, vous pouvez modifier la classe d'une instance en une classe avec plus ou moins de mémoire, ou vous pouvez modifier le groupe de paramètres d'un cluster. Amazon DocumentDB considère ces modifications différemment des mises à jour initiées par Amazon DocumentDB. Pour plus d'informations sur la modification d'un cluster ou d'une instance, consultez ce qui suit :
+ [Modification d'un cluster Amazon DocumentDB](db-cluster-modify.md)
+ [Modification d'une instance Amazon DocumentDB](db-instance-modify.md)
Pour voir une liste des modifications en attente lancées par l'utilisateur, exécutez la commande suivante.
**Example**
**Pour voir les modifications en attente lancées par l'utilisateur pour vos instances**
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'
```
Pour Windows :
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'
```
La sortie de cette opération ressemble à ceci (format JSON).
Dans ce cas, `sample-cluster-instance` a un changement en attente vers une classe d'instance `db.r5.xlarge`, alors que `sample-cluster-instance-2` n'a pas de changements en attente.
```
[
[
"sample-cluster",
"sample-cluster-instance",
{
"DBInstanceClass": "db.r5.xlarge"
}
],
[
"sample-cluster",
"sample-cluster-instance-2",
{}
]
]
```
## Gestion de vos fenêtres de maintenance Amazon DocumentDB
Chaque instance et chaque cluster est associé à un créneau de maintenance hebdomadaire au cours duquel toutes les modifications en attente sont appliquées. La fenêtre de maintenance est une occasion de contrôler le moment où les modifications et les correctifs logiciels ont lieu, qu'ils aient fait l'objet d'une demande ou qu'ils soient obligatoires. Si un événement de maintenance est planifié pour une semaine donnée, il est déclenché pendant le créneau de maintenance de 30 minutes que vous identifiez. La plupart des événements de maintenance se terminent également au cours du créneau de maintenance de 30 minutes, mais des événements de maintenance plus importants peuvent prendre plus de 30 minutes.
Ce créneau de maintenance de 30 minutes est sélectionné de manière aléatoire sur un bloc horaire de 8 heures par région. Si vous ne spécifiez pas de fenêtre de maintenance préférée lorsque vous créez l'instance ou le cluster, Amazon DocumentDB attribue une fenêtre de maintenance de 30 minutes un jour de la semaine sélectionné au hasard.
Le tableau suivant répertorie pour les différentes régions les blocs de temps à partir desquels les créneaux de maintenance par défaut sont alloués.
| Nom de la région | Région | Bloc horaire UTC |
| --- | --- | --- |
| USA Est (Ohio) | us-east-2 | 3 h 00-11 h 00 |
| USA Est (Virginie du Nord) | us-east-1 | 3 h 00-11 h 00 |
| USA Ouest (Oregon) | us-west-2 | 6 h 00-14 h 00 |
| Afrique (Le Cap) | af-south-1 | 03 H 00 — 11 H 00 |
| Asie-Pacifique (Hong Kong) | ap-east-1 | 6 h 00-14 h 00 |
| Asie-Pacifique (Hyderabad) | ap-south-2 | 6 H 30 — 14 H 30 |
| Asie-Pacifique (Malaisie) | ap-southeast-5 | 13 h 00-21 h 00 |
| Asie-Pacifique (Mumbai) | ap-south-1 | 6 h 00-14 h 00 |
| Asie-Pacifique (Osaka) | ap-northeast-3 | 12h00-20h00 |
| Asie-Pacifique (Séoul) | ap-northeast-2 | 13 h 00-21 h 00 |
| Asie-Pacifique (Singapour) | ap-southeast-1 | 14h00-22h00 |
| Asie-Pacifique (Sydney) | ap-southeast-2 | 12h00-20h00 |
| Asie-Pacifique (Jakarta) | ap-southeast-3 | 08h00-16h00 |
| Asie-Pacifique (Melbourne) | ap-southeast-4 | 11:00-19:00 |
| Asie-Pacifique (Thaïlande) | ap-southeast-7 | 15h00-23h00 |
| Asie-Pacifique (Tokyo) | ap-northeast-1 | 13 h 00-21 h 00 |
| Canada (Centre) | ca-central-1 | 3 h 00-11 h 00 |
| Chine (Beijing) | cn-north-1 | 6 h 00-14 h 00 |
| Chine (Ningxia) | cn-northwest-1 | 6 h 00-14 h 00 |
| Europe (Francfort) | eu-central-1 | 21 h 00 - 5 h 00 |
| Europe (Zurich) | eu-central-2 | 02:00-10:00 |
| Europe (Irlande) | eu-west-1 | 22 h 00-6 h 00 |
| Europe (Londres) | eu-west-2 | 22 h 00-6 h 00 |
| Europe (Milan) | eu-south-1 | 02:00-10:00 |
| Europe (Paris) | eu-west-3 | 23:59-07:29 |
| Europe (Espagne) | eu-south-2 | 02H00 — 10H00 |
| Europe (Stockholm) | eu-north-1 | 04 H 00 — 12 H 00 |
| Mexique (Centre) | mx-central-1 | 3 h 00-11 h 00 |
| Moyen-Orient (EAU) | me-central-1 | 05 H 00 — 13 H 00 |
| Amérique du Sud (São Paulo) | sa-east-1 | 00:00-08:00 |
| Israël (Tel Aviv) | il-central-1 | 04h00-12h00 |
| AWS GovCloud (USA Est) | us-gov-east-1 | 17:00-01:00 |
| AWS GovCloud (US-Ouest) | us-gov-west-1 | 6 h 00-14 h 00 |
### Modification de vos fenêtres de maintenance Amazon DocumentDB
Le créneau de maintenance doit intervenir au moment où l'utilisation est la plus faible, il peut donc s'avérer nécessaire de le modifier de temps en temps. Votre cluster ou instance est indisponible pendant cette période uniquement si des modifications système (telles qu'une opération de stockage évolutif ou un changement de classe d'instance) sont appliquées et nécessitent une interruption de service. Ensuite, il n'est pas disponible uniquement pendant le délai minimum requis pour apporter les modifications nécessaires.
Pour les mises à niveau du moteur de base de données, Amazon DocumentDB utilise la fenêtre de maintenance préférée du cluster et non la fenêtre de maintenance pour les instances individuelles.
**Pour modifier la fenêtre de maintenance**
+ Pour un cluster, veuillez consulter [Modification d'un cluster Amazon DocumentDB](db-cluster-modify.md).
+ Pour une instance, veuillez consulter [Modification d'une instance Amazon DocumentDB](db-instance-modify.md).
## Mises à jour du système d'exploitation Amazon DocumentDB
Les instances des clusters Amazon DocumentDB nécessitent parfois des mises à jour du système d'exploitation. Amazon DocumentDB met à niveau le système d'exploitation vers une version plus récente afin d'améliorer les performances de la base de données et le niveau de sécurité global des clients. Les mises à jour du système d'exploitation ne modifient pas la version du moteur de cluster ni la classe d'instance d'une instance Amazon DocumentDB.
Nous vous recommandons de mettre à jour d'abord les instances du lecteur dans un cluster, puis l'instance du rédacteur afin d'optimiser la disponibilité de votre cluster. Nous ne recommandons pas de mettre à jour les instances du lecteur et du rédacteur en même temps, car vous risquez de subir des temps d'arrêt plus longs en cas de basculement.
La plupart des mises à jour du système d'exploitation pour Amazon DocumentDB sont facultatives et ne sont pas soumises à une date précise pour leur application. Toutefois, si vous n'appliquez pas ces mises à jour pendant un certain temps, elles peuvent éventuellement devenir nécessaires et appliquées automatiquement pendant la période de maintenance de votre instance. Cela permet de maintenir le niveau de sécurité de votre base de données. Pour éviter toute interruption imprévue, nous vous recommandons d'appliquer les mises à jour du système d'exploitation à vos instances Amazon DocumentDB dès qu'elles sont disponibles et de définir le créneau de maintenance de votre instance au moment qui vous convient, en fonction des besoins de votre entreprise.
Pour être averti de la disponibilité d'une nouvelle mise à jour facultative, vous pouvez vous inscrire à RDS-EVENT-0230 dans la catégorie des événements d'application de correctifs de sécurité. Pour plus d'informations sur l'abonnement aux événements Amazon DocumentDB, [consultez la section Abonnement aux événements Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/event-subscriptions.subscribe.html).
Si votre instance est une instance principale, attendez-vous à un basculement de cette dernière lors d'une maintenance sur votre cluster ou votre instance. Pour améliorer votre disponibilité, nous vous recommandons d'utiliser plusieurs instances pour vos clusters Amazon DocumentDB. Pour de plus amples informations, veuillez consulter [Basculement d'Amazon DocumentDB](failover.md).
**Note**
Pour certaines fonctionnalités de gestion, Amazon DocumentDB utilise une technologie opérationnelle partagée avec Amazon Relational Database Service (Amazon RDS).
**Important**
Votre instance Amazon DocumentDB sera mise hors ligne lors de la mise à niveau du système d'exploitation. Vous pouvez minimiser les temps d'arrêt du cluster en utilisant un cluster multi-instances. Si vous ne possédez pas de cluster multi-instances, vous pouvez choisir d'en créer un temporairement en ajoutant des instances secondaires pour effectuer cette maintenance, puis en supprimant les instances de lecteur supplémentaires une fois la maintenance terminée (les frais habituels pour l'instance secondaire s'appliqueront).
**Note**
Vous devrez peut-être appliquer toutes les mises à jour facultatives et obligatoires afin de respecter diverses obligations de conformité. Nous vous recommandons d'appliquer régulièrement toutes les mises à jour mises à disposition par Amazon DocumentDB pendant vos fenêtres de maintenance.
Vous pouvez utiliser le AWS Management Console ou le AWS CLI pour déterminer si une mise à jour est disponible.
------
#### [ Using the AWS Management Console ]
Pour déterminer si une mise à jour est disponible à l'aide de AWS Management Console :
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le volet de navigation, choisissez **Clusters**, puis sélectionnez l'instance.
1. Choisissez **Maintenance**.
1. Dans la section **Maintenance en attente**, recherchez la mise à jour du système d'exploitation.
![\[La console Amazon DocumentDB affiche la colonne Maintenance pour les clusters.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/maintenance-available-1.png)
Vous pouvez sélectionner la mise à jour du système d'exploitation et cliquer sur **Appliquer maintenant** ou sur **Appliquer à la fenêtre de maintenance suivante** dans la section **Maintenance en attente**. Si la valeur de maintenance correspond à la **fenêtre suivante**, reportez les éléments de maintenance en choisissant **Différer** la mise à niveau. Vous ne pouvez pas reporter une action de maintenance en cours.
Vous pouvez également choisir l'instance dans une liste de clusters en cliquant sur **Clusters** dans le volet de navigation et en sélectionnant **Appliquer maintenant** ou **Appliquer à la prochaine fenêtre de maintenance** dans le menu **Actions**.
------
#### [ Using the AWS CLI ]
Pour déterminer si une mise à jour est disponible à l'aide du AWS CLI, appelez la `describe-pending-maintenance-actions` commande suivante :
```
aws docdb describe-pending-maintenance-actions
```
```
{
"ResourceIdentifier": "arn:aws:docdb:us-east-1:123456789012:db:mydb2",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"Description": "New Operating System update is available"
}
]
}
```
------
Les mises à jour du système d'exploitation sont spécifiques aux versions du moteur Amazon DocumentDB et aux classes d'instances. Par conséquent, les instances Amazon DocumentDB reçoivent ou nécessitent des mises à jour à des moments différents. Lorsqu'une mise à jour du système d'exploitation est disponible pour votre instance en fonction de la version du moteur et de la classe d'instance, la mise à jour apparaît dans la console. Il peut également être consulté en exécutant la AWS CLI `describe-pending-maintenance-actions` commande ou en appelant l'opération `DescribePendingMaintenanceActions` API.
Si vous n'utilisez pas la dernière version du correctif de cluster de votre moteur Amazon DocumentDB, il est possible que la mise à jour du système d'exploitation ne figure pas dans la liste des maintenances disponibles. Pour visualiser et gérer la mise à jour du système d'exploitation, vous devez d'abord effectuer une mise à niveau vers la dernière version du correctif du moteur.
## Application de correctifs aux clusters mondiaux
Les versions du correctif du moteur des clusters principaux et secondaires sont mises à niveau pendant la fenêtre de maintenance de chaque cluster. Vous recevrez une notification dès qu'une nouvelle version du correctif du moteur sera disponible dans toutes les régions. La notification est envoyée par Tableau de bord Health e-mail.
Une fois que vous avez reçu la notification, vous pouvez choisir d'appliquer automatiquement ces correctifs de moteur à vos clusters secondaire et principal. Appliquez toujours un correctif aux clusters secondaires en premier, puis au cluster principal. Cette commande garantit cela FailOver et SwitchOver reste disponible tout au long du processus d'application des correctifs.
**Important**
Si vous avez déjà appliqué des correctifs au cluster principal avant les clusters secondaires, mettez à jour tous les clusters secondaires vers la même version dès que possible. FailOver et ne SwitchOver fonctionnera pas tant que tous les clusters secondaires et principaux ne seront pas sur la même version.
Si vous ne choisissez pas de l'appliquer automatiquement, le correctif sera appliqué automatiquement lors de la fenêtre de maintenance suivante de chaque cluster. Il sera d'abord appliqué sur les clusters secondaires. Une fois que tous les clusters secondaires ont été corrigés, le correctif sera appliqué au cluster principal lors de la fenêtre de maintenance suivante du cluster principal.
Nous vous recommandons de mettre à niveau les clusters de bases de données principaux et secondaires vers la même version. Vous ne pouvez effectuer un basculement de base de données interrégional géré sur une base de données globale Amazon DocumentDB que si les clusters de base de données principal et secondaire ont la même version de moteur et le même niveau de correctif.
Lorsque les clusters principaux et secondaires utilisent des versions de correctif de moteur différentes, FailOver les SwitchOver demandes sont rejetées pour éviter les problèmes de compatibilité des versions du moteur. Cela peut également se produire lorsque vous ajoutez un nouveau cluster secondaire à une base de données globale à l'aide d'une version de moteur plus récente que le cluster principal. Pour éviter cela, assurez-vous que tout nouveau cluster secondaire est créé avec la même version de moteur que le cluster principal avant de l'ajouter à la base de données globale.
Une fois que vous avez reçu la notification du correctif, nous vous recommandons de mettre à niveau vos clusters principal et secondaire vers la dernière version dès que possible afin de garantir SwitchOver et de FailOver continuer à fonctionner comme prévu. Si votre SwitchOver demande FailOver ou votre demande est rejetée, vérifiez la version du correctif du moteur sur vos clusters principal et secondaire. S'ils ne correspondent pas, vérifiez et appliquez le correctif disponible sur vos clusters secondaire et principal.