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 Amazon DocumentDB
Pour gérer un cluster 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, modifier et supprimer des instances et des clusters. La `AmazonDocDBFullAccess` politique fournit toutes les autorisations requises pour administrer un cluster Amazon DocumentDB.
Les rubriques suivantes expliquent comment effectuer différentes tâches lorsque vous travaillez avec des clusters Amazon DocumentDB, notamment la création, la suppression, la modification, la connexion et l'affichage de clusters.
**Topics**
+ [Comprendre les clusters](db-clusters-understanding.md)
+ [Paramètres du cluster](db-cluster-parameters.md)
+ [Configurations de stockage en cluster](db-cluster-storage-configs.md)
+ [Déterminer le statut d'un cluster](db-cluster-status.md)
+ [Cycle de vie d'un cluster](db-cluster-life-cycle.md)
+ [Dimensionnement des clusters](db-cluster-manage-performance.md)
+ [Clonage d'un volume pour un cluster](db-cluster-cloning.md)
+ [Comprendre la tolérance aux pannes des clusters](db-cluster-fault-tolerance.md)
# Comprendre les clusters
Amazon DocumentDB sépare le calcul du stockage, et décharge la réplication et la sauvegarde des données vers le volume du cluster. Un volume de cluster fournit une couche de stockage durable, fiable et hautement disponible qui réplique les données de six façons dans trois zones de disponibilité. Les réplicas permettent une haute disponibilité des données et une mise à l'échelle en lecture. Chaque cluster peut redimensionner jusqu'à 15 répliques.
| Nom | Description | Opérations d'API (Verbes) |
| --- | --- | --- |
| Cluster | Il se compose d'une ou de plusieurs instances, et d'un volume de stockage de clusters qui gère les données pour ces instances. | `create-db-cluster` `delete-db-cluster` `describe-db-clusters` `modify-db-cluster` |
| Instance | La lecture et l'écriture de données sur le volume de stockage du cluster se font via des instances. Il existe deux types d'instances dans un cluster : une instance principale et un réplica. Un cluster possède toujours une instance principale et peut comporter de 0 à 15 répliques. | `create-db-instance` `delete-db-instance` `describe-db-instances` `modify-db-instance` `describe-orderable-db-instance-options` `reboot-db-instance` |
| Volume de cluster | un volume virtuel de stockage de base de données qui couvre trois zones de disponibilité, chacune d'entre elles ayant deux copies des données de cluster. | N/A |
| Instance principale | Prend en charge les opérations de lecture et d'écriture, et effectue toutes les modifications de données du volume de cluster. Chaque cluster possède une seule instance principale. | N/A |
| Instance de réplica | Prend uniquement en charge les opérations de lecture. Chaque cluster Amazon DocumentDB peut comporter jusqu'à 15 instances de réplication en plus de l'instance principale. Plusieurs réplicas distribuent la charge de travail en lecture. En plaçant les réplicas dans des zones de disponibilité distinctes, vous pouvez aussi accroître la disponibilité de la base de données. | N/A |
| Point de terminaison de cluster | Point de terminaison pour un cluster Amazon DocumentDB qui se connecte à l'instance principale actuelle du cluster. Chaque cluster Amazon DocumentDB possède un point de terminaison de cluster et une instance principale. | N/A |
| Point de terminaison du lecteur | Point de terminaison pour un cluster Amazon DocumentDB qui se connecte à l'une des répliques disponibles pour ce cluster. Chaque cluster Amazon DocumentDB possède un point de terminaison lecteur. S'il existe plusieurs répliques, le point de terminaison du lecteur dirige chaque demande de connexion vers l'une des répliques Amazon DocumentDB. | N/A |
| Point de terminaison d’instance | Point de terminaison pour une instance d'un cluster Amazon DocumentDB qui se connecte à une instance spécifique. Chaque instance d'un cluster, quel que soit le type d'instance, a son propre point de terminaison d'instance unique. | N/A |
# Paramètres du cluster Amazon DocumentDB
Lorsque vous créez ou modifier un cluster, il est important de comprendre quels paramètres sont immuables et lesquels sont modifiables, après la création du cluster. Le tableau suivant répertorie tous les paramètres qui sont spécifiques à un cluster. Comme indiqué dans le tableau, certains sont modifiables, d'autres ne le sont pas.
**Note**
Ces paramètres ne doivent pas être confondus avec les groupes de paramètres du cluster Amazon DocumentDB et leurs paramètres. Pour plus d'informations sur les groupes de paramètres de cluster, consultez [Gestion des groupes de paramètres du cluster Amazon DocumentDB](cluster_parameter_groups.md).
| Paramètre | Adaptabilité | Remarques |
| --- | --- | --- |
| DBClusterIdentifier | Oui | Contraintes d'affectation de noms : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/db-cluster-parameters.html) |
| Engine | Non | Doit indiquer docdb. |
| BackupRetentionPeriod | Oui | Doit être comprise entre 1 et 35 jours. |
| DBClusterParameterGroupName | Oui | Contraintes d'affectation de noms : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/db-cluster-parameters.html) |
| DBSubnetGroupName | Non | Une fois qu'un cluster a été créé, vous ne pouvez pas modifier son sous-réseau. |
| EngineVersion | Non | La valeur peut être 5.0.0 (par défaut)4.0.0, ou3.6.0. |
| KmsKeyId | Non | Si vous choisissez de chiffrer votre cluster, vous ne pouvez pas modifier la AWS KMS clé que vous avez utilisée pour chiffrer votre cluster. |
| MasterUsername | Non | Une fois qu'un cluster a été créé, vous ne pouvez pas modifier le `MasterUsername`. Contraintes d'affectation de noms : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/db-cluster-parameters.html) |
| MasterUserPassword | Oui | Contraintes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/db-cluster-parameters.html) |
| Port | Oui | Le numéro de port s'applique à toutes les instances dans le cluster. |
| PreferredBackupWindow | Oui | |
| PreferredMaintenanceWindow | Oui | |
| StorageEncrypted | Non | Si vous choisissez de chiffrer votre cluster, il ne peut pas être non chiffré. |
| StorageType | Oui | Type de stockage pour le cluster de base de données : Standard (`standard`) ou I/O-Optimized (`iopt1`). Valeur par défaut : `standard` Ce paramètre peut être configuré avec `CreateDBCluster` et`ModifyDBCluster`. Pour de plus amples informations, veuillez consulter [Configurations de stockage en cluster Amazon DocumentDB](db-cluster-storage-configs.md). |
| Tags | Oui | |
| VpcSecurityGroupIds | Non | Une fois qu'un cluster a été créé, vous ne pouvez pas modifier le VPC dans lequel réside le cluster. |
# Configurations de stockage en cluster Amazon DocumentDB
À partir d'Amazon DocumentDB 5.0, les clusters basés sur des instances prennent en charge deux types de configuration de stockage :
+ **Stockage standard Amazon DocumentDB** : conçu pour les clients ayant une consommation faible à modérée I/O . Si vous pensez que vos I/O coûts seront inférieurs à 25 % de l'ensemble de votre cluster Amazon DocumentDB, cette option peut être idéale pour vous. Avec la configuration de stockage standard d'Amazon DocumentDB, vous êtes facturé sur une pay-per-request I/O base en plus des frais d'instance et de stockage. Cela signifie que votre facturation peut varier d'un cycle à l'autre en fonction de l'utilisation. La configuration est adaptée pour répondre aux I/O exigences fluctuantes de votre application.
+ **Stockage optimisé pour les E/S Amazon DocumentDB** : conçu pour les clients qui privilégient la prévisibilité des prix ou qui ont des applications intensives. I/O Les I/O-optimized configuration offers improved performance, increased throughput, and reduced latency for customers with I/O intensive workloads. If you expect your I/O costs to exceed 25% of your total Amazon DocumentDB cluster costs, this option offers enhanced price performance. With the Amazon DocumentDB I/O-optimized storage configuration, you won't be charged based on I/O opérations, garantissant des coûts prévisibles à chaque cycle de facturation. La configuration stabilise les coûts tout en améliorant les performances.
Vous pouvez passer de vos clusters de bases de données existants une fois tous les 30 jours à Amazon DocumentDB. L'I/O-optimized storage. You can switch back to Amazon DocumentDB standard storage at any time. The next date to modify the storage configuration to I/Ooptimisation peut être suivie à l'aide de la `describe-db-clusters` commande en utilisant AWS CLI ou via la page AWS Management Console de configuration du cluster.
Vous pouvez créer un nouveau cluster de bases de données incluant la configuration optimisée pour les E/S d'Amazon DocumentDB ou convertir vos clusters de bases de données existants en quelques clics [AWS Management Console](https://console.aws.amazon.com/docdb/), en modifiant un seul paramètre dans le [AWS Command Line Interface (AWS CLI)](https://aws.amazon.com/cli/) ou via. [AWS SDKs](https://aws.amazon.com/developer/tools/) Aucune interruption de service ou aucun redémarrage des instances n'est requis pendant ou après la modification de la configuration du stockage.
![\[Image : tableau décrivant les différences entre le stockage standard Amazon DocumentDB et le stockage optimisé.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/io-diagram-1.png)
## Création d'un cluster optimisé pour les E/S
------
#### [ Using the AWS Management Console ]
Pour créer ou modifier un cluster optimisé pour les E/S à l'aide de : AWS Management Console
1. **Sur la console de gestion Amazon DocumentDB, sous **Clusters**, choisissez **Create** ou sélectionnez le cluster et choisissez **Actions**, puis choisissez Modify.**
1. Si vous créez un nouveau cluster, assurez-vous de choisir Cluster **basé sur une instance** dans la section **Type de cluster** (il s'agit de l'option par défaut).
![\[Image : capture d'écran de console des options de type de cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/create-cluster/cc-type.png)
1. Dans la section **Configuration**, sous **Configuration du stockage en cluster**, choisissez **Amazon DocumentDB** I/O-Optimized.
![\[Image : capture d'écran de console des options de configuration du stockage en cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/storage-config-1.png)
1. Terminez la création ou la modification de votre cluster et choisissez **Créer un cluster** ou **Modifier le cluster**.
Pour le processus complet de création d'un cluster, voir[Création d'un cluster et d'une instance principale à l'aide du AWS Management Console](db-cluster-create.md#db-cluster-create-con).
Pour le processus complet de modification du cluster, voir[Modification d'un cluster Amazon DocumentDB](db-cluster-modify.md).
------
#### [ Using the AWS CLI ]
Pour créer un cluster optimisé pour les E/S à l'aide de : AWS CLI
Dans les exemples suivants, remplacez chacune *user input placeholder* par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb create-db-cluster \
--db-cluster-identifier sample-cluster \
--engine docdb \
--engine-version 5.0.0 \
--storage-type iopt1 \
--deletion-protection \
--master-username username \
--master-user-password password
```
Pour Windows :
```
aws docdb create-db-cluster ^
--db-cluster-identifier sample-cluster ^
--engine docdb ^
--engine-version 5.0.0 ^
--storage-type iopt1 ^
--deletion-protection ^
--master-username username ^
--master-user-password password
```
------
## Analyse des coûts pour déterminer la configuration du stockage
Avec Amazon DocumentDB, vous avez la possibilité de choisir votre configuration de stockage pour chaque cluster de base de données dont vous disposez. Afin de répartir correctement vos clusters entre les clusters standard et les clusters optimisés pour les E/S, vous pouvez suivre vos coûts Amazon DocumentDB par cluster. Pour ce faire, vous pouvez ajouter des balises aux clusters existants, activer le balisage de répartition des coûts dans votre [AWS Billing and Cost Management tableau de bord](https://aws.amazon.com/pricing/) et analyser vos coûts pour un cluster donné dans le [AWS Cost Explorer Service](https://aws.amazon.com/aws-cost-management/aws-cost-explorer/). Pour plus d'informations sur l'analyse des coûts, consultez notre blog [Utilisation des balises de répartition des coûts](https://aws.amazon.com/blogs/database/using-cost-allocation-tags-with-amazon-documentdb-with-mongodb-compatibility/).
# Déterminer le statut d'un cluster
Vous pouvez déterminer le statut d'un cluster à l'aide du AWS Management Console ou AWS CLI.
------
#### [ Using the AWS Management Console ]
Utilisez la procédure suivante pour connaître l'état de votre cluster Amazon DocumentDB à l'aide du 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. Dans la colonne **Identifiant de cluster**, recherchez le nom du cluster qui vous intéresse. Ensuite, pour trouver le statut du cluster, allez à la colonne **Status (Statut)**, comme indiqué ci-dessous.
![\[Capture d'écran de la page des clusters avec un exemple de cluster montrant le statut actif.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/db-cluster-status-con.png)
------
#### [ Using the AWS CLI ]
Utilisez l'`describe-db-clusters`opération pour connaître l'état de votre cluster Amazon DocumentDB à l'aide du. AWS CLI
Le code suivant trouve le statut du cluster `sample-cluster`.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
Pour Windows :
```
aws docdb describe-db-clusters ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
La sortie de cette opération ressemble à ceci (format JSON).
```
[
[
"sample-cluster",
"available"
]
]
```
------
# Cycle de vie du cluster Amazon DocumentDB
Le cycle de vie d'un cluster Amazon DocumentDB inclut la création, la description, la modification et la suppression du cluster. Cette section fournit des informations sur la façon de réaliser ces processus.
**Topics**
+ [Création d’un cluster](db-cluster-create.md)
+ [Décrire les clusters](db-cluster-view-details.md)
+ [Modification d’un cluster](db-cluster-modify.md)
+ [Détermination de la maintenance en attente](db-cluster-determine-pending-maintenance.md)
+ [Correctif mettant à jour la version du moteur d'un cluster](db-cluster-version-upgrade.md)
+ [Arrêt et démarrage d’un cluster](db-cluster-stop-start.md)
+ [Suppression d’un cluster](db-cluster-delete.md)
# Création d'un cluster Amazon DocumentDB
Un cluster Amazon DocumentDB se compose d'instances et d'un volume de cluster qui représente les données du cluster. Le volume de cluster est répliqué six fois dans trois zones de disponibilité en tant que volume virtuel unique. Le cluster contient une instance principale et, éventuellement, jusqu'à 15 instances de réplica.
Les sections suivantes montrent comment créer un cluster Amazon DocumentDB à l'aide du AWS Management Console ou du. AWS CLI Vous pouvez ensuite ajouter des instances de réplica pour ce cluster. Lorsque vous utilisez la console pour créer votre cluster Amazon DocumentDB, une instance principale est automatiquement créée pour vous en même temps. Si vous utilisez le AWS CLI pour créer votre cluster Amazon DocumentDB, une fois que l'état du cluster est *disponible*, vous devez créer l'instance principale pour ce cluster.
## Conditions préalables
Les conditions requises pour créer un cluster Amazon DocumentDB sont les suivantes.
Si vous n'en avez pas Compte AWS, procédez comme suit pour en créer un.
**Pour vous inscrire à un Compte AWS**
1. Ouvrez l'[https://portal.aws.amazon.com/billing/inscription.](https://portal.aws.amazon.com/billing/signup)
1. Suivez les instructions en ligne.
Dans le cadre de la procédure d’inscription, vous recevrez un appel téléphonique ou un SMS et vous saisirez un code de vérification en utilisant le clavier numérique du téléphone.
Lorsque vous vous inscrivez à un Compte AWS, un *Utilisateur racine d'un compte AWS*est créé. Par défaut, seul l’utilisateur racine a accès à l’ensemble des Services AWS et des ressources de ce compte. La meilleure pratique de sécurité consiste à attribuer un accès administratif à un utilisateur, et à utiliser uniquement l’utilisateur racine pour effectuer les [tâches nécessitant un accès utilisateur racine](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
### Prérequis pour VPC
Vous ne pouvez créer un cluster Amazon DocumentDB que dans un Amazon Virtual Private Cloud (Amazon VPC). Votre Amazon VPC doit disposer d'au moins un sous-réseau dans chacune des deux zones de disponibilité au moins pour que vous puissiez l'utiliser avec un cluster Amazon DocumentDB. En répartissant vos instances de cluster entre les zones de disponibilité, vous vous assurez qu'elles sont disponibles dans votre cluster dans le cas peu probable d'une défaillance de la zone de disponibilité.
### Conditions requises pour les sous-réseaux
Lorsque vous créez un cluster Amazon DocumentDB, vous devez choisir un VPC et le groupe de sous-réseaux correspondant au sein de ce VPC pour lancer votre cluster. Les sous-réseaux déterminent la zone de disponibilité et la plage d'adresses IP au sein de cette zone de disponibilité que vous souhaitez utiliser pour lancer une instance. Dans le cadre de cette présentation, nous utiliserons les termes *sous-réseau* et *zone de disponibilité* indifféremment. Un groupe de sous-réseaux est un ensemble nommé de sous-réseaux (ou de zones de disponibilité). Un groupe de sous-réseaux vous permet de spécifier les zones de disponibilité que vous souhaitez utiliser pour lancer des instances Amazon DocumentDB. Par exemple, dans un cluster avec trois instances et pour une haute disponibilité, il est recommandé que chacune de ces instances soit mise en service dans des zones de disponibilité distinctes. Par conséquent, si une zone de disponibilité s'arrête, cela affecte une seule instance.
Les instances Amazon DocumentDB peuvent actuellement être mises en service dans un maximum de trois zones de disponibilité. Même si un groupe de sous-réseaux possède plus de trois sous-réseaux, vous ne pouvez utiliser que trois de ces sous-réseaux pour créer un cluster Amazon DocumentDB. Par conséquent, lors de la création d'un groupe de sous-réseaux, il est recommandé de choisir les trois sous-réseaux sur lesquels vous souhaitez déployer vos instances. Dans l'est des États-Unis (Virginie du Nord), votre groupe de sous-réseaux peut comporter six sous-réseaux (ou zones de disponibilité). Toutefois, lorsqu'un cluster Amazon DocumentDB est provisionné, Amazon DocumentDB choisit trois de ces zones de disponibilité qu'il utilise pour provisionner les instances.
Supposons, par exemple, que lorsque vous créez un cluster, Amazon DocumentDB choisisse les zones de disponibilité \$11A, 1B et 1C\$1. Si vous essayez de créer une instance dans la zone de disponibilité \$11D\$1, l'appel d'API échoue. Toutefois, si vous choisissez de créer une instance sans spécifier de zone de disponibilité particulière, Amazon DocumentDB choisit une zone de disponibilité en votre nom. Amazon DocumentDB utilise un algorithme pour équilibrer la charge des instances entre les zones de disponibilité afin de vous aider à atteindre une haute disponibilité. Par exemple, si trois instances sont allouées, elles le seront par défaut sur trois zones de disponibilité et non toutes dans une seule zone.
**Recommandations :**
+ Sauf si vous avez une raison précise, créez toujours un groupe de sous-réseaux avec trois sous-réseaux. Cela permet de s'assurer que les clusters avec au moins trois instances sont en mesure de bénéficier d'une disponibilité plus importante, les instances étant allouées sur trois zones de disponibilité.
+ Répartissez toujours les instances sur plusieurs zones de disponibilité pour obtenir une haute disponibilité. Ne placez jamais toutes les instances d'un cluster dans une seule zone de disponibilité.
+ Des événements de basculement pouvant se produire à n'importe quel moment, vous ne devez pas supposer qu'une instance principale ou des instances de réplica sont toujours placées dans une zone de disponibilité spécifique.
### Prérequis supplémentaires
Voici quelques prérequis supplémentaires pour créer un cluster Amazon DocumentDB :
+ Si vous vous connectez à AWS l'aide d'informations d'identification Gestion des identités et des accès AWS (IAM), votre compte IAM doit disposer de politiques IAM qui accordent les autorisations requises pour effectuer des opérations Amazon DocumentDB.
Si vous utilisez un compte IAM pour accéder à la console Amazon DocumentDB, vous devez d'abord vous y connecter AWS Management Console avec votre compte IAM. [Accédez ensuite à la console Amazon DocumentDB à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
+ Si vous voulez adapter les paramètres de configuration de votre cluster, vous devez spécifier un groupe de paramètres de cluster et un groupe de paramètres avec les valeurs de paramètre requises. Pour de plus amples informations sur la création ou la modification d'un groupe de paramètres de cluster ou d'un groupe de paramètres, veuillez consulter [Gestion des groupes de paramètres du cluster Amazon DocumentDB](cluster_parameter_groups.md).
+ Vous devez déterminer le numéro de TCP/IP port que vous souhaitez spécifier pour votre cluster. Les pare-feux de certaines entreprises bloquent les connexions aux ports par défaut d'Amazon DocumentDB. Si le pare-feu de votre entreprise bloque le port par défaut, choisissez un autre port pour le cluster. Toutes les instances d'un cluster utilisent le même port.
## Création d'un cluster et d'une instance principale à l'aide du AWS Management Console
Les procédures suivantes décrivent comment utiliser la console pour lancer un cluster Amazon DocumentDB avec une ou plusieurs instances.
### Création d'un cluster : utilisation des paramètres par défaut
**Pour créer un cluster avec des instances à l'aide des paramètres par défaut à l'aide du 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. Si vous souhaitez créer votre cluster dans une région Région AWS autre que l'est des États-Unis (Virginie du Nord), choisissez la région dans la liste située dans le coin supérieur droit de la console.
1. Dans le volet de navigation, sélectionnez **Clusters**, puis **Create (Créer)**.
**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. Sur la page **Créer un cluster Amazon DocumentDB**, complétez le volet **Configuration**.
1. **Identifiant du cluster** : acceptez le nom fourni par Amazon DocumentDB ou entrez un nom pour votre cluster, par exemple,. **sample-cluster**
Contraintes d'attribution de nom relatives à un cluster :
+ 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.
+ Doit être unique pour tous les clusters d'Amazon RDS, Neptune et Amazon Compte AWS DocumentDB par région.
1. **Version du moteur** : acceptez la version du moteur par défaut 5.0.0 ou choisissez éventuellement 8.0.0, 4.0.0 ou 3.6.0.
1. **Classe d'instance** : acceptez la valeur par défaut `db.r5.large` ou choisissez la classe d'instance de votre choix dans la liste.
1. **Nombre d'instances** : dans la liste, choisissez le nombre d'instances que vous souhaitez créer avec ce cluster. La première instance est l'instance principale, et toutes les autres instances sont des instances de réplica en lecture seule. Vous pouvez ajouter et supprimer des instances ultérieurement, si nécessaire. Par défaut, un cluster Amazon DocumentDB est lancé avec trois instances (une instance principale et deux répliques).
1. Complétez la section **Configuration du stockage en cluster**.
Choisissez **Amazon DocumentDB Standard (par défaut) ou **Amazon DocumentDB**** I/O-Optimized. Pour de plus amples informations, veuillez consulter [Configurations de stockage en cluster Amazon DocumentDB](db-cluster-storage-configs.md).
1. Complétez le volet **Authentication (Authentification)**.
1. **Nom d'utilisateur** —Entrez le nom de l'utilisateur principal. Pour vous connecter à votre cluster, vous devez utiliser le nom d'utilisateur principal.
Contraintes de dénomination des utilisateurs principaux :
+ La longueur est de [1 à 63] caractères alphanumériques.
+ Le premier caractère doit être une lettre.
+ Ne peut pas être un mot réservé du moteur de base de données.
1. Choisissez l'une des options de mot de passe suivantes :
+ **Géré dans AWS Secrets Manager** —Choisissez cette option si vous AWS Secrets Manager souhaitez gérer automatiquement le mot de passe de votre utilisateur principal.
Si vous choisissez cette option, configurez la clé KMS en créant la vôtre ou en utilisant une clé créée par Secrets Manager.
+ **Autogéré** : choisissez cette option si vous souhaitez gérer vous-même le mot de passe de votre utilisateur principal. Si vous choisissez cette option, entrez un mot de passe pour l'utilisateur principal, puis confirmez-le. Pour vous connecter à votre cluster, vous devez utiliser le mot de passe de l'utilisateur principal.
Contraintes du mot de passe :
+ Entre 8 et 100 caractères ASCII imprimables.
+ Tous les caractères ASCII imprimables peuvent être utilisés, à l'exception des suivants :
+ **/** (barre oblique)
+ **"** (guillemets doubles)
+ **@** (symbole arobase)
1. Au bas de l'écran, choisissez l'une des actions suivantes :
+ Pour créer le cluster maintenant, choisissez **Create cluster (Créer un cluster)**.
+ Pour ne pas créer de cluster, choisissez **Cancel (Annuler)**.
+ Pour configurer plus précisément le cluster avant de le créer, choisissez **Show additional configurations (Afficher les configurations supplémentaires)**, puis poursuivez avec la page [Création d'un cluster : configurations supplémentaires](#db-cluster-create-con-additional-configs).
Les configurations couvertes dans la section **Additional Configurations (Configurations supplémentaires)** sont :
+ **Paramètres réseau** : le groupe de sécurité `default` VPC est utilisé par défaut.
+ **Options du cluster** : le port par défaut est 27017 et le groupe de paramètres par défaut.
+ **Chiffrement : le chiffrement** est activé par défaut à l'aide de la `(default) aws/rds` clé.
**Important**
Une fois qu'un cluster est chiffré, il ne peut pas être déchiffré.
+ **Sauvegarde** — La valeur par défaut est de conserver les sauvegardes pendant 1 jour et de laisser Amazon DocumentDB choisir la fenêtre de sauvegarde.
+ **Exportations de journaux** : par défaut, les journaux d'audit ne sont pas exportés vers CloudWatch Logs.
+ **Maintenance** — Par défaut, Amazon DocumentDB choisit la fenêtre de maintenance.
+ **Protection contre la suppression** : protégez votre cluster contre toute suppression accidentelle. La valeur par défaut pour les clusters créés à l'aide de la console est *enabled (activé)*.
Si vous acceptez les paramètres par défaut maintenant, vous pouvez modifier la plupart d'entre elles ultérieurement en modifiant le cluster.
1. Activez la connexion entrante pour le groupe de sécurité de votre cluster.
Si vous n'avez pas modifié les paramètres par défaut de votre cluster, vous avez créé un cluster à l’aide du groupe de sécurité par défaut pour le VPC par défaut dans la région donnée. Pour vous connecter à Amazon DocumentDB, vous devez activer les connexions entrantes sur le port 27017 (ou le port de votre choix) pour le groupe de sécurité de votre cluster.
**Pour ajouter une connexion entrante au groupe de sécurité de votre cluster**
1. Connectez-vous à la console Amazon EC2 AWS Management Console et ouvrez-la à l'adresse. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)
1. Dans la section **Resources (Ressources)** de la fenêtre principale, choisissez **Security groups (Groupes de sécurité)**.
![\[Image : liste de ressources mettant en évidence l'option de lien Security Groups.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/docdb-ec2-security-groups.png)
1. Dans la liste des groupes de sécurité, localisez celui que vous avez utilisé lors de la création de votre cluster (il s’agit probablement du groupe de sécurité *par défaut*) et choisissez le champ à gauche de son nom.
![\[Image : liste des groupes de sécurité mettant en évidence un groupe de sécurité dont la case est cochée.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/docdb-ec2-default-sg.png)
1. Dans le menu **Actions**, choisissez **Edit inbound rules (Modifier les règles entrantes)**, puis choisissez ou saisissez les contraintes de règle.
1. **Type** —Dans la liste, choisissez le protocole à ouvrir au trafic réseau.
1. **Protocole** —Dans la liste, choisissez le type de protocole.
1. **Plage de ports** : pour une règle personnalisée, entrez un numéro de port ou une plage de ports. Veillez à ce que le numéro de port ou la plage des ports comprenne le port spécifié lors de la création de votre cluster (par défaut, 27017).
1. **Source** : indique le trafic qui peut atteindre votre instance. Dans la liste, choisissez le trafic source. Si vous choisissez **Custom (Personnalisé)**, spécifiez une adresse IP unique ou une plage d'adresses IP dans une notation CIDR (par exemple, 203.0.113.5/32).
1. **Description** —Entrez une description pour cette règle.
1. Lorsque vous avez terminé de créer la règle, choisissez **Save (Enregistrer)**.
### Création d'un cluster : configurations supplémentaires
Si vous souhaitez accepter les paramètres par défaut pour votre cluster, vous pouvez ignorer les étapes suivantes et choisir **Create cluster (Créer un cluster)**.
1. Complétez le volet **Network settings (Paramètres de réseau)**.
![\[Capture d'écran : volet Network settings (Paramètres de réseau) affichant les étapes de configuration des paramètres réseau.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/create-db-cluster-console-network-settings.png)
1. **Virtual Private Cloud (VPC)** —Dans la liste, choisissez l'Amazon VPC dans lequel vous souhaitez lancer ce cluster.
1. **Groupe de sous-réseaux** : dans la liste, choisissez le groupe de sous-réseaux que vous souhaitez utiliser pour ce cluster.
1. **Groupes de sécurité VPC** : dans la liste, choisissez le groupe de sécurité VPC pour ce cluster.
1. Complétez le volet **Cluster options (Options du cluster)**.
![\[Capture d'écran présentant le volet des options du cluster avec les étapes de configuration des paramètres pour le cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/create-db-cluster-console-cluster-options.png)
1. **Port de base de données** : utilisez les flèches haut et bas pour définir le TCP/IP port que les applications utiliseront pour se connecter à votre instance.
1. **Groupe de paramètres de cluster** : dans la liste des groupes de paramètres, choisissez le groupe de paramètres de cluster pour ce cluster.
1. Complétez le volet **Encryption (Chiffrement)**.
![\[Capture d'écran présentant le volet de chiffrement avec les étapes de configuration du chiffrement pour le cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/encrypt-at-rest.png)
1. **E ncryption-at-rest** —Choisissez l'une des options suivantes :
+ **Activer le chiffrement** : valeur par défaut. Toutes les données au repos sont chiffrées. Si vous choisissez de chiffrer vos données, vous ne pouvez pas annuler cette action.
+ **Désactiver le chiffrement** : vos données ne sont pas chiffrées.
1. **AWS Clé KMS** : elle n'est disponible que si vous cryptez vos données. Dans la liste, choisissez la clé que vous souhaitez utiliser pour chiffrer les données de ce cluster. La valeur par défaut est `(default) aws/rds`.
Si vous choisissez **Enter a key ARN (Entrer un ARN de clé),** vous devez indiquer un Amazon Resource Name (ARN) pour la clé.
1. Complétez le volet **Backup (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/create-db-cluster-console-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. **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.
1. **Durée** : dans la liste, choisissez le nombre d'heures à allouer à la création de sauvegardes automatiques.
1. Complétez le volet **Exportations de journaux** en sélectionnant les types de journaux que vous souhaitez exporter vers CloudWatch Logs.
![\[Capture d'écran présentant le volet des exportations de journaux avec les étapes de configuration de la journalisation DML du cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/create-db-cluster-console-log-exports.png)
+ **Journaux d'audit** : sélectionnez cette option pour activer l'exportation des journaux d'audit vers Amazon CloudWatch Logs. Si vous sélectionnez **Audit logs (Journaux d'audit)**, vous devez activer `audit_logs` dans le groupe de paramètres personnalisés du cluster. Pour de plus amples informations, veuillez consulter [Audit des événements Amazon DocumentDB](event-auditing.md).
+ **Journaux du profileur** : sélectionnez cette option pour activer l'exportation des journaux du profileur d'opérations vers Amazon Logs. CloudWatch Si vous sélectionnez **Profiler logs (Journaux du profileur)**, vous devez également modifier les paramètres suivants dans le groupe de paramètres personnalisés du cluster :
+ `profiler`—Réglé sur. `enabled`
+ `profiler_threshold_ms`—Définissez une valeur `[0-INT_MAX]` pour définir le seuil pour les opérations de profilage.
+ `profiler_sampling_rate`: définissez une valeur pour `[0.0-1.0]` définir le pourcentage d'opérations lentes par rapport au profil.
Pour de plus amples informations, veuillez consulter [Profilage des opérations Amazon DocumentDB](profiling.md).
1. Complétez le volet **Maintenance**.
![\[Capture d'écran du volet Maintenance affichant les étapes de configuration de la fenêtre de maintenance pour le cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/create-db-cluster-console-maintenance.png)
1. Choisissez l'une des options suivantes
+ **Sélectionnez une fenêtre** : vous pouvez spécifier le jour de la semaine, l'heure de début UTC et la durée pendant laquelle Amazon DocumentDB doit effectuer la maintenance de votre cluster.
1. **Jour de début** : dans la liste, choisissez le jour de la semaine pour démarrer la maintenance du cluster.
1. **Heure de début** : dans les listes, choisissez l'heure et la minute (UTC) pour démarrer la maintenance.
1. **Durée** : dans la liste, choisissez le temps à allouer à la maintenance du cluster. Si la maintenance ne peut pas être effectuée dans le laps de temps spécifié, le processus se poursuit au-delà de la durée spécifiée jusqu'à ce qu'il se termine.
+ **Aucune préférence** : Amazon DocumentDB choisit le jour de la semaine, l'heure de début et la durée de la maintenance.
1. Si vous souhaitez ajouter une ou plusieurs balises à ce cluster, complétez le volet **Tags (Balises)**.
![\[Capture d'écran de la case à cocher d’activation de la protection contre la suppression, qui est sélectionnée.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/create-db-cluster-console-tags.png)
Pour chaque balise que vous souhaitez ajouter au cluster, répétez les étapes suivantes. Vous pouvez en avoir jusqu'à 10 sur un cluster.
1. Sélectionnez **Add Tags (Ajouter des balises)**.
1. Entrez la **clé** de la balise.
1. Vous pouvez, si vous le souhaitez, entrer la **valeur** de la balise.
Pour supprimer une balise, choisissez **Remove tag (Supprimer une balise)**.
1. **Deletion Protection (Protection contre la suppression)** est activée par défaut lorsque vous créez un cluster à l’aide de la console. Pour désactiver la protection contre la suppression, désactivez **Enable deletion protection (Activer la protection contre la suppression)**. Lorsque cette option est activée, la protection contre la suppression empêche la suppression d’un cluster. Pour supprimer un cluster protégé contre la suppression, vous devez tout d'abord modifier le cluster pour désactiver la protection contre la suppression.
![\[Capture d'écran de la case à cocher d’activation de la protection contre la suppression, qui est sélectionnée.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/create-db-cluster-console-deletion-protection.png)
Pour plus d'informations sur la protection de la suppression, consultez [Suppression d'un cluster Amazon DocumentDB](db-cluster-delete.md).
1. Pour créer le cluster, choisissez **Create cluster (Créer un cluster)**. Sinon, sélectionnez **Annuler**.
## Création d'un cluster à l'aide du AWS CLI
Les procédures suivantes décrivent comment utiliser le AWS CLI pour lancer un cluster Amazon DocumentDB et créer une réplique Amazon DocumentDB.
**Parameters**
+ **--db-cluster-identifier** : obligatoire. Une chaîne en minuscules qui identifie ce cluster.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/db-cluster-create.html)
+ **--engine** : obligatoire. Doit indiquer **docdb**.
+ **--deletion-protection \$1 --no-deletion-protection**—Facultatif. Lorsque la protection contre la suppression est activée, elle empêche la suppression d’un cluster. Lorsque vous utilisez le AWS CLI, le paramètre par défaut est de désactiver la protection contre la suppression.
Pour plus d'informations sur la protection de la suppression, consultez [Suppression d'un cluster Amazon DocumentDB](db-cluster-delete.md).
+ **--storage-type standard \$1 iopt1**—Facultatif. Valeur par défaut : **standard**. Configuration de stockage du cluster. Les valeurs valides sont `standard` (Standard) ou `iopt1` (optimisées pour les E/S).
+ **--master-username** : obligatoire. Nom de l'utilisateur authentifié.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/db-cluster-create.html)
+ **--master-user-password**—Facultatif. Mot de passe de l'utilisateur authentifié.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/db-cluster-create.html)
+ **--manage-master-user-password**—Facultatif. Amazon DocumentDB génère le mot de passe de l'utilisateur principal et le gère tout au long de son cycle de vie dans Secrets Manager.
Pour accéder à des paramètres supplémentaires, consultez [CreateDBCluster](API_CreateDBCluster.md).
**Pour lancer un cluster Amazon DocumentDB à l'aide du AWS CLI**
Pour créer un cluster Amazon DocumentDB, appelez le. `create-db-cluster` AWS CLI La AWS CLI commande suivante crée un cluster Amazon DocumentDB nommé `sample-cluster` avec la protection contre la suppression activée. Pour plus d'informations sur la protection contre les suppressions, consultez[Suppression d'un cluster Amazon DocumentDB](db-cluster-delete.md).
Il s'`--engine-version`agit également d'un paramètre facultatif qui utilise par défaut la dernière version majeure du moteur. La version actuelle du moteur par défaut est 5.0.0 (remarque : Amazon DocumentDB 8.0 est disponible mais doit être explicitement spécifiée). Lorsque de nouvelles versions majeures du moteur sont publiées, la version par défaut du moteur est mise à jour pour `--engine-version` refléter la dernière version majeure du moteur. Par conséquent, pour les charges de travail de production, et en particulier celles qui dépendent de scripts, d'automatisation ou de CloudFormation modèles, nous vous recommandons de spécifier explicitement la `--engine-version` version majeure prévue.
**Note**
Si un `db-subnet-group-name` ou n'`vpc-security-group-id`est pas spécifié, Amazon DocumentDB utilisera le groupe de sous-réseaux et le groupe de sécurité Amazon VPC par défaut pour la région donnée.
Pour Linux, macOS ou Unix :
```
aws docdb create-db-cluster \
--db-cluster-identifier sample-cluster \
--engine docdb \
--engine-version 5.0.0 \
--deletion-protection \
--master-username masteruser \
--master-user-password password
```
Pour Windows :
```
aws docdb create-db-cluster ^
--db-cluster-identifier sample-cluster ^
--engine docdb ^
--engine-version 5.0.0 ^
--deletion-protection ^
--master-username masteruser ^
--master-user-password password
```
La sortie de cette opération ressemble à ceci (format JSON).
```
{
"DBCluster": {
"StorageEncrypted": false,
"DBClusterMembers": [],
"Engine": "docdb",
"DeletionProtection" : "enabled",
"ClusterCreateTime": "2018-11-26T17:15:19.885Z",
"DBSubnetGroup": "default",
"EngineVersion": "5.0.0",
"MasterUsername": "masteruser",
"BackupRetentionPeriod": 1,
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"DBClusterIdentifier": "sample-cluster",
"MultiAZ": false,
"DBClusterParameterGroup": "default.docdb5.0",
"PreferredBackupWindow": "09:12-09:42",
"DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
"PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
"Port": 27017,
"Status": "creating",
"ReaderEndpoint": "sample-cluster.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
"AssociatedRoles": [],
"HostedZoneId": "ZNKXTT8WH85VW",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"AvailabilityZones": [
"us-east-1a",
"us-east-1c",
"us-east-1e"
],
"Endpoint": "sample-cluster.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
}
}
```
La création du cluster prend quelques minutes. Vous pouvez utiliser le AWS Management Console ou AWS CLI pour surveiller l'état de votre cluster. Pour de plus amples informations, veuillez consulter [Surveillance de l'état d'un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
**Important**
Lorsque vous utilisez le AWS CLI pour créer un cluster Amazon DocumentDB, aucune instance n'est créée. Par conséquent, vous devez créer explicitement une instance principale et tous les réplicas des instances dont vous avez besoin. Vous pouvez utiliser la console ou AWS CLI créer les instances. Pour de plus amples informations, veuillez consulter [Ajouter une instance Amazon DocumentDB à un cluster](db-instance-add.md).
Pour plus d'informations, consultez le [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html)manuel *Amazon DocumentDB API Reference*.
# Décrire les clusters Amazon DocumentDB
Vous pouvez utiliser la console de gestion Amazon DocumentDB ou le AWS CLI pour consulter des informations telles que les points de terminaison de connexion, les groupes de sécurité et les groupes de paramètres relatifs à vos clusters Amazon DocumentDB. VPCs
Pour plus d’informations, consultez les ressources suivantes :
+ [Surveillance de l'état d'un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md)
+ [Trouver les points de terminaison d'un cluster](db-cluster-endpoints-find.md)
------
#### [ Using the AWS Management Console ]
Utilisez la procédure suivante pour afficher les détails d'un cluster Amazon DocumentDB spécifié à l'aide de la 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**.
**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 nom du cluster dont vous voulez afficher les détails. Les informations sur le cluster sont organisées en six groupes :
+ **Résumé** : informations générales sur le cluster, notamment la version du moteur, l'état du cluster, la maintenance en attente et le statut de son groupe de paramètres.
+ **Connectivité et sécurité** : la section **Connect** répertorie les points de terminaison de connexion permettant de se connecter à ce cluster à l'aide du shell mongo ou d'une application. La section **Security Groups (Groupes de sécurité)** répertorie les groupes de sécurité associés à ce cluster ainsi que leur ID de VPC et leurs descriptions.
+ **Configuration** : la section **Détails du cluster** répertorie les informations relatives au cluster, notamment le nom de ressource Amazon (ARN), le point de terminaison et le groupe de paramètres du cluster. Elle répertorie également les informations de sauvegarde du cluster, les détails de maintenance ainsi que les paramètres de sécurité et de réseau. La section **Cluster instances (Instances de cluster)** répertorie toutes les instances appartenant à votre cluster avec l'état du rôle et du groupe de paramètres de cluster de chaque instance.
+ **Surveillance** — Les métriques Amazon CloudWatch Logs pour ce cluster. Pour de plus amples informations, veuillez consulter [Surveillance d'Amazon DocumentDB avec CloudWatch](cloud_watch.md).
+ **Événements et tags** — La section **Événements récents** répertorie les événements récents pour ce cluster. Amazon DocumentDB conserve un enregistrement des événements liés à vos clusters, instances, instantanés, groupes de sécurité et groupes de paramètres de cluster. Ces informations comprennent la date, l'heure et le message associés à chaque événement. La section **Tags (Balises)** répertorie les balises attachées à ce cluster.
------
#### [ Using the AWS CLI ]
Pour afficher les détails de vos clusters Amazon DocumentDB à l'aide de AWS CLI, utilisez la `describe-db-clusters` commande comme indiqué dans les exemples ci-dessous. Pour plus d'informations, consultez le document [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html)de référence de l'*API de gestion des ressources Amazon DocumentDB*.
**Note**
Pour certaines fonctionnalités de gestion telles que la gestion du cycle de vie des clusters et des instances, Amazon DocumentDB utilise une technologie opérationnelle partagée avec Amazon RDS. Le paramètre de `filterName=engine,Values=docdb` filtre renvoie uniquement les clusters Amazon DocumentDB.
**Example**
**Exemple 1 : répertorier tous les clusters Amazon DocumentDB**
Le AWS CLI code suivant répertorie les détails de tous les clusters Amazon DocumentDB d'une région.
```
aws docdb describe-db-clusters --filter Name=engine,Values=docdb
```
Le résultat de cette opération ressemble à ceci.
```
{
"DBClusters": [
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-1",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-2",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-3",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
}
]
}
```
**Example**
**Exemple 2 : répertorier tous les détails d'un cluster Amazon DocumentDB spécifié**
Le AWS CLI code suivant répertorie les détails du cluster`sample-cluster`.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-clusters \
--filter Name=engine,Values=docdb \
--db-cluster-identifier sample-cluster
```
Pour Windows :
```
aws docdb describe-db-clusters ^
--filter Name=engine,Values=docdb ^
--db-cluster-identifier sample-cluster
```
Le résultat de cette opération ressemble à ceci.
```
{
"DBClusters": [
{
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-east-1c",
"us-east-1a",
"us-east-1d"
],
"BackupRetentionPeriod": 2,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
"EarliestRestorableTime": "2023-11-07T22:34:08.148000+00:00",
"Endpoint": "sample-cluster.node.us-east-1.amazon.com",
"ReaderEndpoint": "sample-cluster.node.us-east-1.amazon.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "5.0.0",
"LatestRestorableTime": "2023-11-10T07:21:16.772000+00:00",
"Port": 27017,
"MasterUsername": "chimeraAdmin",
"PreferredBackupWindow": "22:22-22:52",
"PreferredMaintenanceWindow": "sun:03:01-sun:03:31",
"ReadReplicaIdentifiers": [],
"DBClusterMembers": [
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-9084c2ec",
"Status": "active"
}
],
"HostedZoneId": "Z06853723JYKYBXTJ49RB",
"StorageEncrypted": false,
"DbClusterResourceId": "cluster-T4LGLANHVAPGQYYULWUDKLVQL4",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"AssociatedRoles": [],
"IAMDatabaseAuthenticationEnabled": false,
"ClusterCreateTime": "2023-11-06T18:05:41.568000+00:00",
"EngineMode": "provisioned",
"DeletionProtection": false,
"HttpEndpointEnabled": false,
"CopyTagsToSnapshot": false,
"CrossAccountClone": false,
"DomainMemberships": [],
"TagList": [],
"StorageType": "iopt1",
"AutoMinorVersionUpgrade": false,
"NetworkType": "IPV4",
"IOOptimizedNextAllowedModificationTime": "2023-12-07T18:05:41.580000+00:00"
}
]
}
```
**Example**
**Exemple 3 : Répertorier les informations spécifiques d'un cluster Amazon DocumentDB**
Pour répertorier un sous-ensemble des détails des clusters à l'aide du AWS CLI, ajoutez un qui spécifie les membres du cluster `--query` que l'`describe-db-clusters`opération doit répertorier. Le paramètre `--db-cluster-identifier` est l'identifiant du cluster particulier dont vous souhaitez afficher les détails. Pour plus d'informations sur les requêtes, voir [Comment filtrer la sortie avec l'`--query`option](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output.html#controlling-output-filter) dans le *guide de AWS Command Line Interface l'utilisateur*.
L'exemple suivant répertorie les instances d'un cluster Amazon DocumentDB.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-clusters \
--filter Name=engine,Values=docdb \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterMembers]'
```
Pour Windows :
```
aws docdb describe-db-clusters ^
--filter Name=engine,Values=docdb ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterMembers]'
```
Le résultat de cette opération ressemble à ceci.
```
[
[
[
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": false,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
]
]
]
```
------
# Modification d'un cluster Amazon DocumentDB
Pour modifier un cluster, le cluster doit être à l'état *disponible* . Vous ne pouvez pas modifier un cluster qui est arrêté. Si le cluster est arrêté, commencez par démarrer le cluster, attendez que le cluster devienne *disponible*, puis apportez les modifications souhaitées. Pour de plus amples informations, veuillez consulter [Arrêt et démarrage d'un cluster Amazon DocumentDB](db-cluster-stop-start.md).
------
#### [ Using the AWS Management Console ]
Utilisez la procédure suivante pour modifier un cluster Amazon DocumentDB spécifique à l'aide de la console.
**Pour modifier un cluster 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. Spécifiez le cluster que vous souhaitez modifier en cliquant sur le bouton situé à gauche du nom du cluster.
1. Choisissez **Actions**, puis **Modify (Modifier)**.
1. Dans le volet **Modify cluster: (Modifier le cluster : )**, apportez les modifications souhaitées. Vous pouvez effectuer des modifications dans les domaines suivants :
+ **Spécifications du cluster** : nom du cluster, groupes de sécurité et gestion des informations d'identification.
+ **Configuration du stockage** en cluster : mode de stockage des données du cluster. Choisissez entre une configuration standard et une configuration optimisée pour les E/S.
+ **Options du cluster** : port et groupe de paramètres du cluster.
+ **Sauvegarde** : période de conservation des sauvegardes et fenêtre de sauvegarde du cluster.
+ **Exportations de journaux** : activez ou désactivez l'exportation des journaux d'audit ou de profilage.
+ **Maintenance** —Définissez la fenêtre de maintenance du cluster.
+ **Protection contre la suppression** : activez ou désactivez la protection contre la suppression sur le cluster. Par défaut, la protection contre la suppression est activée.
1. Lorsque vous avez terminé, choisissez **Continue (Continuer)** pour afficher un récapitulatif de vos modifications.
1. Si vous êtes satisfait de vos modifications, vous pouvez choisir **Modify cluster (Modifier le cluster)** pour modifier votre cluster. Vous pouvez également choisir **Back (Précédent)** ou **Cancel (Annuler)** pour modifier ou annuler vos modifications, respectivement.
L'application de vos modifications prend quelques minutes. Vous pouvez uniquement utiliser le cluster lorsqu'il présente le statut *disponible*. Vous pouvez surveiller l'état du cluster en utilisant la console ou la AWS CLI. Pour de plus amples informations, veuillez consulter [Surveillance de l'état d'un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
------
#### [ Using the AWS CLI ]
Utilisez l'opération `modify-db-cluster` pour modifier le cluster spécifié à l'aide de l’ AWS CLI. Pour plus d'informations, consultez le [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html)manuel *Amazon DocumentDB API Reference*.
**Parameters**
+ **--db-cluster-identifier** : obligatoire. Identifiant du cluster Amazon DocumentDB que vous allez modifier.
+ **--backup-retention-period**—Facultatif. Nombre de jours de conservation des sauvegardes automatiques. Les valeurs valides sont comprises entre 1 et 35.
+ **--storage-type**—Facultatif. Configuration de stockage du cluster. Les valeurs valides sont `standard` (Standard) ou `iopt1` (optimisées pour les E/S).
+ **--db-cluster-parameter-group-name**—Facultatif. Le nom du groupe de paramètres de cluster à utiliser pour le cluster.
+ **--manage-master-user-password**—Facultatif. Amazon DocumentDB génère le mot de passe de l'utilisateur principal et le gère tout au long de son cycle de vie dans Secrets Manager.
+ **--rotate-master-user-password**—Facultatif. Secrets Manager génère une nouvelle version secrète pour le secret existant. La nouvelle version du secret contient le nouveau mot de passe de l'utilisateur principal. Amazon DocumentDB modifie le mot de passe de l'utilisateur principal du cluster afin qu'il corresponde au mot de passe de la nouvelle version secrète.
Vous devez spécifier l'**--apply-immediately**option lorsque vous faites pivoter le mot de passe principal.
+ **--master-user-password**—Facultatif. Le nouveau mot de passe de l'utilisateur principal de la base de données.
Contraintes du mot de passe :
+ La longueur est de [8 à 100] caractères ASCII imprimables.
+ Tous les caractères ASCII imprimables peuvent être utilisés, à l'exception des suivants :
+ **/** (barre oblique)
+ **"** (guillemets doubles)
+ **@** (symbole arobase)
+ **--new-db-cluster-identifier**—Facultatif. Le nouvel identificateur de cluster pour le cluster lors du changement de nom d'un cluster. Cette valeur est stockée sous la forme d’une chaîne en minuscules.
Contraintes d'affectation de noms :
+ 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.
+ Doit être unique pour tous les clusters d'Amazon RDS, Amazon Neptune et Amazon DocumentDB par région Compte AWS.
+ **--preferred-backup-window**—Facultatif. L'intervalle de temps quotidien (en UTC) au cours duquel les sauvegardes automatiques sont créées.
+ Format : `hh24:mm-hh24:mm`
+ **--preferred-maintenance-window**—Facultatif. Intervalle de temps hebdomadaire (en UTC) pendant lequel peut se produire la maintenance du système.
+ Format : `ddd:hh24:mm-ddd:hh24:mm`
+ Jours valables : `Sun`, `Mon`, `Tue`, `Wed`, `Thu`, `Fri`, et `Sat`.
+ **--deletion-protection**ou **--no-deletion-protection** —Facultatif. Indique si la protection contre la suppression doit être activée sur ce cluster. La protection contre la suppression empêche toute suppression accidentelle d’un cluster tant que cette fonction n’est pas désactivée. Pour de plus amples informations, veuillez consulter [Suppression d'un cluster Amazon DocumentDB](db-cluster-delete.md).
+ **--apply-immediately**ou **--no-apply-immediately** —Utilisez `--apply-immediately` pour effectuer la modification immédiatement. Utilisez `--no-apply-immediately` pour effectuer la modification au cours de la fenêtre de maintenance suivante de votre cluster.
**Example**
Le code suivant modifie la période de conservation des sauvegardes pour le cluster `sample-cluster`.
Pour Linux, macOS ou Unix :
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--apply-immediately \
--backup-retention-period 7
```
Pour Windows :
```
aws docdb modify-db-cluster ^
--db-cluster-identifier sample-cluster ^
--apply-immediately ^
--backup-retention-period 7
```
Le résultat de cette opération ressemble à ceci.
```
{
"DBCluster": {
"BackupRetentionPeriod": 7,
"DbClusterResourceId": "cluster-VDP53QEWST7YHM36TTXOPJT5YE",
"Status": "available",
"DBClusterMembers": [
{
"PromotionTier": 1,
"DBClusterParameterGroupStatus": "in-sync",
"DBInstanceIdentifier": "sample-cluster-instance",
"IsClusterWriter": true
}
],
"ReadReplicaIdentifiers": [],
"AvailabilityZones": [
"us-east-1b",
"us-east-1c",
"us-east-1a"
],
"ReaderEndpoint": "sample-cluster.cluster-ro-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"PreferredMaintenanceWindow": "sat:09:51-sat:10:21",
"EarliestRestorableTime": "2018-06-17T00:06:19.374Z",
"StorageEncrypted": false,
"MultiAZ": false,
"AssociatedRoles": [],
"MasterUsername": "",
"DBClusterIdentifier": "sample-cluster",
"VpcSecurityGroups": [
{
"Status": "active",
"VpcSecurityGroupId": "sg-77186e0d"
}
],
"HostedZoneId": "Z2SUY0A1719RZT",
"LatestRestorableTime": "2018-06-18T21:17:05.737Z",
"AllocatedStorage": 1,
"Port": 27017,
"Engine": "docdb",
"DBClusterParameterGroup": "default.docdb3.4",
"Endpoint": "sample-cluster.cluster-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBSubnetGroup": "default",
"PreferredBackupWindow": "00:00-00:30",
"EngineVersion": "3.4",
"ClusterCreateTime": "2018-06-06T19:25:47.991Z",
"IAMDatabaseAuthenticationEnabled": false
}
}
```
L'application de vos modifications prend quelques minutes. Vous pouvez uniquement utiliser le cluster lorsqu'il présente le statut *disponible*. Vous pouvez surveiller l'état du cluster en utilisant la console ou la AWS CLI. Pour de plus amples informations, veuillez consulter [Surveillance de l'état d'un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
------
# Détermination de la maintenance en attente
Vous pouvez déterminer si vous disposez de la dernière version du moteur Amazon DocumentDB en déterminant si vous avez une maintenance de cluster en attente.
------
#### [ Using the AWS Management Console ]
Vous pouvez utiliser le AWS Management Console pour déterminer si un cluster a une maintenance en attente.
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. Recherchez la colonne **Maintenance** afin de déterminer si un cluster est en attente de maintenance.
![\[Capture d'écran de la console montrant le champ de maintenance du cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/docdb-cluster-pending-maintenance.png)
**None (Aucune)** indique que le cluster exécute la dernière version du moteur. **Available (Disponible)** indique que le cluster est en attente de la maintenance, ce qui implique qu'une mise à niveau du moteur est nécessaire.
1. Si votre cluster est en attente de maintenance, poursuivez avec les étapes de la section [Exécution d'une mise à jour corrective de la version du moteur d'un cluster](db-cluster-version-upgrade.md).
------
#### [ Using the AWS CLI ]
Vous pouvez utiliser le AWS CLI pour déterminer si un cluster possède la dernière version du moteur en utilisant l'`describe-pending-maintenance-actions`opération avec les paramètres suivants.
**Parameters**
+ **--resource-identifier**—Facultatif. ARN d'accès à la ressource (cluster). Si ce paramètre n'est pas spécifié, les actions de maintenance en attente pour tous les clusters sont répertoriées.
+ **--region**—Facultatif. La région AWS dans laquelle vous voulez exécuter cette opération, par exemple `us-east-1`.
**Example**
Pour Linux, macOS ou Unix :
```
aws docdb describe-pending-maintenance-actions \
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster \
--region us-east-1
```
Pour Windows :
```
aws docdb describe-pending-maintenance-actions ^
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
--region us-east-1
```
Le résultat de cette opération ressemble à ceci.
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"PendingMaintenanceActionDetails": [
{
"Description": "New feature",
"Action": "db-upgrade",
"ForcedApplyDate": "2019-02-25T21:46:00Z",
"AutoAppliedAfterDate": "2019-02-25T07:41:00Z",
"CurrentApplyDate": "2019-02-25T07:41:00Z"
}
]
}
]
}
```
Si votre cluster est en attente de maintenance, poursuivez avec les étapes de la section [Exécution d'une mise à jour corrective de la version du moteur d'un cluster](db-cluster-version-upgrade.md).
------
# Exécution d'une mise à jour corrective de la version du moteur d'un cluster
Dans cette section, nous expliquerons comment déployer une mise à jour de correctif à l'aide du AWS Management Console ou du AWS CLI. Une mise à jour de correctif est une mise à jour de la même version du moteur (par exemple, la mise à jour d'une version du moteur 3.6 vers une version du moteur 3.6 plus récente). Vous pouvez le mettre à jour immédiatement ou lors de la prochaine fenêtre de maintenance de votre cluster. Pour déterminer si votre moteur a besoin d'une mise à jour, consultez[Détermination de la maintenance en attente](db-cluster-determine-pending-maintenance.md). Notez que lorsque vous appliquez la mise à jour, votre cluster subira des temps d'arrêt.
**Note**
Si vous essayez de passer d'une version majeure du moteur à une autre, par exemple de la version 3.6 à la version 5.0, reportez-vous à la section [Mise à niveau sur place de la version majeure d'Amazon DocumentDB](docdb-mvu.md) ou[Mise à niveau de votre cluster Amazon DocumentDB à l'aide de AWS Database Migration Service](docdb-migration.versions.md). Une mise à niveau de version majeure sur place ne prend en charge que docdb 5.0 comme version du moteur cible.
Deux exigences de configuration sont requises pour obtenir les dernières mises à jour des correctifs pour la version du moteur d'un cluster :
+ Le statut du cluster doit être *disponible*.
+ Le cluster doit exécuter une version antérieure du moteur.
------
#### [ Using the AWS Management Console ]
La procédure suivante applique les mises à jour des correctifs à la version du moteur de votre cluster à l'aide de la console. Vous avez la possibilité de procéder à la mise à jour immédiatement ou lors de la prochaine fenêtre de maintenance de votre 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**. Dans la liste des clusters, choisissez le bouton sur la gauche du cluster que vous voulez mettre à niveau. Le statut du cluster doit être *disponible*.
**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 le menu **Actions**, choisissez l'une des options suivantes. Ces options de menu sont sélectionnables uniquement si le cluster que vous avez choisi n'exécute pas la version la plus récente du moteur.
![\[Image : Actions de mise à niveau d'Amazon DocumentDB\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/docdb-upgrade-action.png)
+ **Mettre à niveau maintenant** —Lance immédiatement le processus de mise à niveau. Votre cluster est hors ligne pendant la mise à niveau vers la version la plus récente du moteur.
+ **Mise à niveau à la fenêtre suivante** : lance le processus de mise à niveau lors de la fenêtre de maintenance suivante du cluster. Votre cluster est hors ligne pendant la mise à niveau vers la version la plus récente du moteur.
1. Lorsque la fenêtre de confirmation s'ouvre, choisissez l'une des options suivantes :
+ **Mise** à niveau : pour mettre à niveau votre cluster vers la dernière version du moteur conformément au calendrier choisi à l'étape précédente.
+ **Annuler** : pour annuler la mise à niveau du moteur du cluster et continuer avec la version actuelle du moteur du cluster.
------
#### [ Using the AWS CLI ]
Vous pouvez appliquer des mises à jour de correctifs à votre cluster à l'aide de l'`apply-pending-maintenance-action`opération AWS CLI et avec les paramètres suivants.
**Parameters**
+ **--resource-identifier** : obligatoire. L'ARN du cluster Amazon DocumentDB que vous allez mettre à niveau.
+ **--apply-action** : obligatoire. Les valeurs suivantes sont autorisées. Pour mettre à niveau la version du moteur de votre cluster, utilisez `db-upgrade`.
+ **db-upgrade**
+ **system-update**
+ **--opt-in-type** : obligatoire. Les valeurs suivantes sont autorisées.
+ `immediate`—Appliquez immédiatement l'action de maintenance.
+ `next-maintenance`—Appliquez l'action de maintenance lors de la fenêtre de maintenance suivante.
+ `undo-opt-in`—Annulez toutes les demandes d'`next-maintenance`opt-in existantes.
**Example**
L'exemple de correctif suivant met à jour la version du moteur de `sample-cluster` vers la version 4.0.0.
Pour Linux, macOS ou Unix :
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \
--apply-action db-upgrade \
--opt-in-type immediate
```
Pour Windows :
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
--apply-action db-upgrade ^
--opt-in-type immediate
```
Le résultat de cette opération ressemble à ce qui suit.
```
{
"ResourcePendingMaintenanceActions": {
"ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
"PendingMaintenanceActionDetails": [
{
"CurrentApplyDate": "2019-02-20T20:57:06.904Z",
"Description": "Bug fixes",
"ForcedApplyDate": "2019-02-25T21:46:00Z",
"OptInStatus": "immediate",
"Action": "db-upgrade",
"AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
}
]
}
}
```
------
# Arrêt et démarrage d'un cluster Amazon DocumentDB
L'arrêt et le démarrage des clusters 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 et des instances à chaque fois que vous utilisez Amazon DocumentDB, vous pouvez arrêter temporairement toutes les instances de votre cluster lorsqu'elles ne sont pas nécessaires. Vous pouvez ensuite les redémarrer lorsque vous reprenez vos tests.
**Topics**
+ [Présentation de l’arrêt et du démarrage d’un cluster](#db-cluster-stop-start-overview)
+ [Opérations que vous pouvez effectuer sur un cluster arrêté](#db-cluster-stopped-operations)
## Présentation de l’arrêt et du démarrage d’un cluster
Pendant les périodes où vous n'avez pas besoin d'un cluster Amazon DocumentDB, vous pouvez arrêter toutes les instances de ce cluster en même temps. 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 simplifie les processus de configuration et de destruction des clusters utilisés à des fins de développement, de test ou d'activités similaires qui ne nécessitent pas une disponibilité continue. Vous pouvez arrêter et démarrer un cluster en utilisant AWS Management Console ou en AWS CLI une seule action, quel que soit le nombre d'instances présentes dans le cluster.
Pendant que votre cluster 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. Aucune heure d'instance ne vous est facturée. Amazon DocumentDB démarre automatiquement votre cluster au bout de sept jours afin qu'il ne prenne aucun retard par rapport aux mises à jour de maintenance requises. Lorsque votre cluster démarre après sept jours, vous êtes à nouveau facturé pour les instances dans le cluster. Pendant l'arrêt de votre cluster, vous ne pouvez pas interroger votre volume de stockage car l'interrogation nécessite que les instances soient à l'état disponible.
Lorsqu'un cluster Amazon DocumentDB est arrêté, ni le cluster ni ses instances ne peuvent être modifiés de quelque manière que ce soit. Cela inclut l'ajout ou la suppression d'instances, ou la suppression du cluster.
------
#### [ Using the AWS Management Console ]
La procédure suivante vous montre comment arrêter un cluster avec une ou plusieurs instances à l'état disponible, ou démarrer un cluster arrêté.
**Pour arrêter ou démarrer un cluster 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.
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**.
![\[Image : arrêt d’un cluster\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/db-cluster-stop.png)
Pour éviter d’activer le mécanisme de basculement, l'opération stoppe d'abord les instances de réplica, puis l'instance principale.
1. Dans la boîte de dialogue de confirmation, confirmez que vous souhaitez arrêter le cluster en choisissant **Stop cluster (Arrêter le cluster)**. Sinon, choisissez **Cancel (Annuler)** pour conserver le cluster en cours d'exécution.
![\[Image : démarrage d’un cluster\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/db-cluster-stop-confirm.png)
+ Si vous souhaitez démarrer un cluster et que celui-ci est arrêté, choisissez **Start (Démarrer)**.
![\[Image : démarrage d’un cluster\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/db-cluster-start.png)
1. Surveillez le statut du cluster et de ses instances. Si vous avez démarré le cluster, vous pouvez utiliser celui-ci et ses instances lorsqu’ils sont *disponibles*. Pour de plus amples informations, veuillez consulter [Déterminer le statut d'un cluster](db-cluster-status.md).
![\[Image : statut de l'arrêt et du démarrage de clusters\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/db-cluster-stop-start-status.png)
------
#### [ Using the AWS CLI ]
Les exemples de code suivants montrent comment arrêter un cluster avec une ou plusieurs instances à l'état disponible, ou démarrer un cluster arrêté.
Pour arrêter un cluster avec une ou plusieurs instances disponibles à l'aide de AWS CLI, utilisez l'`stop-db-cluster`opération. Pour démarrer un cluster arrêté, utilisez l'opération `start-db-cluster`. Les deux opérations utilisent le paramètre `--db-cluster-identifier`.
**Paramètre :**
+ **--db-cluster-identifier** : obligatoire. Le nom du cluster à arrêter ou démarrer.
**Example — Pour arrêter un cluster à l'aide du AWS CLI**
Le code suivant arrête le cluster `sample-cluster`. Le cluster doit avoir une ou plusieurs instances à l'état disponible.
Pour Linux, macOS ou Unix :
```
aws docdb stop-db-cluster \
--db-cluster-identifier sample-cluster
```
Pour Windows :
```
aws docdb stop-db-cluster ^
--db-cluster-identifier sample-cluster
```
**Example — Pour démarrer un cluster à l'aide du AWS CLI**
Le code suivant démarre le cluster `sample-cluster`. Le cluster doit être actuellement à l’arrêt.
Pour Linux, macOS ou Unix :
```
aws docdb start-db-cluster \
--db-cluster-identifier sample-cluster
```
Pour Windows :
```
aws docdb start-db-cluster ^
--db-cluster-identifier sample-cluster
```
------
## Opérations que vous pouvez effectuer sur un cluster arrêté
Lorsqu'un cluster Amazon DocumentDB est arrêté, vous pouvez effectuer une point-in-time restauration à tout moment pendant la période de conservation automatique des sauvegardes que vous avez spécifiée. Pour plus de détails sur la réalisation d'une point-in-time restauration, consultez[Restaurer à un point dans le temps](backup_restore-point_in_time_recovery.md).
Vous ne pouvez pas modifier la configuration d'un cluster Amazon DocumentDB, ou de l'une de ses instances, lorsque le cluster est arrêté. De même, vous ne pouvez pas ajouter ou supprimer des instances au niveau du cluster, ni supprimer le cluster si une ou plusieurs instances lui sont toujours associées. 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 arrêté uniquement après son redémarrage. Au bout de sept jours, Amazon DocumentDB démarre automatiquement un cluster arrêté afin qu'il ne prenne pas trop de retard dans son état de maintenance. Lorsque le cluster redémarre, vous êtes à nouveau facturé pour les instances dans le cluster.
Lorsqu'un cluster est arrêté, Amazon DocumentDB n'effectue aucune sauvegarde automatique et ne prolonge pas la période de conservation des sauvegardes.
# Suppression d'un cluster Amazon DocumentDB
Vous pouvez supprimer un cluster Amazon DocumentDB à l'aide du AWS Management Console ou du. AWS CLI Pour supprimer un cluster, celui-ci doit être à l'état *disponible* et ne doit pas avoir d'instances associées. Si le cluster est arrêté, commencez par démarrer le cluster, attendez que le cluster devienne *disponible*, puis supprimez le cluster. Pour de plus amples informations, veuillez consulter [Arrêt et démarrage d'un cluster Amazon DocumentDB](db-cluster-stop-start.md).
## Protection contre la suppression
Pour protéger votre cluster de toute suppression accidentelle, vous pouvez activer la *protection contre la suppression*. La protection contre la suppression est activée par défaut lorsque vous créez un cluster à l'aide de la console. Elle est toutefois désactivée par défaut si vous créez un cluster à l'aide de l' AWS CLI.
Amazon DocumentDB applique la protection contre la suppression à un cluster, que vous exécutiez l'opération de suppression à l'aide de la console ou du. AWS CLI Si la protection contre la suppression est activée, vous ne pouvez pas supprimer de cluster. Pour supprimer un cluster pour lequel la protection contre la suppression est activée, vous devez commencer par modifier le cluster et désactiver la protection contre la suppression.
Lorsque vous utilisez la console avec la protection contre la suppression activée sur un cluster, vous ne pouvez pas supprimer la dernière instance du cluster car cela supprime également le cluster. Vous pouvez supprimer la dernière instance d'un cluster protégé contre la suppression à l’aide de l’ AWS CLI. Toutefois, le cluster lui-même existe toujours, et vos données sont conservées. Vous pouvez accéder aux données en créant de nouvelles instances pour le cluster. Pour plus d'informations sur l'activation et la désactivation de la protection contre la suppression, consultez :
+ [Création d'un cluster Amazon DocumentDB](db-cluster-create.md)
+ [Modification d'un cluster Amazon DocumentDB](db-cluster-modify.md)
------
#### [ Using the AWS Management Console ]
Pour supprimer un cluster à l'aide du AWS Management Console, la protection contre la suppression doit être désactivée.
**Pour déterminer si la protection contre la suppression est activée 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**.
**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. Notez que dans la zone de navigation Clusters, la colonne **Identifiant du cluster** indique à la fois les clusters et les instances. Les instances sont répertoriées sous les clusters, comme dans la capture d'écran ci-dessous.
![\[Image : la boîte de navigation Clusters affichant une liste des liens de clusters existants et leurs liens d'instance correspondants.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/clusters.png)
1. Choisissez le nom du cluster et sélectionnez l'onglet **Configuration** . Dans la section **Cluster details (Détails du cluster)**, recherchez **Deletion protection (Protection contre la suppression)**. Si la protection contre la suppression est activée, modifiez le cluster pour la désactiver. Pour plus d'informations sur la modification d'un cluster, consultez [Modification d'un cluster Amazon DocumentDB](db-cluster-modify.md).
Lorsque **Deletion protection (Protection contre la suppression)** est désactivée, vous pouvez supprimer le cluster.
**Pour supprimer un cluster :**
1. Dans le panneau de navigation, choisissez **Clusters**.
1. Déterminez si le cluster possède des instances en consultant la colonne **Identifiant du cluster** pour les instances répertoriées en dessous. Avant de pouvoir supprimer un cluster, vous devez supprimer toutes ses instances. Pour de plus amples informations, veuillez consulter [Suppression d'une instance Amazon DocumentDB](db-instance-delete.md).
1. Selon si votre cluster a des instances, effectuez l'une des étapes suivantes.
+ Si le cluster n'a aucune instance, sélectionnez le bouton situé à gauche du nom du cluster et choisissez **Actions**. Dans le menu déroulant, choisissez **Delete (Supprimer)**. Renseignez la boîte de dialogue **Delete (Supprimer) **, puis choisissez **Delete (Supprimer)**.
+ Si le cluster a une ou plusieurs instances, procédez comme suit :
1. Dans le panneau de navigation, choisissez **Clusters**.
1. Supprimez chacune des instances du cluster en cochant la case à gauche du nom du cluster. Choisissez **Actions**, puis **Delete (Supprimer)**. Renseignez la boîte de dialogue **Delete (Supprimer) **, puis choisissez **Delete (Supprimer)**.
Lorsque vous supprimez la dernière instance, le cluster est également supprimé. Pour plus d'informations sur la suppression d'instances, consultez[Suppression d'une instance Amazon DocumentDB](db-instance-delete.md).
La suppression du cluster prend plusieurs minutes. Pour surveiller le statut du cluster, consultez [Surveillance de l'état d'un cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
------
#### [ Using the AWS CLI ]
Vous ne pouvez pas supprimer un cluster qui a des instances associées. Pour déterminer les instances associées à votre cluster, exécutez la commande `describe-db-clusters` et supprimez toutes les instances du cluster. Ensuite, si nécessaire, désactivez la protection contre la suppression de votre cluster et, enfin, supprimez le cluster.
1. **Tout d'abord, supprimer tous les instances de cluster.**
Pour déterminer quelles instances vous devez supprimer, exécutez la commande suivante.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
La sortie de cette opération ressemble à ceci (format JSON).
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
Si le cluster que vous souhaitez supprimer a des instances associées, supprimez-les comme indiqué ci-dessous.
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance
```
1. **Ensuite, désactivez la protection contre la suppression.**
L'utilisation AWS CLI de pour supprimer toutes les instances d'un cluster ne supprime pas le cluster. Vous devez également supprimer le cluster, mais pour ce faire, la protection contre la suppression doit être désactivée.
Pour déterminer si la protection contre la suppression est activée pour le cluster, exécutez la commande suivante.
**Astuce**
Pour connaître l'état de protection contre la suppression de tous vos clusters Amazon DocumentDB, omettez le paramètre. `--db-cluster-identifier`
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DeletionProtection]'
```
Le résultat de cette opération ressemble à ceci.
```
[
[
"sample-cluster",
"true"
]
]
```
Si la protection contre la suppression est activée pour le cluster, modifiez le cluster et désactivez la protection contre la suppression. Pour désactiver la protection contre la suppression sur le cluster, exécutez la commande suivante.
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--no-deletion-protection \
--apply-immediately
```
1. **Enfin, supprimez le cluster.**
Une fois que la protection contre la suppression est désactivée, vous pouvez supprimer le cluster. Pour supprimer un cluster, utilisez l'opération `delete-db-cluster` avec les paramètres suivants.
+ **--db-cluster-identifier** : obligatoire. Identifiant du cluster que vous souhaitez supprimer.
+ **--final-db-snapshot-identifier**—Facultatif. Si vous voulez un instantané final, vous devez inclure ce paramètre avec un nom pour l'instantané final. Vous devez inclure soit `--final-db-snapshot-identifier` ou `--skip-final-snapshot`.
Contraintes d'affectation de noms :
+ 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.
+ Doit être unique pour tous les clusters d'Amazon RDS, Amazon Neptune et Amazon DocumentDB par région Compte AWS.
+ **--skip-final-snapshot**—Facultatif. Utilisez ce paramètre uniquement si vous ne souhaitez pas prendre un instantané final avant de supprimer votre cluster. Le paramètre par défaut consiste à prendre un instantané final. Vous devez inclure soit `--final-db-snapshot-identifier` ou `--skip-final-snapshot`.
Le AWS CLI code suivant supprime le cluster `sample-cluster` avec un instantané final. L'opération échoue si des instances sont associées au cluster ou si la protection contre la suppression est activée.
**Example**
Pour Linux, macOS ou Unix :
```
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--final-db-snapshot-identifier sample-cluster-final-snapshot
```
Pour Windows :
```
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--final-db-snapshot-identifier sample-cluster-final-snapshot
```
**Example**
Le AWS CLI code suivant supprime le cluster `sample-cluster` sans prendre de capture finale.
Pour Linux, macOS ou Unix :
```
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--skip-final-snapshot
```
Pour Windows :
```
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--skip-final-snapshot
```
Le résultat de l'opération `delete-db-cluster` est le cluster que vous allez supprimer.
La suppression du cluster prend plusieurs minutes. Pour surveiller le statut du cluster, consultez [Surveillance de l'état d'un cluster](monitoring_docdb-cluster_status.md).
------
# Dimensionnement des clusters Amazon DocumentDB
Amazon DocumentDB vous permet de dimensionner le stockage et le calcul de vos clusters en fonction de vos besoins. Cette section décrit comment vous pouvez utiliser le dimensionnement du stockage, le dimensionnement des instances et le dimensionnement de la lecture pour gérer les performances et le dimensionnement de vos clusters et instances Amazon DocumentDB.
**Topics**
+ [Dimensionnement du stockage](#db-cluster-manage-scaling-storage)
+ [Mise à l’échelle d’instances](#db-cluster-manage-scaling-instance)
+ [Dimensionnement en lecture](#db-cluster-manage-scaling-reads)
+ [Evaluation de l'écriture](#db-cluster-manage-scaling-writes)
## Dimensionnement du stockage
Le stockage Amazon DocumentDB s'adapte automatiquement aux données de votre volume de cluster. À mesure que vos données augmentent, le volume de stockage de votre cluster augmente par incréments de 10 GiB, jusqu'à 128 TiB.
## Mise à l’échelle d’instances
Vous pouvez redimensionner votre cluster Amazon DocumentDB selon vos besoins en modifiant la classe d'instance pour chaque instance du cluster. Amazon DocumentDB prend en charge plusieurs classes d'instances optimisées pour Amazon DocumentDB.
Pour de plus amples informations, veuillez consulter [Modification d'une instance Amazon DocumentDB](db-instance-modify.md).
## Dimensionnement en lecture
Vous pouvez obtenir un dimensionnement de lecture pour votre cluster Amazon DocumentDB en créant jusqu'à 15 répliques Amazon DocumentDB dans le cluster. Chaque réplique Amazon DocumentDB renvoie les mêmes données depuis le volume du cluster avec un décalage de réplication minimal, généralement moins de 100 millisecondes après que l'instance principale a écrit une mise à jour. À mesure que votre trafic de lecture augmente, vous pouvez créer des répliques Amazon DocumentDB supplémentaires et vous y connecter directement pour répartir la charge de lecture de votre cluster. Les répliques Amazon DocumentDB ne doivent pas nécessairement appartenir à la même classe d'instance que l'instance principale.
Pour de plus amples informations, veuillez consulter [Ajouter une instance Amazon DocumentDB à un cluster](db-instance-add.md).
Pour augmenter l'échelle de lecture avec Amazon DocumentDB, nous vous recommandons de vous connecter à votre cluster en tant que jeu de répliques et de distribuer les lectures aux instances de réplication à l'aide des fonctionnalités de préférence de lecture intégrées de votre pilote. Pour plus d'informations, consultez [Connexion à Amazon DocumentDB en tant que jeu de répliques](connect-to-replica-set.md).
## Evaluation de l'écriture
Vous pouvez augmenter la capacité d'écriture de votre cluster Amazon DocumentDB en augmentant la taille de l'instance principale de votre cluster. Cette section fournit deux méthodes pour mettre à l'échelle l'instance principale de votre cluster en fonction de vos besoins. La première option vise à minimiser l'impact sur les applications, mais nécessite des étapes supplémentaires. La deuxième option offre plus de simplicité car elle comporte moins d'étapes, mais son impact potentiel sur votre application est plus important.
Selon votre application, vous pouvez choisir l'approche qui vous convient le mieux. Pour plus d'informations sur les tailles d'instance disponibles et les coûts, consultez la page de [tarification d'Amazon DocumentDB](https://aws.amazon.com/documentdb/pricing/).
1. **Optimisation pour une disponibilité et des performances élevées** : si vous vous connectez à votre cluster en [mode réplica set](connect-to-replica-set.md) (recommandé), vous pouvez utiliser le processus suivant pour minimiser l'impact sur votre application lors du dimensionnement de votre instance principale. Cette méthode minimise l'impact car elle préserve ou accroît la haute disponibilité de votre cluster, et ajoute des cibles de mise à l'échelle en lecture au cluster en tant qu'instances, au lieu de les mettre à jour.
1. Ajoutez un ou plusieurs réplicas du type d'instance plus important à votre cluster (voir [Ajouter une instance Amazon DocumentDB à un cluster](db-instance-add.md)). Nous recommandons que tous les réplicas soient du même type d'instance ou d'un type d'instance plus important que celui de l'instance principale. Cela évite une diminution involontaire des performances en écriture que provoquerait le basculement vers un type d'instance plus petit. Pour la plupart des clients, cela signifie doubler temporairement le nombre d'instances dans leur cluster, puis supprimer les réplicas plus petits une fois la mise à l'échelle terminée.
1. Définissez le niveau de basculement sur la priorité zéro pour tous les nouveaux réplicas, en veillant à ce qu'un réplica du type d'instance plus petit ait la priorité de basculement la plus élevée. Pour de plus amples informations, veuillez consulter [Contrôle de la cible de basculement](failover.md#failover-target_control).
1. Lancez un basculement manuel, ce qui entraînera la promotion de l'un des nouveaux réplicas en instance principale. Pour de plus amples informations, veuillez consulter [Test du basculement](failover.md#failover-testing).
**Note**
Cela entraînera un temps d'arrêt d'environ 30 secondes pour votre cluster. Veuillez prévoir vos opérations en conséquence.
1. Supprimez du cluster tous les réplicas dont le type d'instance est plus petit que celui de votre nouvelle instance principale.
1. Redéfinissez le niveau de basculement de toutes les instances sur la même priorité (généralement, cela signifie de les redéfinir sur 1).
Supposons par exemple que vous avez un cluster qui contient actuellement trois instances `r5.large` (une instance principale et deux réplicas) et que vous souhaitez mettre à l'échelle vers un type d'instance `r5.xlarge`. Pour ce faire, vous devez d'abord ajouter trois instances de réplica `r5.xlarge` à votre cluster, puis définir le niveau de basculement des nouveaux réplicas `r5.xlarge` sur zéro. Vous devez ensuite lancer un basculement manuel (sachant que cela entraînera un temps d'arrêt d'environ 30 secondes de votre application). Une fois le basculement terminé, vous supprimez les trois instances `r5.large` de votre cluster, en laissant le cluster mis à l'échelle avec des instances `r5.xlarge`.
Pour optimiser les coûts, les instances Amazon DocumentDB sont facturées par tranches d'une seconde, avec un minimum de dix minutes après un changement de statut facturable tel que la création, la modification ou la suppression d'une instance. Pour de plus amples informations, veuillez consulter [Optimisation des coûts](best_practices.md#best_practices-cost_optimization) dans la documentation relative aux bonnes pratiques.
1. **Optimiser pour la simplicité** — Cette approche optimise la simplicité. Il n'étend ni ne contracte le cluster, mais il peut réduire temporairement votre capacité de lecture.
Il est possible que la modification de la classe d'instance d'une réplique empêche cette instance de traiter les demandes pendant une courte période, de quelques secondes à moins de 30 secondes. Si vous vous connectez à votre cluster en [mode réplica set](connect-to-replica-set.md) (recommandé), cela réduira votre capacité de lecture d'une réplique (par exemple, à 66 % de capacité dans un cluster à 3 nœuds, ou à 75 % de capacité dans un cluster à 4 nœuds, etc.) pendant l'opération de dimensionnement.
1. Redimensionnez l'une des instances de réplication de votre cluster. Pour de plus amples informations, veuillez consulter [Gestion des classes d'instances](db-instance-classes.md).
1. Attendez que l'instance soit disponible (voir[Surveillance de l'état d'une instance Amazon DocumentDB](monitoring_docdb-instance_status.md)).
**Note**
Cela entraînera un temps d'arrêt d'environ 30 secondes pour votre cluster. Veuillez prévoir vos opérations en conséquence.
1. Continuez à exécuter les étapes 1 et 2 jusqu'à ce que toutes les instances de répliques aient été redimensionnées, une par une.
1. Lancez un basculement manuel. Cela fera de l'une des répliques l'instance principale. Pour de plus amples informations, veuillez consulter [Basculement d'Amazon DocumentDB](failover.md).
**Note**
Cela entraînera jusqu'à 30 secondes d'indisponibilité pour votre cluster, mais cela prend souvent moins de temps que cela. Veuillez prévoir vos opérations en conséquence.
1. Redimensionnez l'ancienne instance principale (désormais une réplique).
# Clonage d'un volume pour un cluster Amazon DocumentDB
En utilisant le clonage Amazon DocumentDB, vous pouvez créer un nouveau cluster qui utilise le même volume de cluster Amazon DocumentDB et possède les mêmes données que l'original. Le processus est conçu pour être rapide et rentable. Le nouveau cluster avec son volume de données associé est appelé *clone*. La création d’un clone est plus rapide et plus économe en espace que la copie physique des données à l’aide d’autres techniques telles que la restauration d’instantané.
Amazon DocumentDB prend en charge la création d'un clone provisionné Amazon DocumentDB à partir d'un cluster Amazon DocumentDB provisionné. Lorsque vous créez un clone à l'aide d'une configuration de déploiement différente de celle de la source, le clone est créé à l'aide de la dernière version du moteur Amazon DocumentDB de la source.
Lorsque vous créez des clones à partir de vos clusters Amazon DocumentDB, les clones sont créés dans AWS votre compte, le même compte qui possède le cluster Amazon DocumentDB source.
**Topics**
+ [Présentation du clonage d'Amazon DocumentDB](#db-cloning-overview)
+ [Limites du clonage d'Amazon DocumentDB](#db-cloning-limitations)
+ [Comment fonctionne le clonage d'Amazon DocumentDB](#db-how-db-cloning-works)
+ [Création d'un clone Amazon DocumentDB](#db-creating-db-clone)
## Présentation du clonage d'Amazon DocumentDB
Amazon DocumentDB utilise un *copy-on-write protocole* pour créer un clone. Ce mécanisme utilise un espace supplémentaire minimal pour créer un clone initial. Lorsque le clone est créé pour la première fois, Amazon DocumentDB conserve une copie unique des données utilisées par le cluster de base de données source et le nouveau cluster Amazon DocumentDB (cloné). Du stockage supplémentaire est alloué uniquement lorsque des modifications sont apportées aux données (sur le volume de stockage Amazon DocumentDB) par le cluster Amazon DocumentDB source ou le clone du cluster Amazon DocumentDB. Pour en savoir plus sur le copy-on-write protocole, voir[Comment fonctionne le clonage d'Amazon DocumentDB](#db-how-db-cloning-works).
Le clonage Amazon DocumentDB est particulièrement utile pour configurer rapidement des environnements de test à l'aide de vos données de production, sans risquer de les corrompre. Vous pouvez utiliser des clones pour de nombreux types d’applications, telles que les suivantes :
+ Expérimentez des changements potentiels (par exemple, des changements de schémas et de groupes de paramètres) pour évaluer tous les impacts.
+ Exécutez des opérations imposant une charge de travail élevée, telles que l’exportation de données ou l’exécution de requêtes analytiques sur le clone.
+ Créez une copie de votre cluster de bases de données de production à des fins de développement, de test ou autres.
Vous pouvez créer plusieurs clones à partir du même cluster Amazon DocumentDB. Vous pouvez également créer plusieurs clones à partir d’un autre clone.
Après avoir créé un clone Amazon DocumentDB, vous pouvez configurer les instances Amazon DocumentDB différemment du cluster Amazon DocumentDB source. Par exemple, il se peut que vous n'ayez pas besoin d'un clone à des fins de développement pour répondre aux mêmes exigences de haute disponibilité que le cluster Amazon DocumentDB de production source. Dans ce cas, vous pouvez configurer le clone avec une seule instance Amazon DocumentDB plutôt qu'avec les multiples instances de base de données utilisées par le cluster Amazon DocumentDB.
Lorsque vous avez fini d’utiliser le clone à des fins de test, de développement ou autres, vous pouvez le supprimer.
## Limites du clonage d'Amazon DocumentDB
Amazon DocumentDB ; le clonage présente actuellement les limites suivantes :
+ Vous pouvez créer autant de clones que vous le souhaitez, jusqu'au nombre maximal de clusters de bases de données autorisés dans la Région AWS. Toutefois, lorsque vous avez créé 15 clones, le 16ème est une copie intégrale. L'opération de clonage agit comme une point-in-time restauration.
+ Vous ne pouvez pas créer de clone dans une AWS région différente de celle du cluster Amazon DocumentDB source.
+ Vous ne pouvez pas créer de clone à partir d'un cluster Amazon DocumentDB dépourvu d'instances de base de données. Vous ne pouvez cloner que des clusters Amazon DocumentDB dotés d'au moins une instance de base de données.
+ Vous pouvez créer un clone dans un cloud privé virtuel (VPC) différent de celui du cluster Amazon DocumentDB. Dans ce cas, les sous-réseaux de VPCs doivent correspondre aux mêmes zones de disponibilité.
## Comment fonctionne le clonage d'Amazon DocumentDB
Le clonage Amazon DocumentDB fonctionne au niveau de la couche de stockage d'un cluster Amazon DocumentDB. Il utilise un *copy-on-write*protocole à la fois rapide et peu encombrant en termes de support durable sous-jacent supportant le volume de stockage Amazon DocumentDB. Vous pouvez en savoir plus sur les volumes de cluster Amazon DocumentDB dans. [Gestion des clusters Amazon DocumentDB](db-clusters.md)
**Topics**
+ [Comprendre le copy-on-write protocole](#db-copy-on-write-protocol)
+ [Suppression d'un volume de cluster source](#db-deleting-source-cluster-volume)
### Comprendre le copy-on-write protocole
Un cluster Amazon DocumentDB stocke les données dans des pages du volume de stockage Amazon DocumentDB sous-jacent.
Par exemple, dans le schéma suivant, vous pouvez trouver un cluster Amazon DocumentDB (A) comportant quatre pages de données, 1, 2, 3 et 4. Imaginez qu'un clone, B, soit créé à partir du cluster Amazon DocumentDB. Lors de la création du clone, aucune donnée n’est copiée. Le clone pointe plutôt vers le même ensemble de pages que le cluster Amazon DocumentDB source.
![\[Volume de cluster Amazon DocumentDB avec 4 pages pour le cluster source, A, et le clone, B\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-1.png)
Lors de la création du clone, aucun stockage supplémentaire n’est généralement nécessaire. Le copy-on-write protocole utilise le même segment sur le support de stockage physique que le segment source. Un stockage supplémentaire n’est requis que si la capacité du segment source n’est pas suffisante pour le segment de clone entier. Dans ce cas, le segment source est copié sur un autre périphérique physique.
Dans les diagrammes suivants, vous pouvez trouver un exemple du copy-on-write protocole en action utilisant le même cluster A et son clone, B, comme indiqué ci-dessus. Supposons que vous apportiez une modification à votre cluster Amazon DocumentDB (A) qui entraîne une modification des données contenues sur la page 1. Au lieu d'écrire sur la page 1 d'origine, Amazon DocumentDB crée une nouvelle page 1 [A]. Le volume du cluster Amazon DocumentDB pour le cluster (A) pointe désormais vers les pages 1 [A], 2, 3 et 4, tandis que le clone (B) fait toujours référence aux pages d'origine.
![\[Volume du cluster de base de données source Amazon DocumentDB et son clone, tous deux modifiés.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-2.png)
Sur le clone, une modification est apportée à la page 4 sur le volume de stockage. Au lieu d'écrire sur la page 4 d'origine, Amazon DocumentDB crée une nouvelle page, 4 [B]. Le clone pointe maintenant vers les pages 1, 2, 3 et 4[B], tandis que le cluster (A) continue de pointer vers les pages 1[A], 2, 3 et 4.
![\[Volume du cluster de base de données source Amazon DocumentDB et son clone, tous deux modifiés.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-3.png)
Au fur et à mesure que de nouvelles modifications se produisent au fil du temps, à la fois dans le volume du cluster Amazon DocumentDB source et dans le clone, davantage de stockage est nécessaire pour capturer et stocker les modifications.
### Suppression d'un volume de cluster source
Lorsque vous supprimez un volume de cluster source auquel un ou plusieurs clones sont associés, ceux-ci ne sont pas affectés. Les clones continuent de pointer vers les pages qui étaient précédemment la propriété du volume de cluster source.
## Création d'un clone Amazon DocumentDB
Vous pouvez créer un clone dans le même AWS compte que le cluster Amazon DocumentDB source. Pour ce faire, vous pouvez utiliser le AWS Management Console ou les AWS CLI et les procédures suivantes.
En utilisant le clonage Amazon DocumentDB, vous pouvez créer un clone de cluster Amazon DocumentDB provisionné à partir d'un cluster Amazon DocumentDB provisionné.
------
#### [ Using the AWS Management Console ]
La procédure suivante décrit comment cloner un cluster Amazon DocumentDB à l'aide du. AWS Management Console
Création d'un clone à l'aide des AWS Management Console résultats dans un cluster Amazon DocumentDB avec une instance Amazon DocumentDB.
Ces instructions s'appliquent aux clusters de base de données appartenant au même AWS compte qui crée le clone. Le cluster de base de données doit appartenir au même AWS compte, car le clonage entre comptes n'est pas pris en charge dans Amazon DocumentDB.
**Pour créer un clone d'un cluster de base de données appartenant à votre AWS compte à l'aide du 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. Choisissez votre cluster Amazon DocumentDB dans la liste, et pour **Actions**, choisissez **Create** clone.
![\[La création d'un clone commence par la sélection de votre cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/db-cloning-create-clone-1.png)
La page Créer un clone s'ouvre, où vous pouvez configurer un **identifiant de cluster** et une **classe d'instance**, ainsi que d'autres options pour le clone de cluster Amazon DocumentDB.
1. Dans la section **Settings** (Paramètres), procédez comme suit :
1. Dans le **champ Identifiant du cluster**, entrez le nom que vous souhaitez attribuer à votre cluster Amazon DocumentDB cloné.
1. Pour la **configuration de l'instance**, sélectionnez une **classe d'instance** appropriée pour votre cluster Amazon DocumentDB cloné.
![\[La création d'un clone commence par la sélection de votre cluster Amazon DocumentDB et la spécification d'une taille d'instance de base de données.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/db-cloning-create-clone-2.png)
1. Pour les **paramètres réseau**, choisissez un **groupe de sous-réseaux** pour votre cas d'utilisation et les groupes de sécurité VPC associés.
1. Pour **E ncryption-at-rest**, si le chiffrement est activé sur le cluster source (le cluster cloné), le chiffrement doit également être activé sur le cluster cloné. Si ce scénario est vrai, les options **Activer le chiffrement** sont grisées (désactivées) mais l'option **Activer le chiffrement** est sélectionnée. À l'inverse, si le chiffrement n'est pas activé dans le cluster source, les options **Activer le chiffrement** sont disponibles et vous pouvez choisir d'activer ou de désactiver le chiffrement.
![\[Spécifiez les paramètres réseau et de chiffrement pour votre clone de cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/db-cloning-create-clone-3-nw-encryption.png)
1. Complétez la nouvelle configuration du clone de cluster en sélectionnant le type de journaux à exporter (facultatif), en saisissant un port spécifique utilisé pour se connecter au cluster et en activant la protection contre la suppression accidentelle du cluster (activée par défaut).
![\[Complétez la nouvelle configuration du clone en sélectionnant éventuellement le type de journaux à exporter, un port spécifique utilisé pour se connecter au cluster et une protection contre la suppression accidentelle du cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/db-cloning-create-clone-4-log-options-del-prot-b.png)
1. Terminez de saisir tous les paramètres de votre clone de cluster Amazon DocumentDB. Pour en savoir plus sur les paramètres du cluster et de l'instance Amazon DocumentDB, consultez. [Gestion des clusters Amazon DocumentDB](db-clusters.md)
1. Choisissez **Create clone** pour lancer le clone Amazon DocumentDB du cluster Amazon DocumentDB de votre choix.
Lorsque le clone est créé, il est répertorié avec vos autres clusters Amazon DocumentDB dans la section **Bases** de données de la console et affiche son état actuel. Votre clone est prêt à être utilisé quand son état est **Disponible**.
------
#### [ Using the AWS CLI ]
L'utilisation du AWS CLI pour cloner votre cluster Amazon DocumentDB implique quelques étapes.
La `restore-db-cluster-to-point-in-time` AWS CLI commande que vous utilisez génère un cluster Amazon DocumentDB vide avec 0 instance Amazon DocumentDB. En d'autres termes, la commande restaure uniquement le cluster Amazon DocumentDB, et non les instances de base de données de ce cluster. Vous faites cela séparément une fois le clone disponible. Les deux étapes du processus sont les suivantes :
1. Créez le clone à l'aide de la commande [restore-db-cluster-to- point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI. Les paramètres que vous utilisez avec cette commande contrôlent le type de capacité et d'autres détails du cluster Amazon DocumentDB vide (clone) en cours de création.
1. Créez l'instance Amazon DocumentDB pour le clone à l'aide de la commande [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI pour recréer l'instance Amazon DocumentDB dans le cluster Amazon DocumentDB restauré.
Les commandes suivantes supposent que votre AWS région AWS CLI est configurée par défaut. Cette approche vous évite de passer le nom de `--region` dans chaque commande. Pour plus d'informations, consultez [Configuration de l' AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html). Vous pouvez également spécifier la `--region` dans chacune des commandes de la CLI qui suivent.
**Topics**
**Création du clone**
Les paramètres spécifiques que vous passez à la commande de la CLI `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)` varient. Ce que vous transmettez dépend du type de clone que vous souhaitez créer.
Utilisez la procédure suivante pour créer un clone Amazon DocumentDB provisionné à partir d'un cluster Amazon DocumentDB provisionné.
**Pour créer un clone du même mode de moteur que le cluster Amazon DocumentDB source**
+ Utilisez la commande de la CLI `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)` et spécifiez les valeurs des paramètres suivants :
+ `--db-cluster-identifier` – Choisissez un nom explicite pour votre clone. Vous nommez le clone lorsque vous utilisez la commande [restore-db-cluster-to- point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI.
+ `--restore-type` : utilisez la commande `copy-on-write` pour créer un clone du cluster de bases de données source. Sans ce paramètre, le cluster Amazon DocumentDB `restore-db-cluster-to-point-in-time` restaure plutôt que de créer un clone. La valeur par défaut pour `restore-type` est`full-copy`.
+ `--source-db-cluster-identifier`— Utilisez le nom du cluster Amazon DocumentDB source que vous souhaitez cloner.
+ `--use-latest-restorable-time` – Cette valeur pointe vers les données de volume restaurables les plus récentes pour le clone. Ce paramètre est obligatoire car`restore-type copy-on-write`, cependant, vous ne pouvez pas utiliser le `restore-to-time parameter` avec.
L'exemple suivant crée un clone nommé `my-clone` à partir d'un cluster nommé `my-source-cluster`.
Pour Linux, macOS ou Unix :
```
aws docdb restore-db-cluster-to-point-in-time \
--source-db-cluster-identifier my-source-cluster \
--db-cluster-identifier my-clone \
--restore-type copy-on-write \
--use-latest-restorable-time
```
Pour Windows :
```
aws docdb restore-db-cluster-to-point-in-time ^
--source-db-cluster-identifier my-source-cluster ^
--db-cluster-identifier my-clone ^
--restore-type copy-on-write ^
--use-latest-restorable-time
```
La commande renvoie l'objet JSON contenant les détails du clone. Vérifiez que votre cluster de bases de données cloné est disponible avant d’essayer de créer l’instance de base de données pour votre clone. Pour plus d'informations, consultez la section Vérification de l'état et obtention des informations relatives au clone ci-dessous :
**Vérifier le statut et obtenir les détails du clone**
Vous pouvez utiliser la commande suivante pour vérifier l'état de votre cluster de base de données vide nouvellement créé.
```
$ aws docdb describe-db-clusters --db-cluster-identifier my-clone --query '*[].[Status]' --output text
```
Vous pouvez également obtenir le statut et les autres valeurs dont vous avez besoin pour créer l'instance de base de données pour votre clone en utilisant la AWS CLI requête suivante :
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-clusters --db-cluster-identifier my-clone \
--query '*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}'
```
Pour Windows :
```
aws docdb describe-db-clusters --db-cluster-identifier my-clone ^
--query "*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}"
```
Cette requête retourne une sortie similaire à la suivante.
```
[
{
"Status": "available",
"Engine": "docdb",
"EngineVersion": "4.0.0",
}
]
```
**Création de l'instance Amazon DocumentDB pour votre clone**
Utilisez la commande [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI pour créer l'instance de base de données pour votre clone.
Le `--db-instance-class` paramètre est utilisé uniquement pour les clusters Amazon DocumentDB provisionnés.
Pour Linux, macOS ou Unix :
```
aws docdb create-db-instance \
--db-instance-identifier my-new-db \
--db-cluster-identifier my-clone \
--db-instance-class db.r5.4xlarge \
--engine docdb
```
Pour Windows :
```
aws docdb create-db-instance ^
--db-instance-identifier my-new-db ^
--db-cluster-identifier my-clone ^
--db-instance-class db.r5.4xlarge ^
--engine docdb
```
**Paramètres à utiliser pour le clonage**
Le tableau suivant récapitule les différents paramètres utilisés pour cloner des `restore-db-cluster-to-point-in-time` clusters Amazon DocumentDB.
| Paramètre | Description |
| --- | --- |
| --source-db-cluster-identifier | Utilisez le nom du cluster Amazon DocumentDB source que vous souhaitez cloner. |
| --db-cluster-identifier | Choisissez un nom explicite pour votre clone. Vous nommez votre clone à l'aide de la commande ` restore-db-cluster-to-point-in-time`. Ensuite, vous passez ce nom à la commande `create-db-instance`. |
| —type de restauration | Spécifiez `copy-on-write` comme `--restore-type` pour créer un clone du cluster de base de données source plutôt que de restaurer le cluster Amazon DocumentDB source. |
| --use-latest-restorable-time | Cette valeur pointe vers les données de volume restaurables les plus récentes pour le clone. |
------
# Comprendre la tolérance aux pannes des clusters Amazon DocumentDB
Les clusters Amazon DocumentDB sont par conception tolérants aux pannes. Le volume de chaque cluster couvre plusieurs zones de disponibilité en une seule Région AWS, et chaque zone de disponibilité contient une copie des données de volume du cluster. Cette fonctionnalité signifie que votre cluster peut tolérer une défaillance d'une zone de disponibilité sans perte de données et uniquement une brève interruption de service.
En cas de défaillance de l'instance principale d'un cluster, Amazon DocumentDB effectue automatiquement un basculement vers une nouvelle instance principale de deux manières :
+ En promouvant une réplique Amazon DocumentDB existante vers la nouvelle instance principale choisie en fonction du paramètre de niveau de promotion de chaque réplique, puis en créant une instance de remplacement pour l'ancienne instance principale. Le basculement vers l'instance de réplique prend généralement moins de 30 secondes. Les opérations de lecture et d'écriture peuvent être brièvement interrompues pendant cette période. Pour augmenter la disponibilité de votre cluster, nous vous recommandons de créer au moins une ou plusieurs répliques Amazon DocumentDB dans au moins deux zones de disponibilité différentes.
+ Par la création d'une nouvelle instance principale. Cela ne se produit que si vous ne disposez pas d'une instance de réplication dans votre cluster et cela peut prendre quelques minutes.
Si le cluster possède une ou plusieurs répliques Amazon DocumentDB, une réplique Amazon DocumentDB est promue en instance principale en cas de défaillance. Un événement d'échec se traduit par une brève interruption, pendant laquelle les opérations de lecture et d'écriture échouent avec une exception. Cependant, le service est généralement restauré en moins de 120 secondes, et souvent en moins de 60 secondes. Pour augmenter la disponibilité de votre cluster, nous vous recommandons de créer au moins une ou plusieurs répliques Amazon DocumentDB dans au moins deux zones de disponibilité différentes.
Vous pouvez personnaliser l'ordre dans lequel vos répliques Amazon DocumentDB sont promues vers l'instance principale après une panne en attribuant une priorité à chaque réplique. Les priorités s’étendent de la valeur 0 pour la plus haute priorité à la valeur 15 pour la plus basse priorité. En cas de défaillance de l'instance principale, la réplique Amazon DocumentDB ayant la priorité la plus élevée est promue vers la nouvelle instance principale. Vous pouvez modifier la priorité d'une réplique Amazon DocumentDB à tout moment. La modification de la priorité ne déclenche pas un basculement. Vous pouvez utiliser l'opération `modify-db-instance` avec le paramètre `--promotion-tier`. Pour en savoir plus sur la personnalisation de la priorité de basculement d'une instance, consultez [Basculement d'Amazon DocumentDB](failover.md).
Plusieurs répliques Amazon DocumentDB peuvent partager la même priorité, ce qui se traduit par des niveaux de promotion. Si deux répliques Amazon DocumentDB ou plus partagent la même priorité, la réplique la plus grande est promue en tant que réplique principale. Si deux répliques Amazon DocumentDB ou plus partagent la même priorité et la même taille, une réplique arbitraire appartenant au même niveau de promotion est promue.
Si le cluster ne contient aucune réplique Amazon DocumentDB, l'instance principale est recréée lors d'un événement de défaillance. Un événement d'échec se traduit par une interruption, pendant laquelle les opérations de lecture et d'écriture échouent avec une exception. Le service est rétabli quand la nouvelle instance principale est créée, ce qui prend généralement moins de 10 minutes. La promotion d'une réplique Amazon DocumentDB vers l'instance principale est beaucoup plus rapide que la création d'une nouvelle instance principale.