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 des clusters élastiques Amazon DocumentDB
Pour gérer un cluster élastique Amazon DocumentDB, vous devez disposer d'une politique IAM avec les autorisations appropriées du plan de contrôle Amazon DocumentDB. Ces autorisations vous permettent de créer, de modifier et de supprimer des clusters. La politique DBFull d'accès aux documents Amazon fournit toutes les autorisations requises pour administrer un cluster élastique Amazon DocumentDB.
Les rubriques suivantes montrent comment effectuer différentes tâches lorsque vous travaillez avec des clusters élastiques Amazon DocumentDB.
**Topics**
+ [Modification des configurations de clusters élastiques](#elastic-modify)
+ [Surveillance d'un cluster élastique](#elastic-monitor)
+ [Supprimer un cluster élastique](#elastic-delete)
+ [Gestion des instantanés de clusters élastiques](elastic-manage-snapshots.md)
+ [Arrêt et démarrage d'un cluster élastique Amazon DocumentDB](elastic-cluster-stop-start.md)
+ [Gestion des clusters élastiques Amazon DocumentDB](elastic-cluster-maintenance.md)
## Modification des configurations de clusters élastiques
Dans cette section, nous expliquons comment modifier Elastic Cluster, à l'aide des instructions suivantes AWS Management Console ou AWS CLI en suivant les instructions suivantes.
L'une des principales utilisations de la modification du cluster consiste à redimensionner les partitions en augmentant ou en diminuant le nombre de partitions et la capacité de calcul des and/or partitions.
------
#### [ Using the AWS Management Console ]
Pour modifier la configuration d'un cluster élastique à l'aide de AWS Management Console :
1. Connectez-vous à la console Amazon DocumentDB [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)et ouvrez-la.
1. Dans le panneau de navigation, choisissez **Clusters**.
**Astuce**
Si le volet de navigation ne s'affiche pas sur le côté gauche de votre écran, choisissez l'icône de menu dans le coin supérieur gauche du volet de navigation.
1. Choisissez le nom du cluster que vous souhaitez modifier dans la colonne **Identifiant du cluster**.
1. Sélectionnez **Modifier**.
1. Modifiez les champs que vous souhaitez modifier, puis sélectionnez **Modifier le cluster**.
![\[Formulaire présentant les options de configuration, de maintenance, d'authentification et de paramètres réseau qui peuvent être modifiées, avec le bouton Modifier le cluster dans le coin inférieur droit.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/cluster-shard-modify-3.png)
**Note**
Vous pouvez également accéder à la boîte de dialogue **Modifier le cluster** en accédant à la page **Clusters**, en cochant la case à côté de votre cluster, en choisissant **Actions**, puis **Modifier**.
------
#### [ Using the AWS CLI ]
Pour modifier une configuration de cluster élastique à l'aide de AWS CLI, utilisez l'`update-cluster`opération avec les paramètres suivants :
+ **--cluster-arn** : obligatoire. Identifiant ARN du cluster que vous souhaitez modifier.
+ **--shard-capacity**—Facultatif. Le nombre de v CPUs attribué à chaque partition. Le maximum est de 64. Les valeurs autorisées sont 2, 4, 8, 16, 32, 64.
+ **--shard-count**—Facultatif. Le nombre de partitions attribuées au cluster. Le maximum est de 32.
+ **--shard-instance**-Nombre : facultatif. Le nombre d'instances de répliques s'appliquant à toutes les partitions de ce cluster. Le maximum est de 16.
+ **--auth-type**—Facultatif. Type d'authentification utilisé pour déterminer où récupérer le mot de passe utilisé pour accéder au cluster élastique. Les types valides sont `PLAIN_TEXT` ou`SECRET_ARN`.
+ **--admin-user-password**—Facultatif. Le mot de passe associé à l'utilisateur administrateur.
+ **--vpc-security-group-ids**—Facultatif. Configurez une liste des groupes de sécurité Amazon EC2 et Amazon Virtual Private Cloud (VPC) à associer à ce cluster.
+ **--preferred-maintenance-window**—Facultatif. Configurer la plage horaire hebdomadaire pendant laquelle la maintenance du système peut avoir lieu, en temps universel coordonné (UTC)
Le format est :`ddd:hh24:mi-ddd:hh24:mi`. Jours valides (ddd) : lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche
La valeur par défaut est une fenêtre de 30 minutes sélectionnée au hasard sur une période de 8 heures pour chaque région Amazon Web Services, survenant un jour aléatoire de la semaine.
Fenêtre minimale de 30 minutes.
+ **--subnet-ids**—Facultatif. Configurez les identifiants de sous-réseau.
Dans l'exemple suivant, remplacez chacune *user input placeholder* par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic update-cluster \
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
--shard-capacity 8 \
--shard-count 4 \
--shard-instance-count 3 \
--admin-user-password testPassword \
--vpc-security-group-ids ec-65f40350 \
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
Pour Windows :
```
aws docdb-elastic update-cluster ^
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
--shard-capacity 8 ^
--shard-count 4 ^
--shard-instance-count 3 ^
--admin-user-password testPassword ^
--vpc-security-group-ids ec-65f40350 ^
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
------
Pour surveiller l'état du cluster élastique après votre modification, consultez la section Surveillance d'un cluster élastique.
## Surveillance d'un cluster élastique
Dans cette section, nous expliquons comment surveiller votre cluster élastique, à l'aide des instructions suivantes AWS Management Console ou AWS CLI en suivant les instructions suivantes.
------
#### [ Using the AWS Management Console ]
Pour surveiller une configuration de cluster élastique à l'aide de AWS Management Console :
1. Connectez-vous à la console Amazon DocumentDB [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)et ouvrez-la.
1. Dans le panneau de navigation, choisissez **Clusters**.
**Astuce**
Si le volet de navigation ne s'affiche pas sur le côté gauche de votre écran, choisissez l'icône de menu dans le coin supérieur gauche du volet de navigation.
1. Choisissez le nom du cluster que vous souhaitez surveiller dans la colonne **Identifiant du cluster**.
1. Sélectionnez l'onglet **Monitoring** (Surveillance).
![\[Informations récapitulatives sur le cluster Elastic affichées dans l'onglet Monitoring.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/cluster-shard-monitor-2.png)
Un certain nombre de graphiques d'Amazon CloudWatch sont affichés pour les catégories de surveillance suivantes :
+ Utilisation des ressources
+ Débit
+ Opérations
+ Système
Vous pouvez également accéder à Amazon CloudWatch via le AWS Management Console pour configurer votre propre environnement de surveillance pour vos clusters élastiques.
------
#### [ Using the AWS CLI ]
Pour surveiller une configuration de cluster élastique spécifique à l'aide de AWS CLI, utilisez l'`get-cluster`opération avec les paramètres suivants :
+ **--cluster-arn** : obligatoire. Identifiant ARN du cluster pour lequel vous souhaitez obtenir des informations.
Dans l'exemple suivant, remplacez chacune *user input placeholder* par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic get-cluster \
--cluster-arn arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9
```
Pour Windows :
```
aws docdb-elastic get-cluster ^
--cluster-arn arn:aws:docdb:-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9
```
Le résultat de cette opération ressemble à ce qui suit :
```
"cluster": {
...
"clusterArn": "arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9",
"clusterEndpoint": "stretch-11-477568257630.us-east-1.docdb-elastic.amazonaws.com",
"readerEndpoint": "stretch-11-477568257630-ro.us-east-1.docdb-elastic.amazonaws.com",
"clusterName": "stretch-11",
"shardCapacity": 2,
"shardCount": 3,
"shardInstanceCount: 5,
"status": "ACTIVE",
...
}
```
Pour plus d'informations, consultez le `DescribeClusterSnapshot` manuel Amazon DocumentDB Resource Management API Reference.
Pour afficher les détails de tous les clusters élastiques à l'aide de AWS CLI, utilisez l'`list-clusters`opération avec les paramètres suivants :
+ **--next-token**—Facultatif. Si le nombre d’éléments en sortie (`--max-results`) est inférieur au nombre total d’éléments renvoyés par les appels d’API sous-jacents, la sortie inclut un code `NextToken` que vous pouvez transmettre dans une commande suivante pour récupérer le prochain ensemble d’éléments.
+ **--max-results**—Facultatif. Le nombre total d'éléments à renvoyer dans la sortie de la commande. S'il existe plus de résultats que la `max-results` valeur spécifiée, un jeton de pagination (`next-token`) est inclus dans la réponse afin que les résultats restants puissent être récupérés.
+ Par défaut : 100
+ Minimum 20, maximum 100
Dans l'exemple suivant, remplacez chacune *user input placeholder* par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic list-clusters \
--next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== \
--max-results 2
```
Pour Windows :
```
aws docdb-elastic list-clusters ^
--next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== ^
--max-results 2
```
Le résultat de cette opération ressemble à ce qui suit :
```
{
"Clusters": [
{
"ClusterIdentifier":"mycluster-1",
"ClusterArn":"arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster"
"Status":"available",
"ClusterEndpoint":"sample-cluster.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
}
{
"ClusterIdentifier":"mycluster-2",
"ClusterArn":"arn:aws:docdb:us-west-2:987654321098:sharded-cluster:sample-cluster"
"Status":"available",
"ClusterEndpoint":"sample-cluster2.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
}
]
}
```
------
## Supprimer un cluster élastique
Dans cette section, nous expliquons comment supprimer un cluster élastique, à l'aide des instructions suivantes AWS Management Console ou AWS CLI en suivant les instructions suivantes.
------
#### [ Using the AWS Management Console ]
Pour supprimer une configuration de cluster élastique à l'aide de AWS Management Console :
1. Connectez-vous à la console Amazon DocumentDB [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)et ouvrez-la.
1. Dans le panneau de navigation, choisissez **Clusters**.
**Astuce**
Si le volet de navigation ne s'affiche pas sur le côté gauche de votre écran, choisissez l'icône de menu dans le coin supérieur gauche du volet de navigation.
1. Dans le tableau de liste des clusters, cochez la case située à gauche du nom du cluster que vous souhaitez supprimer, puis choisissez **Actions**. Dans le menu déroulant, choisissez **Delete (Supprimer)**.
1. Dans le cluster **élastique Delete « cluster-name » ?** dans une boîte de dialogue, choisissez **Supprimer**.
![\[Boîte de dialogue Supprimer, avec le bouton Supprimer dans le coin inférieur droit.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/cluster-delete-dialog.png)
La suppression du cluster prend plusieurs minutes. Pour surveiller l'état du cluster, consultez la section [Surveillance de l'état d'un cluster Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).
------
#### [ Using the AWS CLI ]
Pour supprimer un cluster élastique à l'aide de AWS CLI, utilisez l'`delete-cluster`opération avec les paramètres suivants :
+ **--cluster-arn** : obligatoire. Identifiant ARN du cluster que vous souhaitez supprimer.
+ **--no-skip-final-backup**—Facultatif. Si vous souhaitez une sauvegarde finale, vous devez inclure ce paramètre dans le nom de la sauvegarde finale. Vous devez inclure soit `--final-backup-identifier` ou `--skip-final-backup`.
+ **--skip-final-backup**—Facultatif. Utilisez ce paramètre uniquement si vous ne souhaitez pas effectuer de sauvegarde finale avant de supprimer votre cluster. Le paramètre par défaut consiste à prendre un instantané final.
Les exemples de AWS CLI code suivants suppriment un cluster dont l'ARN est arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster avec une sauvegarde finale.
Dans l'exemple suivant, remplacez chacune *user input placeholder* par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic delete-cluster \
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
--no-skip-final-backup \
--final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
Pour Windows :
```
aws docdb-elastic delete-cluster ^
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
--no-skip-final-backup ^
--final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
Les exemples de AWS CLI code suivants suppriment un cluster dont l'ARN est arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster sans effectuer de sauvegarde finale.
Dans l'exemple suivant, remplacez chacune *user input placeholder* par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic delete-cluster \
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
--skip-final-backup \
```
Pour Windows :
```
aws docdb-elastic delete-cluster ^
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
--skip-final-backup ^
```
Le résultat de l'`delete-cluster`opération est un affichage du cluster que vous supprimez.
La suppression du cluster prend plusieurs minutes. Pour surveiller l'état du cluster, consultez la section [Surveillance de l'état d'un cluster Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).
------
# Gestion des instantanés de clusters élastiques
Des instantanés manuels peuvent être pris après la création d'un cluster élastique. Les sauvegardes automatisées sont créées dès que le snapshot du cluster élastique est créé.
**Note**
Votre cluster élastique doit être dans l'`Available`état requis pour qu'un instantané soit pris manuellement.
Cette section explique comment créer, afficher, restaurer et supprimer des instantanés d'Elastic Cluster.
Les rubriques suivantes expliquent comment effectuer différentes tâches lorsque vous travaillez avec des instantanés de clusters élastiques Amazon DocumentDB.
**Topics**
+ [Création d'un instantané manuel d'un cluster élastique](#elastic-create-snapshot)
+ [Affichage d'un instantané d'un cluster élastique](#elastic-view-snapshot)
+ [Restauration d'un cluster élastique à partir d'un instantané](#elastic-restore-snapshot)
+ [Copier un instantané d'un cluster élastique](#elastic-copy-snapshot)
+ [Suppression d'un instantané d'un cluster élastique](#elastic-delete-snapshot)
+ [Gestion d'une sauvegarde automatique des instantanés d'un cluster Elastic](#elastic-auto-snapshot)
## Création d'un instantané manuel d'un cluster élastique
Dans cette section, nous expliquons comment créer un instantané manuel d'un cluster élastique, à l'aide des instructions suivantes AWS Management Console ou AWS CLI en suivant les instructions suivantes.
------
#### [ Using the AWS Management Console ]
Pour créer un instantané manuel d'un cluster élastique à l'aide de AWS Management Console :
1. Connectez-vous à la console Amazon DocumentDB [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)et ouvrez-la.
1. Dans le panneau de navigation, choisissez **Snapshots (Instantanés)**.
**Astuce**
Si le volet de navigation ne s'affiche pas sur le côté gauche de votre écran, choisissez l'icône de menu dans le coin supérieur gauche du volet de navigation.
1. Sur la page **Instantanés**, choisissez **Créer**.
1. Sur la page **Créer un instantané** de **cluster, dans le champ Identifiant** du cluster, choisissez votre cluster élastique dans la liste déroulante.
Dans le champ **Snapshot identifier**, entrez un identifiant unique pour votre cluster élastique.
Choisissez **Créer**.
![\[Schéma : création d'un instantané par un cluster élastique\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/elastic-create-snapshot.png)
**Note**
Vous pouvez également accéder à la boîte de dialogue **Créer un instantané de cluster** en accédant à la page **Clusters**, en cochant la case à côté de votre cluster, puis en choisissant **Actions**, puis **Prendre un instantané**.
Votre instantané de cluster élastique est en cours de provisionnement. Cette opération peut prendre jusqu'à quelques minutes. Vous pouvez afficher et restaurer à partir de votre instantané lorsque l'état s'affiche, comme `Available` dans la liste des **instantanés**.
------
#### [ Using the AWS CLI ]
Pour créer un instantané manuel d'un cluster élastique à l'aide de AWS CLI, utilisez l'`create-cluster-snapshot`opération avec les paramètres suivants :
+ **--snapshot-name** : obligatoire. Nom de l'instantané du cluster que vous souhaitez créer.
+ **--cluster-arn** : obligatoire. Identifiant ARN du cluster dont vous souhaitez créer un instantané.
Dans l'exemple suivant, remplacez chacune *user input placeholder* par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic create-cluster-snapshot \
--snapshot-name sample-snapshot-1 \
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
Pour Windows :
```
aws docdb-elastic create-cluster-snapshot ^
--snapshot-name sample-snapshot-1 ^
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
------
## Affichage d'un instantané d'un cluster élastique
Dans cette section, nous expliquons comment afficher les informations des instantanés d'Elastic Cluster, à l'aide des instructions suivantes AWS Management Console ou AWS CLI en suivant les instructions suivantes.
------
#### [ Using the AWS Management Console ]
Pour afficher les informations relatives à un instantané de cluster élastique spécifique à l'aide de AWS Management Console :
1. Connectez-vous à la console Amazon DocumentDB [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)et ouvrez-la.
1. Dans le panneau de navigation, choisissez **Snapshots (Instantanés)**.
**Astuce**
Si le volet de navigation ne s'affiche pas sur le côté gauche de votre écran, choisissez l'icône de menu dans le coin supérieur gauche du volet de navigation.
1. Sur la page **Instantanés**, choisissez votre instantané dans la liste en cliquant sur le nom dans la colonne **Identifiant du cliché**.
1. Consultez les informations de votre instantané dans **Détails**.
![\[Schéma : instantané de la vue Elastic Cluster\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/elastic-snapshot-view.png)
------
#### [ Using the AWS CLI ]
Pour afficher les informations relatives à un instantané de cluster élastique spécifique à l'aide de AWS CLI, utilisez l'`get-cluster-snapshot`opération avec les paramètres suivants :
+ **--snapshot-arn** : obligatoire. Identifiant ARN de l'instantané pour lequel vous souhaitez obtenir des informations.
Dans l'exemple suivant, remplacez chacune *user input placeholder* par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic get-cluster-snapshot \
--snapshot-arn sampleResourceName
```
Pour Windows :
```
aws docdb-elastic get-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
Pour afficher les informations relatives à un instantané de cluster élastique spécifique à l'aide de AWS CLI, utilisez l'`get-cluster-snapshot`opération avec les paramètres suivants :
+ **--snapshot-arn** : obligatoire. Identifiant ARN de l'instantané pour lequel vous souhaitez obtenir des informations.
Dans l'exemple suivant, remplacez chacune *user input placeholder* par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic get-cluster-snapshot \
--snapshot-arn sampleResourceName
```
Pour Windows :
```
aws docdb-elastic get-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
Pour afficher des informations sur tous les instantanés d'Elastic Cluster à l'aide de AWS CLI, utilisez l'`list-cluster-snapshots`opération avec les paramètres suivants :
+ **--snapshot-type**—Facultatif. Type de snapshots de cluster à renvoyer. Vous pouvez spécifier l’une des valeurs suivantes :
+ `automated`- Renvoie tous les instantanés de cluster qu'Amazon DocumentDB a automatiquement créés pour AWS votre compte.
+ `manual`- Renvoie tous les instantanés de cluster que vous avez créés manuellement pour votre AWS compte.
+ `shared`- Renvoie tous les instantanés de cluster manuels qui ont été partagés sur votre AWS compte.
+ `public`- Renvoie tous les instantanés du cluster marqués comme publics.
+ **--next-token**—Facultatif. Jeton de pagination facultatif fourni par une demande précédente. Si ce paramètre est spécifié, la réponse inclut uniquement les enregistrements au-delà de ce jeton, jusqu'à la valeur spécifiée par`max-results`.
+ **--max-results**—Facultatif. Le nombre maximum de résultats à inclure dans la réponse. S'il existe plus de résultats que la `max-results` valeur spécifiée, un jeton de pagination (`next-token`) est inclus dans la réponse afin que les résultats restants puissent être récupérés.
+ Par défaut : 100
+ Minimum 20, maximum 100
Dans l'exemple suivant, remplacez chacune *user input placeholder* par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic list-cluster-snapshots \
--snapshot-type value \
--next-token value \
--max-results 50
```
Pour Windows :
```
aws docdb-elastic list-cluster-snapshots ^
--snapshot-type value ^
--next-token value ^
--max-results 50
```
------
## Restauration d'un cluster élastique à partir d'un instantané
Dans cette section, nous expliquons comment restaurer un cluster élastique à partir d'un instantané, à l'aide des instructions suivantes AWS Management Console ou AWS CLI en suivant les instructions suivantes.
------
#### [ Using the AWS Management Console ]
Pour restaurer un cluster élastique à partir d'un instantané à l'aide de AWS Management Console :
1. Connectez-vous à la console Amazon DocumentDB [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)et ouvrez-la.
1. Dans le panneau de navigation, choisissez **Snapshots (Instantanés)**.
**Astuce**
Si le volet de navigation ne s'affiche pas sur le côté gauche de votre écran, choisissez l'icône de menu dans le coin supérieur gauche du volet de navigation.
1. Cliquez sur le bouton situé à gauche de l'instantané, que vous souhaitez utiliser pour restaurer un cluster, dans la colonne **Identifiant du cliché**.
1. Choisissez **Actions**, puis **Restaurer**.
![\[Schéma : restauration d'un cluster élastique à partir d'un instantané\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/elastic-restore-snapshot.png)
1. Sur la page **Restaurer un instantané**, entrez le nom du nouveau cluster dans le champ **Identifiant du cluster**.
**Note**
Pour toute restauration manuelle de snapshots, vous devez créer un nouveau cluster.
1. Dans le champ **Virtual Private Cloud (VPC)**, sélectionnez un VPC dans la liste déroulante.
1. Pour les **sous-réseaux et les** groupes de **sécurité VPC**, vous pouvez utiliser les valeurs par défaut ou sélectionner trois sous-réseaux de votre choix et jusqu'à trois groupes de sécurité VPC (un minimum).
1. Si la configuration du cluster vous convient, choisissez **Restore cluster (Restaurer le cluster)** et patientez pendant la restauration du cluster.
------
#### [ Using the AWS CLI ]
Pour restaurer un cluster élastique à partir d'un instantané à l'aide de AWS CLI, utilisez l'`restore-cluster-from-snapshot`opération avec les paramètres suivants :
+ **--cluster-name** : obligatoire. Nom actuel du cluster élastique tel qu'il a été saisi lors de sa création ou modifié pour la dernière fois.
+ **--snapshot-arn** : obligatoire. Identifiant ARN du snapshot utilisé pour restaurer le cluster.
+ **--vpc-security-group-ids**—Facultatif. Un ou plusieurs groupes de sécurité Amazon EC2 et Amazon Virtual Private Cloud (VPC) à associer au cluster.
+ **--kms-key-id**—Facultatif. Configurez l'identifiant de clé KMS pour un cluster chiffré.
L'identifiant de clé KMS est l'Amazon Resource Name (ARN) de la clé de AWS KMS chiffrement. Si vous créez un cluster à l'aide du même compte Amazon Web Services qui possède la clé de chiffrement KMS utilisée pour chiffrer le nouveau cluster, vous pouvez utiliser l'alias de clé KMS au lieu de l'ARN pour la clé de chiffrement KMS.
Si aucune clé de chiffrement n'est spécifiée dans KmsKeyId et si le `StorageEncrypted` paramètre est vrai, Amazon DocumentDB utilise votre clé de chiffrement par défaut.
+ **--subnet-ids**—Facultatif. Identifiants de sous-réseaux réseau.
Dans l'exemple suivant, remplacez chacune *user input placeholder* par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic restore-cluster-from-snapshot \
--cluster-name elastic-sample-cluster \
--snapshot-arn sampleResourceName \
--vpc-security-group-ids value ec-65f40350 \
--kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
Pour Windows :
```
aws docdb-elastic restore-cluster-from-snapshot ^
--cluster-name elastic-sample-cluster ^
--snapshot-arn sampleResourceName ^
--vpc-security-group-ids value ec-65f40350 ^
--kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
------
## Copier un instantané d'un cluster élastique
Dans Amazon DocumentDB, vous pouvez copier des instantanés de clusters élastiques manuels et automatiques au sein d'une même région et d'un même compte. Dans cette section, nous expliquons comment copier un instantané d'un cluster élastique, en utilisant le AWS Management Console ou AWS CLI.
------
#### [ Using the AWS Management Console ]
Pour copier un instantané d'un cluster élastique à l'aide de AWS Management Console :
1. Connectez-vous à la console Amazon DocumentDB [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)et ouvrez-la.
1. Dans le panneau de navigation, choisissez **Snapshots (Instantanés)**.
**Astuce**
Si le volet de navigation ne s'affiche pas sur le côté gauche de votre écran, choisissez l'icône de menu dans le coin supérieur gauche du volet de navigation.
1. Cliquez sur le bouton situé à gauche de l'instantané que vous souhaitez copier dans la colonne **Identifiant du cliché**.
1. Choisissez **Actions**, puis **Copier**.
![\[Schéma : instantané de copie d'Elastic Cluster\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/ec-copy-snapshot.png)
1. Pour **Nouvel identifiant de capture** d'écran, entrez le nom du nouveau cliché.
1. Pour **Copier les balises**, cochez la case si vous souhaitez copier toutes les balises de l'instantané du cluster élastique source vers l'instantané du cluster élastique cible.
1. Pour **le chiffrement**, choisissez une clé AWS KMS par défaut ou une clé KMS de votre choix. La deuxième option vous permet de sélectionner une clé KMS existante que vous avez déjà créée ou d'en créer une nouvelle.
1. Choisissez **Copier un instantané** lorsque vous avez terminé.
------
#### [ Using the AWS CLI ]
Pour copier un instantané d'un cluster élastique à l'aide de AWS CLI, utilisez l'`copy-cluster-snapshot`opération avec les paramètres suivants :
+ **‐‐source-db-cluster-snapshot-identifier** : obligatoire. Identifiant de l'instantané du cluster élastique existant en cours de copie. L'instantané du cluster élastique doit exister et être dans l'état disponible. Ce paramètre n'est pas sensible à la casse.
+ **‐‐target-db-cluster-snapshot-identifier** : obligatoire. Identifiant du nouvel instantané de cluster élastique à créer à partir de l'instantané de cluster existant. Ce paramètre n'est pas sensible à la casse.
Contraintes relatives au nom des instantanés cibles :
+ Ne peut pas être le nom d'un instantané existant.
+ La longueur est de [1 à 63] lettres, chiffres ou traits d'union.
+ Le premier caractère doit être une lettre.
+ Ne peut pas se terminer par un tiret ou contenir deux tirets consécutifs.
Dans l'exemple suivant, remplacez chacune *user input placeholder* par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic copy-cluster-snapshot \
‐‐source-cluster-snapshot-arn \
‐‐target-cluster-snapshot-name my-target-copied-snapshot
```
Pour Windows :
```
aws docdb-elastic copy-cluster-snapshot ^
‐‐source-cluster-snapshot-arn ^
‐‐target-cluster-snapshot-name my-target-copied-snapshot
```
------
## Suppression d'un instantané d'un cluster élastique
Dans cette section, nous expliquons comment supprimer un instantané d'un cluster élastique, en utilisant le AWS Management Console ou AWS CLI.
------
#### [ Using the AWS Management Console ]
Pour restaurer un cluster élastique à partir d'un instantané à l'aide de AWS Management Console :
1. Connectez-vous à la console Amazon DocumentDB [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)et ouvrez-la.
1. Dans le panneau de navigation, choisissez **Snapshots (Instantanés)**.
**Astuce**
Si le volet de navigation ne s'affiche pas sur le côté gauche de votre écran, choisissez l'icône de menu dans le coin supérieur gauche du volet de navigation.
1. Cliquez sur le bouton situé à gauche de l'instantané, que vous souhaitez utiliser pour restaurer un cluster, dans la colonne **Identifiant du cliché**.
1. Choisissez **Actions**, puis **Supprimer**.
![\[Schéma : suppression d'un instantané par Elastic Cluster\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/elastic-delete-snapshot.png)
1. **Dans la boîte de dialogue **Supprimer l'instantané « nom du cliché »**, choisissez Supprimer.**
------
#### [ Using the AWS CLI ]
Pour supprimer un instantané d'un cluster élastique à l'aide de AWS CLI, utilisez l'`delete-cluster-snapshot`opération avec les paramètres suivants :
+ **--snapshot-arn** : obligatoire. Identifiant ARN du snapshot utilisé pour restaurer le cluster.
Dans l'exemple suivant, remplacez chacune *user input placeholder* par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic delete-cluster-snapshot \
--snapshot-arn sampleResourceName
```
Pour Windows :
```
aws docdb-elastic delete-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
------
## Gestion d'une sauvegarde automatique des instantanés d'un cluster Elastic
Amazon DocumentDB prend des instantanés quotidiens de vos clusters élastiques. Vous pouvez spécifier la fenêtre de sauvegarde préférée et la période de conservation des sauvegardes dans une configuration de snapshot Elastic Cluster nouvelle ou existante. Dans cette section, nous expliquons comment définir les paramètres de sauvegarde automatique dans un instantané de cluster élastique, en utilisant le AWS Management Console ou AWS CLI.
------
#### [ Using the AWS Management Console ]
Pour configurer une sauvegarde automatique pour un nouvel instantané d'un cluster Elastic à l'aide de AWS Management Console :
1. Connectez-vous à la console Amazon DocumentDB [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)et ouvrez-la.
1. Dans le panneau de navigation, choisissez **Clusters**.
**Astuce**
Si le volet de navigation ne s'affiche pas sur le côté gauche de votre écran, choisissez l'icône de menu dans le coin supérieur gauche du volet de navigation.
1. Cliquez sur le bouton situé à gauche du cluster pour lequel vous souhaitez modifier les paramètres de sauvegarde, dans la colonne **Identifiant du cluster**.
1. Choisissez **Actions**, puis **Modifier**.
1. Dans la section **Backup**, modifiez les champs en fonction de vos besoins en matière de sauvegarde.
![\[Capture d'écran du volet de sauvegarde affichant les étapes de configuration de la fenêtre de sauvegarde pour le cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/ec-backup.png)
1. **Période de conservation des sauvegardes** : dans la liste, choisissez le nombre de jours pendant lesquels vous pouvez conserver les sauvegardes automatiques de ce cluster avant de les supprimer.
1. **Fenêtre de sauvegarde** : définissez l'heure et la durée quotidiennes pendant lesquelles Amazon DocumentDB doit effectuer des sauvegardes de ce cluster.
1. Choisissez **Sélectionner une fenêtre** si vous souhaitez configurer l'heure et la durée de création des sauvegardes.
**Heure de début** : dans la première liste, choisissez l'heure de début (UTC) pour démarrer vos sauvegardes automatiques. Dans la deuxième liste, choisissez la minute de l'heure à laquelle vous voulez que les sauvegardes automatiques commencent.
**Durée** : dans la liste, choisissez le nombre d'heures à allouer à la création de sauvegardes automatiques.
1. Choisissez **Aucune préférence** si vous souhaitez qu'Amazon DocumentDB choisisse l'heure et la durée de création des sauvegardes.
1. Choisissez **Modifier le cluster** lorsque vous avez terminé.
------
#### [ Using the AWS CLI ]
Pour définir une sauvegarde automatique pour un nouvel instantané du cluster Elastic à l'aide de AWS CLI, utilisez l'`create-cluster-snapshot`opération avec les paramètres suivants :
+ **--preferred-backup-window**—Facultatif. Période quotidienne préférée pendant laquelle les sauvegardes automatisées sont créées. La valeur par défaut est une fenêtre de 30 minutes sélectionnée au hasard dans un intervalle de 8 heures pour chacune d'entre elles. Région AWS
Contraintes:
+ Doit être au format `hh24:mi-hh24:mi`.
+ Doit être exprimée en heure UTC (Universal Coordinated Time).
+ Ne doit pas être en conflit avec la fenêtre de maintenance préférée.
+ Doit être de 30 minutes minimum.
+ **--backup-retention-period**—Facultatif. Nombre de jours de conservation des sauvegardes automatiques. La valeur par défaut est 1.
Contraintes:
+ Vous devez spécifier une valeur minimale de 1.
+ La plage est comprise entre 1 et 35.
**Note**
Les sauvegardes automatisées ne sont effectuées que lorsque le cluster est dans un état « actif ».
**Note**
Vous pouvez également modifier les `backup-retention-period` paramètres `preferred-backup-window` et d'un cluster élastique existant à l'aide de la `aws docdb-elastic update-cluster` commande.
Dans l'exemple suivant, remplacez chacune *user input placeholder* par vos propres informations.
L'`create-cluster`exemple suivant crée le cluster élastique Amazon DocumentDB *sample-cluster* avec une période de rétention de plusieurs *7* jours pour les sauvegardes automatiques et une fenêtre de sauvegarde préférée de. *18:00-18:30 UTC*
Pour Linux, macOS ou Unix :
```
aws docdb-elastic create-cluster \
--cluster-name sample-cluster \
--shard-capacity 2 \
--shard-count 2 \
--admin-user-name SampleAdmin \
--auth-type PLAIN_TEXT \
--admin-user-password SamplePass123! \
--preferred-backup-window 18:00-18:30 \
--backup-retention-period 7
```
Pour Windows :
```
aws docdb-elastic create-cluster ^
--cluster-name sample-cluster ^
--shard-capacity 2 ^
--shard-count 2 ^
--admin-user-name SampleAdmin ^
--auth-type PLAIN_TEXT ^
--admin-user-password SamplePass123! ^
--preferred-backup-window 18:00-18:30 ^
--backup-retention-period 7
```
------
# Arrêt et démarrage d'un cluster élastique Amazon DocumentDB
L'arrêt et le démarrage des clusters élastiques Amazon DocumentDB peuvent vous aider à gérer les coûts des environnements de développement et de test. Au lieu de créer et de supprimer des clusters élastiques à chaque fois que vous utilisez Amazon DocumentDB, vous pouvez arrêter temporairement votre cluster lorsqu'il n'est pas nécessaire. Vous pourrez ensuite le recommencer lorsque vous reprendrez vos tests.
**Topics**
+ [Présentation de l'arrêt et du démarrage d'un cluster élastique](#elastic-cluster-stop-start-overview)
+ [Opérations que vous pouvez effectuer sur un cluster élastique arrêté](#elastic-cluster-stopped-operations)
## Présentation de l'arrêt et du démarrage d'un cluster élastique
Pendant les périodes où vous n'avez pas besoin d'un cluster élastique Amazon DocumentDB, vous pouvez arrêter le cluster. Vous pouvez ensuite à tout moment redémarrer le cluster dès que vous avez besoin de l'utiliser. Le démarrage et l'arrêt simplifient les processus de configuration et de démontage des clusters élastiques utilisés pour le développement, les tests ou des activités similaires ne nécessitant pas de disponibilité continue. Vous pouvez arrêter et démarrer un cluster élastique en utilisant le AWS Management Console ou le AWS CLI en une seule action.
Lorsque votre cluster élastique est arrêté, le volume de stockage du cluster reste inchangé. Vous êtes facturé uniquement pour le stockage, les instantanés manuels et le stockage des sauvegardes automatiques pendant la fenêtre de conservation spécifiée. Amazon DocumentDB démarre automatiquement votre cluster élastique au bout de sept jours afin qu'il ne soit pas en retard par rapport aux mises à jour de maintenance requises. Lorsque votre cluster démarrera au bout de sept jours, l'utilisation du cluster élastique recommencera à vous être facturée. Lorsque votre cluster est arrêté, vous ne pouvez pas interroger votre volume de stockage car l'interrogation nécessite que le cluster soit dans l'état disponible.
Lorsqu'un cluster élastique Amazon DocumentDB est arrêté, il ne peut en aucun cas être modifié. Cela inclut la suppression du cluster.
------
#### [ Using the AWS Management Console ]
La procédure suivante explique comment arrêter un cluster élastique dans l'état disponible ou démarrer un cluster élastique arrêté.
**Pour arrêter ou démarrer un cluster élastique Amazon DocumentDB**
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**.
**Astuce**
Si vous ne voyez pas le volet de navigation sur le côté gauche de votre écran, choisissez l'icône de menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/docdb-menu-icon.png)) dans le coin supérieur gauche de la page.
1. Dans la liste des clusters, choisissez le bouton sur la gauche du nom du cluster que vous voulez arrêter ou démarrer.
![\[Un cluster de la liste des clusters, avec la case à cocher sélectionnée à gauche du nom du cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/cluster-list-ec.png)
1. Choisissez **Actions**, puis l'action que vous souhaitez exécuter sur le cluster.
+ Si vous souhaitez arrêter le cluster et que celui-ci est disponible :
1. Choisissez **Arrêter**.
![\[La liste déroulante Actions avec l'option Stop sélectionnée.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/ec-stop.png)
1. Dans la boîte de dialogue de confirmation, confirmez que vous souhaitez arrêter le cluster élastique en choisissant **Arrêter le cluster**, ou pour maintenir le cluster en cours d'exécution, choisissez **Annuler**.
![\[Boîte de dialogue de confirmation pour arrêter un cluster, avec les boutons Annuler et Arrêter le cluster en bas.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/ec-stop-confirm.png)
+ Si vous souhaitez démarrer un cluster et que celui-ci est arrêté, choisissez **Start (Démarrer)**.
![\[La liste déroulante Actions avec l'option Démarrer sélectionnée.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/ec-start.png)
1. Surveillez l'état du cluster élastique. Si vous avez démarré le cluster, vous pouvez recommencer à l'utiliser lorsqu'il sera *disponible*. Pour de plus amples informations, veuillez consulter [Déterminer le statut d'un cluster](db-cluster-status.md).
![\[Colonne d'état du tableau des clusters indiquant les statuts disponibles et de départ.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/ec-starting-status.png)
------
#### [ Using the AWS CLI ]
Les exemples de code suivants vous montrent comment arrêter un cluster élastique dans l'état actif ou disponible, ou démarrer un cluster élastique arrêté.
Pour arrêter un cluster élastique à l'aide de AWS CLI, utilisez l'`stop-cluster`opération. Pour démarrer un cluster arrêté, utilisez l'opération `start-cluster`. Les deux opérations utilisent le paramètre `--cluster-arn`.
**Paramètre :**
+ **--cluster-arn** : obligatoire. Identifiant ARN du cluster élastique que vous souhaitez arrêter ou démarrer.
**Example — Pour arrêter un cluster élastique à l'aide du AWS CLI**
Dans l'exemple suivant, remplacez chacune *user input placeholder* par vos propres informations.
Le code suivant arrête le cluster élastique avec un ARN de`arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2`.
Le cluster élastique doit être actif ou disponible.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic stop-cluster \
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
Pour Windows :
```
aws docdb-elastic stop-cluster ^
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
**Example — Pour démarrer un cluster élastique à l'aide du AWS CLI**
Dans l'exemple suivant, remplacez chacune *user input placeholder* par vos propres informations.
Le code suivant démarre le cluster élastique avec un ARN de`arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2`.
Le cluster élastique doit actuellement être arrêté.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic start-cluster \
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
Pour Windows :
```
aws docdb-elastic start-cluster ^
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
------
## Opérations que vous pouvez effectuer sur un cluster élastique arrêté
Vous ne pouvez pas modifier la configuration d'un cluster élastique Amazon DocumentDB lorsque celui-ci est arrêté. Vous devez démarrer le cluster avant d’effectuer des opérations d’administration de ce type.
Amazon DocumentDB applique toute maintenance planifiée à votre cluster élastique arrêté uniquement après son redémarrage. Au bout de sept jours, Amazon DocumentDB démarre automatiquement un cluster élastique arrêté afin qu'il ne prenne pas trop de retard dans son état de maintenance. Lorsque le cluster élastique redémarrera, les partitions du cluster recommenceront à vous être facturées.
Lorsqu'un cluster élastique est arrêté, Amazon DocumentDB n'effectue aucune sauvegarde automatique et ne prolonge pas la période de conservation des sauvegardes.
# Gestion des clusters élastiques Amazon DocumentDB
**Topics**
+ [Afficher les actions de maintenance du cluster élastique en attente](#view-elastic-cluster-maintenance)
+ [Mises à jour du moteur de cluster élastique](#elastic-cluster-engine-updates)
+ [Mises à jour du système d'exploitation du cluster élastique](#elastic-cluster-os-updates)
Amazon DocumentDB effectue régulièrement la maintenance des ressources du cluster élastique Amazon DocumentDB. La maintenance implique le plus souvent des mises à jour du moteur de base de données (maintenance du cluster élastique) ou du système d'exploitation sous-jacent du cluster élastique (mises à jour du système d'exploitation). 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 clusters élastiques Amazon DocumentDB dès qu'elles sont disponibles.
Les correctifs du moteur de base de données nécessitent que vous mettiez vos clusters élastiques 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 élastique Amazon DocumentDB.
Les clusters élastiques ont leurs propres fenêtres de maintenance respectives. Les modifications du cluster élastique que vous avez choisi de ne pas appliquer immédiatement sont appliquées pendant la fenêtre de maintenance. Par défaut, lorsque vous créez un cluster élastique, Amazon DocumentDB attribue une fenêtre de maintenance à votre cluster élastique. Vous pouvez choisir la fenêtre de maintenance lors de la création d'un cluster élastique. 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).
## Afficher les actions de maintenance du cluster élastique en attente
Vous pouvez voir si une mise à jour de maintenance est disponible pour votre cluster élastique en utilisant 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.
+ Planifiez les actions de maintenance pour qu'elles démarrent pendant la période de candidature sélectionné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.
Utilisez l' AWS CLI opération suivante pour déterminer les actions de maintenance en attente. Répertoriez toutes les actions de maintenance en attente :
```
aws docdb-elastic list-pending-maintenance-actions
```
Le résultat de cette opération ressemble à ce qui suit (format JSON) :
```
{
'ResourcePendingMaintenanceActions': [
{
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'ENGINE_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'string',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
},
],
'NextToken': 'string'
}
```
Obtenir une action de maintenance en attente (le cas échéant) sur une donnée `resourceArn` :
```
aws docdb-elastic get-pending-maintenance-action --resource-arn string-arn
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'ENGINE_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'string',
'CurrentApplyDate': 'string',
'Description': 'string'
}
]
}
}
```
Paramètres :
+ `ResourceArn`—Le nom de ressource Amazon (ARN) Amazon DocumentDB de la ressource à laquelle s'applique l'action de maintenance en attente.
+ `Action`: l'action de maintenance en attente est appliquée à la ressource.
Valeurs valides :
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ `AutoAppliedAfterDate`—Premier créneau de maintenance après cette date. `NEXT_MAINTENANCE OPT_IN`est ignoré dans ce cas.
+ `ForcedApplyDate`—Appliqué quelle que soit la fenêtre de maintenance. `IMMEDIATE OPT_IN`est ignoré dans ce cas.
+ `OptInStatus`—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.
+ `APPLY_ON`—Appliquez l'action de maintenance à la date d'application spécifiée, quelle que soit la fenêtre de maintenance suivante pour la ressource.
+ `UNDO_OPT_IN`—Annulez toute demande existante `NEXT_MAINTENANCE` ou `APPLY_ON` acceptez-la.
+ `CurrentApplyDate`—Affiché si tel opt-in-type est `APPLY_ON` le cas.
+ `Description`: description de l'option pour l'action de maintenance.
## Mises à jour du moteur de cluster élastique
Avec Amazon DocumentDB, vous pouvez choisir à quel moment appliquer les opérations de maintenance. Vous pouvez décider à quel moment Amazon DocumentDB applique les mises à jour à l'aide du. AWS CLI
Appliquer les actions de maintenance en attente :
```
aws docdb-elastic apply-pending-maintenance-action
--resource-arn string-arn
--apply-action string-enum
--opt-in-type string-enum
[--apply-on string-date-range]
```
Paramètres :
+ **--resource-arn**—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 valides :
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ **--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.
+ `APPLY_ON`—Appliquez l'action de maintenance à la date d'application spécifiée, quelle que soit la fenêtre de maintenance suivante pour la ressource.
+ `UNDO_OPT_IN`—Annulez toute demande existante `NEXT_MAINTENANCE` ou `APPLY_ON` acceptez-la.
+ **[--apply-on]**—Obligatoire si opt-in-type c'est `APPLY_ON` le cas. Format : `yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm` (Cette option utilise l'heure UTC. L'heure de début peut être n'importe quand dans le futur, entre un minimum de 30 minutes et un maximum de 14 jours, ou la force/apply date de l'action en attente, selon la première éventualité. La plage horaire du début à la fin peut aller d'un minimum de 30 minutes à un maximum de 8 heures.)
Le résultat de cette opération ressemble à ce qui suit (format JSON) :
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'SECURITY_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'IMMEDIATE',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
}
}
```
Paramètres :
+ `ResourceArn`—Le nom de ressource Amazon (ARN) Amazon DocumentDB de la ressource à laquelle s'applique l'action de maintenance en attente.
+ `Action`: l'action de maintenance en attente est appliquée à la ressource.
Valeurs valides :
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ `AutoAppliedAfterDate`—Premier créneau de maintenance après cette date. `NEXT_MAINTENANCE OPT_IN`est ignoré dans ce cas.
+ `ForcedApplyDate`—Appliqué quelle que soit la fenêtre de maintenance. `IMMEDIATE OPT_IN`est ignoré dans ce cas.
+ `OptInStatus`—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.
+ `APPLY_ON`—Appliquez l'action de maintenance à la date d'application spécifiée, quelle que soit la fenêtre de maintenance suivante pour la ressource.
+ `UNDO_OPT_IN`—Annulez toute demande existante `NEXT_MAINTENANCE` ou `APPLY_ON` acceptez-la.
+ `CurrentApplyDate`—Affiché si tel opt-in-type est `APPLY_ON` le cas.
+ `Description`: description de l'option pour l'action de maintenance.
### 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 depuis le AWS CLI, trois dates sont répertoriées :
+ `CurrentApplyDate`: date à laquelle l'action de maintenance sera appliquée soit immédiatement, soit lors de la fenêtre de maintenance suivante. Si la maintenance est facultative, cette valeur peut être nulle.
+ `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.
### Actions de maintenance créées par l'utilisateur
En tant qu'utilisateur du DBelastic cluster Amazon Document, vous pouvez initier des mises à jour des configurations de vos clusters.
**Actualisation du mot de passe principal du cluster**
```
aws docdb-elastic update-cluster
--cluster-arn string-arn
[--admin-user-password string]
[--auth-type string-enum]
[--apply-method string-enum]
[--apply-on string-date-range]
#... other parameters of the API that follow here are not relevant for this configuration
```
Paramètres :
+ **--cluster-arn**—Le nom de ressource Amazon (ARN) Amazon DocumentDB de la ressource à laquelle l'action de maintenance sera appliquée.
+ **[--admin-user-password]**: le mot de passe associé à l'utilisateur administrateur.
+ **[--auth-type]**: le type d'authentification utilisé pour déterminer où récupérer le mot de passe utilisé pour accéder au cluster élastique. Les types valides sont `PLAIN_TEXT` ou`SECRET_ARN`.
+ **[--apply-method]**: valeur qui indique le type de méthode appliquée. Les valeurs autorisées sont `IMMEDIATE` et `APPLY_ON`. La valeur par défaut est `IMMEDIATE`.
+ **[--apply-on]**—Obligatoire si `apply-method` c'est `APPLY_ON` le cas. Format : `yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm` (Cette option utilise l'heure UTC. L'heure de début peut être fixée à tout moment dans le futur, entre un minimum de 30 minutes et un maximum de 14 jours. La plage horaire du début à la fin peut aller d'un minimum de 30 minutes à un maximum de 8 heures.)
Le résultat de cette opération ressemble à ce qui suit (format JSON) :
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'MASTER_USER_PASSWORD_UPDATE',
'OptInStatus': 'APPLY_ON',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
}
}
```
### 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 élastique n'est pas disponible pendant cette période uniquement si des modifications du système (telles qu'une modification de l'opération de stockage à grande échelle) sont appliquées et nécessitent une interruption. Il n'est pas disponible uniquement pendant le temps minimum requis pour apporter les modifications nécessaires.
La valeur par défaut est une fenêtre de 30 minutes sélectionnée au hasard sur une période de 8 heures pour chaque région Amazon Web Services, survenant un jour aléatoire de la semaine.
Pour modifier la fenêtre de maintenance, voir[Modification des configurations de clusters élastiques](elastic-managing.md#elastic-modify).
## Mises à jour du système d'exploitation du cluster élastique
Les clusters élastiques 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 d'un cluster élastique Amazon DocumentDB.
La plupart des mises à jour du système d'exploitation pour les clusters élastiques Amazon DocumentDB sont facultatives et ne sont pas soumises à une date précise pour les appliquer. Toutefois, si vous n'appliquez pas ces mises à jour pendant un certain temps, elles peuvent éventuellement devenir nécessaires et automatiquement appliquées pendant la période de maintenance de vos clusters. 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 à votre cluster élastique Amazon DocumentDB dès qu'elles sont disponibles et de définir le créneau de maintenance de votre cluster au moment qui vous convient, en fonction des besoins de votre entreprise.