Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Gestion des clusters élastiques Amazon DocumentDB
Pour gérer un cluster élastique Amazon DocumentDB, vous devez disposer d'une politique IAM avec les autorisations appropriées du plan de contrôle Amazon DocumentDB. Ces autorisations vous permettent de créer, de modifier et de supprimer des clusters. La DocumentDBFullAccess politique d'Amazon fournit toutes les autorisations requises pour administrer un cluster élastique Amazon DocumentDB.
Les rubriques suivantes montrent comment effectuer différentes tâches lorsque vous travaillez avec des clusters élastiques Amazon DocumentDB.
**Topics**
+ [Modification des configurations de clusters élastiques](#elastic-modify)
+ [Surveillance d'un cluster élastique](#elastic-monitor)
+ [Supprimer un cluster élastique](#elastic-delete)
+ [Gestion des instantanés de clusters élastiques](elastic-manage-snapshots.md)
+ [Arrêt et démarrage d'un cluster élastique Amazon DocumentDB](elastic-cluster-stop-start.md)
+ [Gestion des clusters élastiques Amazon DocumentDB](elastic-cluster-maintenance.md)
## Modification des configurations de clusters élastiques
Dans cette section, nous expliquons comment modifier Elastic Cluster, à l'aide des instructions suivantes AWS Management Console ou AWS CLI en suivant les instructions suivantes.
L'une des principales utilisations de la modification du cluster consiste à redimensionner les partitions en augmentant ou en diminuant le nombre de partitions et la capacité de calcul des and/or partitions.
------
#### [ Using the AWS Management Console ]
Pour modifier la configuration d'un cluster élastique à l'aide de AWS Management Console :
1. Connectez-vous à la console Amazon DocumentDB [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)et ouvrez-la.
1. Dans le panneau de navigation, choisissez **Clusters**.
**Astuce**
Si le volet de navigation ne s'affiche pas sur le côté gauche de votre écran, choisissez l'icône de menu dans le coin supérieur gauche du volet de navigation.
1. Choisissez le nom du cluster que vous souhaitez modifier dans la colonne **Identifiant du cluster**.
1. Sélectionnez **Modifier**.
1. Modifiez les champs que vous souhaitez modifier, puis sélectionnez **Modifier le cluster**.
**Note**
Vous pouvez également accéder à la boîte de dialogue **Modifier le cluster** en accédant à la page **Clusters**, en cochant la case à côté de votre cluster, en choisissant **Actions**, puis **Modifier**.
------
#### [ Using the AWS CLI ]
Pour modifier une configuration de cluster élastique à l'aide de AWS CLI, utilisez l'`update-cluster`opération avec les paramètres suivants :
+ **--cluster-arn** : obligatoire. Identifiant ARN du cluster que vous souhaitez modifier.
+ **--shard-capacity**—Facultatif. Le nombre de vCPU assignés à chaque partition. Le maximum est de 64. Les valeurs autorisées sont 2, 4, 8, 16, 32, 64.
+ **--shard-count**—Facultatif. Le nombre de partitions attribuées au cluster. Le maximum est de 32.
+ **--shard-instance**-Nombre : facultatif. Le nombre d'instances de répliques s'appliquant à toutes les partitions de ce cluster. Le maximum est de 16.
+ **--auth-type**—Facultatif. Type d'authentification utilisé pour déterminer où récupérer le mot de passe utilisé pour accéder au cluster élastique. Les types valides sont `PLAIN_TEXT` ou`SECRET_ARN`.
+ **--admin-user-password**—Facultatif. Le mot de passe associé à l'utilisateur administrateur.
+ **--vpc-security-group-ids**—Facultatif. Configurez une liste des groupes de sécurité Amazon EC2 et Amazon Virtual Private Cloud (VPC) à associer à ce cluster.
+ **--preferred-maintenance-window**—Facultatif. Configurer la plage horaire hebdomadaire pendant laquelle la maintenance du système peut avoir lieu, en temps universel coordonné (UTC)
Le format est :`ddd:hh24:mi-ddd:hh24:mi`. Jours valides (ddd) : lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche
La valeur par défaut est une fenêtre de 30 minutes sélectionnée au hasard sur une période de 8 heures pour chaque région Amazon Web Services, survenant un jour aléatoire de la semaine.
Fenêtre minimale de 30 minutes.
+ **--subnet-ids**—Facultatif. Configurez les identifiants de sous-réseau.
Dans l'exemple suivant, remplacez chacune {{user input placeholder}} par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic update-cluster \
--cluster-arn {{arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2}} \
--shard-capacity {{8}} \
--shard-count {{4}} \
--shard-instance-count {{3}} \
--admin-user-password {{testPassword}} \
--vpc-security-group-ids {{ec-65f40350}} \
--subnet-ids {{subnet-9253c6a3, subnet-9f1b5af9}}
```
Pour Windows :
```
aws docdb-elastic update-cluster ^
--cluster-arn {{arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2}} ^
--shard-capacity {{8}} ^
--shard-count {{4}} ^
--shard-instance-count {{3}} ^
--admin-user-password {{testPassword}} ^
--vpc-security-group-ids {{ec-65f40350}} ^
--subnet-ids {{subnet-9253c6a3, subnet-9f1b5af9}}
```
------
Pour surveiller l'état du cluster élastique après votre modification, consultez la section Surveillance d'un cluster élastique.
## Surveillance d'un cluster élastique
Dans cette section, nous expliquons comment surveiller votre cluster élastique, à l'aide des instructions suivantes AWS Management Console ou AWS CLI en suivant les instructions suivantes.
------
#### [ Using the AWS Management Console ]
Pour surveiller une configuration de cluster élastique à l'aide de AWS Management Console :
1. Connectez-vous à la console Amazon DocumentDB [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)et ouvrez-la.
1. Dans le panneau de navigation, choisissez **Clusters**.
**Astuce**
Si le volet de navigation ne s'affiche pas sur le côté gauche de votre écran, choisissez l'icône de menu dans le coin supérieur gauche du volet de navigation.
1. Choisissez le nom du cluster que vous souhaitez surveiller dans la colonne **Identifiant du cluster**.
1. Sélectionnez l'onglet **Monitoring** (Surveillance).
Un certain nombre de graphiques d'Amazon CloudWatch sont affichés pour les catégories de surveillance suivantes :
+ Utilisation des ressources
+ Débit
+ Opérations
+ Système
Vous pouvez également accéder à Amazon CloudWatch via le AWS Management Console pour configurer votre propre environnement de surveillance pour vos clusters élastiques.
------
#### [ Using the AWS CLI ]
Pour surveiller une configuration de cluster élastique spécifique à l'aide de AWS CLI, utilisez l'`get-cluster`opération avec les paramètres suivants :
+ **--cluster-arn** : obligatoire. Identifiant ARN du cluster pour lequel vous souhaitez obtenir des informations.
Dans l'exemple suivant, remplacez chacune {{user input placeholder}} par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic get-cluster \
--cluster-arn {{arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9}}
```
Pour Windows :
```
aws docdb-elastic get-cluster ^
--cluster-arn {{arn:aws:docdb:-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9}}
```
Le résultat de cette opération ressemble à ce qui suit :
```
"cluster": {
...
"clusterArn": "arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9",
"clusterEndpoint": "stretch-11-477568257630.us-east-1.docdb-elastic.amazonaws.com",
"readerEndpoint": "stretch-11-477568257630-ro.us-east-1.docdb-elastic.amazonaws.com",
"clusterName": "stretch-11",
"shardCapacity": 2,
"shardCount": 3,
"shardInstanceCount: 5,
"status": "ACTIVE",
...
}
```
Pour plus d'informations, consultez le document `DescribeClusterSnapshot` de référence de l'API de gestion des ressources Amazon DocumentDB.
Pour afficher les détails de tous les clusters élastiques à l'aide de AWS CLI, utilisez l'`list-clusters`opération avec les paramètres suivants :
+ **--next-token**—Facultatif. Si le nombre d’éléments en sortie (`--max-results`) est inférieur au nombre total d’éléments renvoyés par les appels d’API sous-jacents, la sortie inclut un code `NextToken` que vous pouvez transmettre dans une commande suivante pour récupérer le prochain ensemble d’éléments.
+ **--max-results**—Facultatif. Le nombre total d'éléments à renvoyer dans la sortie de la commande. S'il existe plus de résultats que la `max-results` valeur spécifiée, un jeton de pagination (`next-token`) est inclus dans la réponse afin que les résultats restants puissent être récupérés.
+ Par défaut : 100
+ Minimum 20, maximum 100
Dans l'exemple suivant, remplacez chacune {{user input placeholder}} par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic list-clusters \
--next-token {{eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ==}} \
--max-results {{2}}
```
Pour Windows :
```
aws docdb-elastic list-clusters ^
--next-token {{eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ==}} ^
--max-results {{2}}
```
Le résultat de cette opération ressemble à ce qui suit :
```
{
"Clusters": [
{
"ClusterIdentifier":"mycluster-1",
"ClusterArn":"arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster"
"Status":"available",
"ClusterEndpoint":"sample-cluster.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
}
{
"ClusterIdentifier":"mycluster-2",
"ClusterArn":"arn:aws:docdb:us-west-2:987654321098:sharded-cluster:sample-cluster"
"Status":"available",
"ClusterEndpoint":"sample-cluster2.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
}
]
}
```
------
## Supprimer un cluster élastique
Dans cette section, nous expliquons comment supprimer un cluster élastique, à l'aide des instructions suivantes AWS Management Console ou AWS CLI en suivant les instructions suivantes.
------
#### [ Using the AWS Management Console ]
Pour supprimer une configuration de cluster élastique à l'aide de AWS Management Console :
1. Connectez-vous à la console Amazon DocumentDB [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)et ouvrez-la.
1. Dans le panneau de navigation, choisissez **Clusters**.
**Astuce**
Si le volet de navigation ne s'affiche pas sur le côté gauche de votre écran, choisissez l'icône de menu dans le coin supérieur gauche du volet de navigation.
1. Dans le tableau de liste des clusters, cochez la case située à gauche du nom du cluster que vous souhaitez supprimer, puis choisissez **Actions**. Dans le menu déroulant, choisissez **Delete (Supprimer)**.
1. Dans le cluster **élastique Delete « cluster-name » ?** dans une boîte de dialogue, choisissez **Supprimer**.
La suppression du cluster prend plusieurs minutes. Pour surveiller l'état du cluster, consultez la section [Surveillance de l'état d'un cluster Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).
------
#### [ Using the AWS CLI ]
Pour supprimer un cluster élastique à l'aide de AWS CLI, utilisez l'`delete-cluster`opération avec les paramètres suivants :
+ **--cluster-arn** : obligatoire. Identifiant ARN du cluster que vous souhaitez supprimer.
+ **--no-skip-final-backup**—Facultatif. Si vous souhaitez effectuer une sauvegarde finale, vous devez inclure ce paramètre dans le nom de la sauvegarde finale. Vous devez inclure soit `--final-backup-identifier` ou `--skip-final-backup`.
+ **--skip-final-backup**—Facultatif. Utilisez ce paramètre uniquement si vous ne souhaitez pas effectuer de sauvegarde finale avant de supprimer votre cluster. Le paramètre par défaut consiste à prendre un instantané final.
Les exemples de AWS CLI code suivants suppriment un cluster dont l'ARN est arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster avec une sauvegarde finale.
Dans l'exemple suivant, remplacez chacune {{user input placeholder}} par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic delete-cluster \
--cluster-arn {{arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster}} \
--no-skip-final-backup \
--final-backup-identifier finalArnBU-arn:{{aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster}}
```
Pour Windows :
```
aws docdb-elastic delete-cluster ^
--cluster-arn {{arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster}} ^
--no-skip-final-backup ^
--final-backup-identifier finalArnBU-arn:{{aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster}}
```
Les exemples de AWS CLI code suivants suppriment un cluster dont l'ARN est arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster sans effectuer de sauvegarde finale.
Dans l'exemple suivant, remplacez chacune {{user input placeholder}} par vos propres informations.
Pour Linux, macOS ou Unix :
```
aws docdb-elastic delete-cluster \
--cluster-arn {{arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster}} \
--skip-final-backup \
```
Pour Windows :
```
aws docdb-elastic delete-cluster ^
--cluster-arn {{arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster}} ^
--skip-final-backup ^
```
Le résultat de l'`delete-cluster`opération est un affichage du cluster que vous supprimez.
La suppression du cluster prend plusieurs minutes. Pour surveiller l'état du cluster, consultez la section [Surveillance de l'état d'un cluster Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).
------