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 instances Amazon DocumentDB
Les rubriques suivantes fournissent des informations qui vous aideront à gérer vos instances Amazon DocumentDB. Elles incluent des détails sur les classes et les statuts des instances, et sur la façon de créer, supprimer et modifier une instance.
**Topics**
+ [Déterminer le statut d'une instance](#db-instance-status)
+ [Cycle de vie d’une instance](db-instance-life-cycle.md)
+ [Gestion des classes d'instances](db-instance-classes.md)
+ [Instances basées sur les volumes NVMe](db-instance-nvme.md)
## Déterminer le statut d'une instance
Pour connaître les statuts d'instance valides, leur signification et savoir comment identifier le statut de vos instances, consultez [Surveillance de l'état d'une instance Amazon DocumentDB](monitoring_docdb-instance_status.md).
# Cycle de vie des instances Amazon DocumentDB
Le cycle de vie d'une instance Amazon DocumentDB inclut la création, la modification, la maintenance et la mise à niveau, l'exécution de sauvegardes et de restaurations, le redémarrage et la suppression de l'instance. Cette section fournit des informations sur la façon de réaliser ces processus.
**Topics**
+ [Ajouter une instance](db-instance-add.md)
+ [Décrire les instances](db-instance-view-details.md)
+ [Modification d'une instance](db-instance-modify.md)
+ [Redémarrage d'une instance](db-instance-reboot.md)
+ [Suppression d'une instance](db-instance-delete.md)
Vous pouvez créer une nouvelle instance Amazon DocumentDB à l'aide du AWS Management Console ou du. AWS CLI Pour ajouter une instance à un cluster, le cluster doit être dans un état *available (disponible)*. Vous ne pouvez pas ajouter une instance à 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 ajoutez une instance. Pour de plus amples informations, veuillez consulter [Arrêt et démarrage d'un cluster Amazon DocumentDB](db-cluster-stop-start.md).
**Note**
Si vous créez un cluster Amazon DocumentDB à l'aide de la console, une instance est automatiquement créée pour vous en même temps. Si vous souhaitez créer des instances supplémentaires, appliquez l'une des procédures suivantes.
# Ajouter une instance Amazon DocumentDB à un cluster
------
#### [ Using the AWS Management Console ]
Utilisez la procédure suivante pour créer une instance pour votre cluster à l'aide de la console 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. Pour choisir le cluster auquel vous voulez ajouter une instance, sélectionnez le bouton à gauche du nom du cluster.
1. Choisissez **Actions**, puis **Add instances (Ajouter des instances)**.
1. Dans la page **Add instance to: (Ajouter une instance à :)**, répétez les étapes suivantes pour chaque instance que vous souhaitez ajouter au cluster. Vous pouvez en avoir jusqu'à 15.
1. **Identifiant d'instance** : vous pouvez saisir un identifiant unique pour cette instance ou autoriser Amazon DocumentDB à fournir l'identifiant d'instance en fonction de l'identifiant de cluster.
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 toutes les instances d'Amazon RDS, Neptune et Amazon Compte AWS DocumentDB par région.
1. **Classe d'instance** : dans la liste déroulante, choisissez le type d'instance que vous souhaitez pour cette instance.
1. **Niveau de promotion** : dans la liste déroulante, choisissez le niveau de promotion pour votre instance ou choisissez *Aucune préférence* pour autoriser Amazon DocumentDB à définir le niveau de promotion pour votre instance. Plus le chiffre est bas, plus la priorité est élevée. Pour de plus amples informations, veuillez consulter [Contrôle de la cible de basculement](failover.md#failover-target_control).
1. Pour ajouter d'autres instances, choisissez **Add additional instances (Ajouter des instances supplémentaires)** et répétez les étapes a, b et c.
1. Mettez fin à l'opération.
+ Pour ajouter des instances à votre cluster, choisissez **Create (Créer)**.
+ Pour annuler l'opération, choisissez **Annuler**.
La création d'une instance prend quelques minutes. Vous pouvez utiliser la console ou AWS CLI consulter le statut de l'instance. Pour de plus amples informations, veuillez consulter [Surveillance de l'état d'une instance](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Utilisez l'`create-db-instance` AWS CLI opération avec les paramètres suivants pour créer l'instance principale de votre cluster.
+ **--db-instance-class** — Obligatoire. La capacité de calcul et de mémoire de l'instance, par exemple `db.m4.large`. Les classes d'instance ne sont pas toutes disponibles Régions AWS.
+ **--db-instance-identifier** — Obligatoire. Chaîne en minuscules () qui identifie l'instance.
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 toutes les instances d'Amazon RDS, Neptune et Amazon Compte AWS DocumentDB par région.
+ **--engine** — Obligatoire. Doit indiquer `docdb`.
+ **--availability-zone**— Facultatif La zone de disponibilité dans laquelle vous voulez créer l'instance. Utilisez ce paramètre pour localiser vos instances dans différentes zones de disponibilité, afin d'accroître la tolérance aux pannes. Pour de plus amples informations, veuillez consulter [Amazon DocumentDB Haute disponibilité et réplication](replication.md).
+ **--promotion-tier**— Facultatif Le niveau de priorité de basculement pour cette instance. Il doit être compris entre 0 et 15, les chiffres les plus bas indiquant une priorité plus élevée. Pour de plus amples informations, veuillez consulter [Contrôle de la cible de basculement](failover.md#failover-target_control).
1. **Tout d'abord, déterminez dans quelles zones de disponibilité vous pouvez créer votre instance. **
Si vous souhaitez spécifier la zone de disponibilité avant de créer votre instance, exécutez la commande suivante pour déterminer quelles zones de disponibilité sont disponibles pour votre cluster Amazon DocumentDB.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-clusters \
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
Pour Windows :
```
aws docdb describe-db-clusters ^
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
Le résultat de cette opération ressemble à ceci.
```
[
[
"sample-cluster",
[
"us-east-1c",
"us-east-1b",
"us-east-1a"
]
]
]
```
1. **Ensuite, identifiez les classes d'instance que vous pouvez créer dans votre région. **
Pour déterminer quelles classes d'instances sont disponibles dans votre région, exécutez la commande suivante. Dans la sortie, choisissez une classe d'instance pour l'instance que vous souhaitez ajouter à votre cluster Amazon DocumentDB.
Pour Linux, macOS ou Unix :
```
aws docdb describe-orderable-db-instance-options \
--engine docdb \
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
Pour Windows :
```
aws docdb describe-orderable-db-instance-options ^
--engine docdb ^
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
Le résultat de cette opération ressemble à ceci.
```
[
"db.r5.16xlarge",
"db.r5.2xlarge",
"db.r5.4xlarge",
"db.r5.8xlarge",
"db.r5.large",
"db.r5.xlarge"
]
```
1. **Enfin, ajoutez une instance à votre cluster Amazon DocumentDB.**
Pour ajouter une instance à votre cluster Amazon DocumentDB, exécutez la commande suivante.
Pour Linux, macOS ou Unix :
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-instance-2 \
--availability-zone us-east-1b \
--promotion-tier 2 \
--db-instance-class db.r5.xlarge \
--engine docdb
```
Pour Windows :
```
aws docdb create-db-instance ^
--db-cluster-identifier sample-cluster ^
--db-instance-identifier sample-instance-2 ^
--availability-zone us-east-1b ^
--promotion-tier 2 ^
--db-instance-class db.r5.xlarge ^
--engine docdb
```
Le résultat de cette opération ressemble à ceci.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.xlarge",
"Engine": "docdb",
"DBInstanceStatus": "creating",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1b",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:11:35-sun:12:05",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 2,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2"
}
}
```
La création de l'instance prend quelques minutes. Vous pouvez utiliser la console ou AWS CLI consulter le statut de l'instance. Pour de plus amples informations, veuillez consulter [Surveillance de l'état d'une instance Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
# Décrire les instances 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é, l'autorité de certification et les groupes VPCs de paramètres relatifs à vos instances Amazon DocumentDB.
------
#### [ Using the AWS Management Console ]
Pour afficher les détails de vos instances à l'aide de l’ AWS Management Console, suivez les étapes ci-dessous.
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 boîte de navigation Clusters, vous verrez la colonne **Cluster Identifier**. Vos instances sont répertoriées sous des clusters, comme dans la capture d'écran ci-dessous.
![\[Tableau des clusters présentant la liste des clusters sous la colonne Identifiant du cluster, avec les instances imbriquées dans les clusters.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/choose-clusters.png)
1. Dans la liste des instances, choisissez le nom de l'instance dont vous souhaitez voir les détails. Les informations relatives à l'instance sont organisées dans les groupes suivants :
+ **Résumé** : informations générales sur l'instance, notamment la version du moteur, la classe, le statut et toute maintenance en attente.
+ **Connectivité et sécurité** : la section **Connect** répertorie les points de terminaison de connexion permettant de se connecter à cette instance avec le shell mongo ou une application. La section **Security Groups (Groupes de sécurité)** répertorie les groupes de sécurité associés à cette instance ainsi que leur ID et de VPC et leurs descriptions.
+ **Configuration** : la section **Détails** répertorie les configurations et le statut de l'instance, y compris le nom de ressource Amazon (ARN), le point de terminaison, le rôle, la classe et l'autorité de certification de l'instance. Elle répertorie également les paramètres de sécurité et de réseau de l'instance, ainsi que les informations de sauvegarde. La section **Cluster details (Détails du cluster)** répertorie les détails du cluster auquel cette instance appartient. 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.
**Note**
Vous pouvez modifier le cluster associé à votre instance en sélectionnant **Modify (Modifier)** en regard de l'en-tête **Cluster details (Détails du cluster)**. Pour de plus amples informations, veuillez consulter [Modification d'un cluster Amazon DocumentDB](db-cluster-modify.md).
+ **Surveillance** : CloudWatch enregistre les métriques pour cette instance. 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 cette instance. 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. Pour de plus amples informations, veuillez consulter [Balisage des ressources Amazon DocumentDB](tagging.md).
------
#### [ Using the AWS CLI ]
Pour consulter les détails de vos instances 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_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.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.
1. **Répertoriez toutes les instances Amazon DocumentDB.**
Le AWS CLI code suivant répertorie les détails de toutes les instances Amazon DocumentDB d'une région.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
Pour Windows :
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
1. **Répertorier tous les détails d'une instance Amazon DocumentDB spécifiée**
Le code suivant répertorie les détails de `sample-cluster-instance`. L'inclusion du paramètre `--db-instance-identifier` avec le nom d'une instance limite la sortie aux informations sur cette instance particulière.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
Pour Windows :
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
Le résultat de cette opération ressemble à ce qui suit.
```
{
"DBInstances": [
{
"DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM",
"DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"DBInstanceClass": "db.r5.large",
"DBInstanceStatus": "creating",
"AutoMinorVersionUpgrade": true,
"PreferredMaintenanceWindow": "fri:09:32-fri:10:02",
"BackupRetentionPeriod": 1,
"StorageEncrypted": true,
"DBClusterIdentifier": "sample-cluster",
"EngineVersion": "3.6.0",
"AvailabilityZone": "us-east-1a",
"Engine": "docdb",
"PromotionTier": 2,
"DBInstanceIdentifier": "sample-cluster-instance",
"PreferredBackupWindow": "00:00-00:30",
"PubliclyAccessible": false,
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"Subnets": [
{
"SubnetIdentifier": "subnet-4e26d263",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-afc329f4",
"SubnetAvailabilityZone": {
"Name": "us-east-1c"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-b3806e8f",
"SubnetAvailabilityZone": {
"Name": "us-east-1e"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-53ab3636",
"SubnetAvailabilityZone": {
"Name": "us-east-1d"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-991cb8d0",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-29ab1025",
"SubnetAvailabilityZone": {
"Name": "us-east-1f"
},
"SubnetStatus": "Active"
}
],
"VpcId": "vpc-91280df6",
"DBSubnetGroupDescription": "default",
"SubnetGroupStatus": "Complete"
},
"PendingModifiedValues": {},
"KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b"
}
]
}
```
------
# Modification d'une instance Amazon DocumentDB
Vous pouvez modifier votre instance Amazon DocumentDB à l'aide du AWS Management Console ou du. AWS CLI Pour modifier une instance, l'instance doit être dans l'état *available (disponible)*. Vous ne pouvez pas modifier une instance qui est arrêtée. Si le cluster est arrêté, commencez par démarrer le cluster, attendez que l'instance 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 ]
Pour modifier une instance Amazon DocumentDB spécifique à l'aide de la console, procédez comme suit.
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 boîte de navigation Clusters, vous verrez la colonne **Cluster Identifier**. Vos instances sont répertoriées sous des clusters, comme dans la capture d'écran ci-dessous.
![\[Tableau des clusters présentant la liste des clusters sous la colonne Identifiant du cluster, avec les instances imbriquées dans les clusters.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/choose-clusters.png)
1. Cochez la case située à gauche de l'instance que vous souhaitez modifier.
1. Choisissez **Actions**, puis **Modify (Modifier)**.
1. Dans le volet **Modify instance: (Modifier l'instance : )**, apportez les modifications souhaitées. Vous pouvez apporter les modifications suivantes :
+ **Spécifications de l'instance** : identifiant et classe de l'instance. Contraintes d'attribution de noms aux identifiants d'instance :
+ **Identifiant d'instance** — Entrez un nom unique pour toutes les instances que vous possédez Compte AWS dans la région actuelle. L'identifiant d'instance doit contenir [1 à 63] caractères alphanumériques ou traits d'union, avoir une lettre comme premier caractère et ne peut pas se terminer par un tiret ni contenir deux tirets consécutifs.
+ **Classe d'instance** : dans le menu déroulant, sélectionnez une classe d'instance pour votre instance Amazon DocumentDB. Pour de plus amples informations, veuillez consulter [Gestion des classes d'instances](db-instance-classes.md).
+ **Autorité de certification** : certificat de serveur pour cette instance. Pour de plus amples informations, veuillez consulter [Mise à jour de vos certificats TLS Amazon DocumentDB](ca_cert_rotation.md).
+ **Basculement** : lors du basculement, l'instance présentant le niveau de promotion le plus élevé sera promue au niveau principal. Pour de plus amples informations, veuillez consulter [Basculement d'Amazon DocumentDB](failover.md).
+ **Maintenance** : fenêtre de maintenance au cours de laquelle les modifications ou correctifs en attente sont appliqués aux instances du cluster.
1. Lorsque vous avez terminé, choisissez **Continue (continuer)** pour afficher un récapitulatif de vos modifications.
1. Après vérification de vos modifications, vous pouvez les appliquer immédiatement ou au cours de la fenêtre de maintenance suivante sous **Scheduling of modifications (Planification des modifications)**. Choisissez **Modify instance (Modifier l'instance)** pour enregistrer vos modifications. Vous pouvez également choisir **Cancel (Annuler)** pour ignorer vos modifications.
L'application de vos modifications prend quelques minutes. Vous pouvez uniquement utiliser l'instance lorsqu'elle présente le statut *disponible*. Vous pouvez surveiller l'état de l'instance en utilisant la console ou la AWS CLI. Pour de plus amples informations, veuillez consulter [Surveillance de l'état d'une instance Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Pour modifier une instance Amazon DocumentDB spécifique à l'aide du AWS CLI, utilisez le `modify-db-instance` avec les paramètres suivants. Pour plus d'informations, voir [Modifier DBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html). Le code suivant modifie la classe d'instance en `db.r5.large` pour l'instance `sample-instance`.
**Parameters**
+ **--db-instance-identifier** — Obligatoire. Identifiant de l'instance à modifier.
+ **--db-instance-class**— Facultatif La nouvelle capacité de calcul et de mémoire de l'instance ; par exemple,`db.r5.large`. Les classes d'instance ne sont pas toutes disponibles Régions AWS. Si vous modifiez la classe d'instance, une panne se produit lors de la modification. La modification est appliquée lors de la fenêtre de maintenance suivante, sauf si `ApplyImmediately` elle est spécifiée comme vraie pour cette demande.
+ **--apply-immediately**ou **--no-apply-immediately** — Facultatif. Indique si cette modification doit être appliquée immédiatement ou s'il faut attendre le prochain créneau de maintenance. Si ce paramètre n'est pas appliqué, la modification est réalisée au cours du créneau de maintenance suivant.
**Example**
Pour Linux, macOS ou Unix :
```
aws docdb modify-db-instance \
--db-instance-identifier sample-instance \
--db-instance-class db.r5.large \
--apply-immediately
```
Pour Windows :
```
aws docdb modify-db-instance ^
--db-instance-identifier sample-instance ^
--db-instance-class db.r5.large ^
--apply-immediately
```
Le résultat de cette opération ressemble à ceci.
```
{
"DBInstances": [
{
"DBInstanceIdentifier": "sample-instance-1",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "modifying",
"Endpoint": {
"Address": "sample-instance-1.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-01-10T22:18:55.921Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1a",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:10:57-sun:11:27",
"PendingModifiedValues": {
"DBInstanceClass": "db.r5.large"
},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:sample-instance-1",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
]
}
```
L'application de vos modifications prend quelques minutes. Vous pouvez uniquement utiliser l'instance lorsqu'elle présente le statut *disponible*. Vous pouvez surveiller l'état de l'instance à l'aide du AWS Management Console ou AWS CLI. Pour de plus amples informations, veuillez consulter [Surveillance de l'état d'une instance Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
# Redémarrage d'une instance Amazon DocumentDB
Il se peut que vous deviez redémarrer votre instance Amazon DocumentDB, généralement pour des raisons de maintenance. Par exemple, si vous effectuez certaines modifications, telles que la modification du groupe de paramètres associé à un cluster, vous devez redémarrer les instances du cluster pour que ces modifications prennent effet. Vous pouvez redémarrer une instance spécifiée à l'aide du AWS Management Console ou du AWS CLI.
Le redémarrage d'une instance entraîne celui du service du moteur de base de données. Le redémarrage d'une instance entraîne une interruption momentanée, au cours de laquelle le statut de l'instance est défini sur `rebooting`. Un événement Amazon DocumentDB est créé lorsque le redémarrage est terminé.
Le redémarrage d'une instance n'entraîne pas de basculement. Pour basculer un cluster Amazon DocumentDB, utilisez AWS Management Console l'opération ou AWS CLI . `failover-db-cluster` Pour de plus amples informations, veuillez consulter [Basculement d'Amazon DocumentDB](failover.md).
Vous ne pouvez pas redémarre votre instance si celle-ci n'est pas à l'état *disponible*. Votre base de données peut être indisponible pour plusieurs raisons, notamment pour cause de modification demandée précédemment ou d'action de créneau de maintenance. Pour de plus amples informations sur les états d'instance, veuillez consulter [Surveillance de l'état d'une instance Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS Management Console ]
La procédure suivante redémarre l'instance que vous spécifiez à 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 boîte de navigation Clusters, vous verrez la colonne **Cluster Identifier**. Vos instances sont répertoriées sous des clusters, comme dans la capture d'écran ci-dessous.
![\[Tableau des clusters présentant la liste des clusters sous la colonne Identifiant du cluster, avec les instances imbriquées dans les clusters.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/choose-clusters.png)
1. Cochez la case située à gauche de l'instance que vous souhaitez redémarrer.
1. Choisissez **Actions**, **Reboot (Redémarrer)**, puis **Reboot (Redémarrer)** pour confirmer votre redémarrage.
Le redémarrage de votre instance prend quelques minutes. Vous pouvez uniquement utiliser l'instance lorsqu'elle présente le statut *disponible*. Vous pouvez surveiller le statut de l'instance en utilisant la console ou la AWS CLI. Pour de plus amples informations, veuillez consulter [Surveillance de l'état d'une instance Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Pour redémarrer une instance Amazon DocumentDB, utilisez l'`reboot-db-instance`opération avec le `--db-instance-identifier` paramètre. Ce paramètre spécifie l'identifiant de l'instance à redémarrer.
Le code suivant redémarre l'instance `sample-instance`.
**Example**
Pour Linux, macOS ou Unix :
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-instance
```
Pour Windows :
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-instance
```
Le résultat de cette opération ressemble à ceci.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "rebooting",
"Endpoint": {
"Address": "sample-instance.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
Le redémarrage de votre instance prend quelques minutes. Vous pouvez uniquement utiliser l'instance lorsqu'elle présente le statut *disponible*. Vous pouvez surveiller l'état de l'instance en utilisant la console ou la AWS CLI. Pour de plus amples informations, veuillez consulter [Surveillance de l'état d'une instance Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
# Suppression d'une instance Amazon DocumentDB
Vous pouvez supprimer votre instance Amazon DocumentDB à l'aide du AWS Management Console ou du. AWS CLI Pour supprimer une instance, l'instance doit être à l'état *available (disponible)*. Vous ne pouvez pas supprimer une instance qui est arrêtée. Si le cluster Amazon DocumentDB qui contient votre instance est arrêté, démarrez d'abord le cluster, attendez qu'elle soit *disponible*, puis supprimez-la. Pour de plus amples informations, veuillez consulter [Arrêt et démarrage d'un cluster Amazon DocumentDB](db-cluster-stop-start.md).
**Note**
Amazon DocumentDB stocke toutes vos données dans le volume du cluster. Les données restent dans ce volume de cluster, même si vous supprimez toutes les instances de votre cluster. Si vous avez besoin d'accéder aux données à nouveau, vous pouvez ajouter une instance au cluster à tout moment et reprendre votre activité là où vous l'aviez laissée.
------
#### [ Using the AWS Management Console ]
La procédure suivante supprime une instance Amazon DocumentDB spécifiée à 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 boîte de navigation Clusters, vous verrez la colonne **Cluster Identifier**. Vos instances sont répertoriées sous des clusters, comme dans la capture d'écran ci-dessous.
![\[Tableau des clusters présentant la liste des clusters sous la colonne Identifiant du cluster, avec les instances imbriquées dans les clusters.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/choose-clusters.png)
1. Cochez la case située à gauche de l'instance que vous souhaitez supprimer.
1. Choisissez **Actions**, puis **Delete (Supprimer)**.
1. Si vous supprimez la dernière instance de votre cluster :
+ **Create final cluster snapshot? (Créer un instantané final de cluster ?)** — Choisissez **Oui** si vous souhaitez créer un instantané final avant que le cluster ne soit supprimé. Sinon, choisissez **Non**.
+ **Nom du cliché final** : si vous choisissez de créer un instantané final, entrez l'identifiant du nouvel instantané de cluster créé.
+ **Delete instance? (Supprimer l'instance ?)** — Entrez la phrase **supprimer le cluster entier** dans le champ pour confirmer la suppression.
1. Si vous ne supprimez pas la dernière instance de votre cluster :
+ **Delete instance? (Supprimer l'instance ?)** — Entrez la phrase **supprimez-moi** dans le champ pour confirmer la suppression.
1. Sélectionnez **Delete (Supprimer)** pour supprimer l'instance.
La suppression de l'instance prend plusieurs minutes. Pour surveiller l'état d'une instance, consultez [Surveillance de l'état d'une instance Amazon DocumentDB](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
La procédure suivante supprime une instance Amazon DocumentDB à l'aide du. AWS CLI
1. **Tout d'abord, déterminez le nombre d'instances présentes dans votre cluster Amazon DocumentDB :**
Pour déterminer le nombre d'instances de votre cluster, exécutez la commande `describe-db-clusters`, comme suit.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
Le résultat de cette opération ressemble à ceci.
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
1. **S'il existe plusieurs instances dans votre cluster Amazon DocumentDB :**
Pour supprimer une instance Amazon DocumentDB spécifiée, utilisez la `delete-db-instance` commande avec le `--db-instance-identifier` paramètre, comme indiqué ci-dessous. La suppression de l'instance prend plusieurs minutes. Pour surveiller l'état d'une instance, consultez [Surveillance de l'état d'une instance Amazon DocumentDB](monitoring_docdb-instance_status.md).
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance-2
```
Le résultat de cette opération ressemble à ceci.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "deleting",
"Endpoint": {
"Address": "sample-instance-2.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
1. **Si l'instance que vous souhaitez supprimer est la dernière instance de votre cluster Amazon DocumentDB :**
Si vous supprimez la dernière instance d'un cluster Amazon DocumentDB, vous supprimez également ce cluster ainsi que les instantanés automatiques et les sauvegardes continues associés à ce cluster.
Pour supprimer la dernière instance de votre cluster, vous pouvez supprimer le cluster et éventuellement créer un instantané final. Pour de plus amples informations, veuillez consulter [Suppression d'un cluster Amazon DocumentDB](db-cluster-delete.md).
------
## Protection contre la suppression
La suppression de la dernière instance d'un cluster Amazon DocumentDB entraîne également la suppression du cluster, ainsi que des instantanés automatiques et des sauvegardes continues associés à ce cluster. Amazon DocumentDB applique la protection contre la suppression à un cluster, que vous exécutiez l'opération de suppression à l'aide du ou du AWS Management Console . 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. Pour de plus amples informations, veuillez consulter [Suppression d'un cluster Amazon DocumentDB](db-cluster-delete.md).
# Gestion des classes d'instances
La classe d'instance détermine le calcul et la capacité de mémoire d'une instance Amazon DocumentDB (compatible avec MongoDB). La classe d'instance dont vous avez besoin varie selon vos exigences en mémoire et en puissance de traitement.
Amazon DocumentDB prend en charge les familles de classes d'instances R4, R5, R6G, R8G, T3 et T4G. Il s'agit de classes d'instance de la génération actuelle optimisées pour les applications exigeantes en mémoire. Pour les spécifications sur ces classes, consultez [Spécifications des classes d'instances](#db-instance-class-specs).
**Topics**
+ [Déterminer une classe d'instance](#db-instance-class-determining)
+ [Modification de la classe d'une instance](#db-instance-class-changing)
+ [Classes d'instances prises en charge par région](#db-instance-classes-by-region)
+ [Spécifications des classes d'instances](#db-instance-class-specs)
## Déterminer une classe d'instance
Pour déterminer la classe d'une instance, vous pouvez utiliser l'`describe-db-instances` AWS CLI opération AWS Management Console ou.
------
#### [ Using the AWS Management Console ]
Pour déterminer la classe d'instance pour les instances de votre cluster, effectuez les étapes suivantes dans 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 volet de navigation, choisissez **Clusters** pour trouver l'instance qui vous intéresse.
**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 boîte de navigation Clusters, vous verrez la colonne **Cluster Identifier**. Vos instances sont répertoriées sous des clusters, comme dans la capture d'écran ci-dessous.
![\[Tableau des clusters indiquant comment une instance est imbriquée sous un cluster.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/choose-clusters.png)
1. Dans la liste des instances, développez le cluster pour trouver les instances qui vous intéressent. Trouvez l'instance que vous souhaitez. Regardez ensuite la colonne **Size** de la ligne de l'instance pour voir sa classe d'instance.
Dans l'image suivante, la classe d'instance pour `robo3t` est `db.r5.4xlarge`.
![\[Liste des instances dans le tableau Clusters avec la colonne Taille indiquant le type d'instance.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/instance-class.png)
------
#### [ Using the AWS CLI ]
Pour déterminer la classe d'une instance à l'aide de AWS CLI, utilisez l'`describe-db-instances`opération avec les paramètres suivants.
+ **--db-instance-identifier**— Facultatif. Spécifie l'instance pour laquelle vous voulez déterminer la classe. Si cet élément n'est pas spécifié, `describe-db-instances` renvoie une description de 100 de vos instances au plus.
+ **--query**— Facultatif. Spécifie les membres de l'instance à inclure dans les résultats. Si ce paramètre n'est pas spécifié, tous les membres de l'instance sont renvoyés.
**Example**
L'exemple suivant permet de trouver le nom et la classe de l'instance`sample-instance-1`.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
--db-instance-identifier sample-instance-1
```
Pour Windows :
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
--db-instance-identifier sample-instance-1
```
Le résultat de cette opération ressemble à ceci.
```
[
[
"sample-instance-1",
"db.r5.large"
]
```
**Example**
L'exemple suivant trouve le nom et la classe de l'instance pour un maximum de 100 instances Amazon DocumentDB.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
--filter Name=engine,Values=docdb
```
Pour Windows :
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
--filter Name=engine,Values=docdb
```
Le résultat de cette opération ressemble à ceci.
```
[
[
"sample-instance-1",
"db.r5.large"
],
[
"sample-instance-2",
"db.r5.large"
],
[
"sample-instance-3",
"db.r5.4xlarge"
],
[
"sample-instance-4",
"db.r5.4xlarge"
]
]
```
Pour de plus amples informations, veuillez consulter [Décrire les instances Amazon DocumentDB](db-instance-view-details.md).
------
## Modification de la classe d'une instance
Vous pouvez modifier la classe d'instance de votre instance à l'aide du AWS Management Console ou du AWS CLI. Pour de plus amples informations, veuillez consulter [Modification d'une instance Amazon DocumentDB](db-instance-modify.md).
## Classes d'instances prises en charge par région
Amazon DocumentDB prend en charge les classes d'instance suivantes :
+ `R8G`—Dernière génération d'instances optimisées pour la mémoire alimentées par des processeurs AWS Graviton4 basés sur ARM qui offrent des performances jusqu'à 30 % supérieures à celles des instances R6G.
+ `R6G`—Instances optimisées pour la mémoire alimentées par des processeurs AWS Graviton2 basés sur ARM qui offrent des performances jusqu'à 30 % supérieures à celles des instances R5 à un coût inférieur de 5 %.
+ `R6GD`—Instances R6G optimisées pour la mémoire avec stockage local sur disque SSD (Solid State DriveNVMe) basé sur la mémoire non volatile express () pour les données éphémères.
+ `R5`—Instances optimisées pour la mémoire qui offrent des performances jusqu'à 100 % supérieures à celles des instances R4 pour le même coût d'instance.
+ `R4`—Génération précédente d'instances optimisées pour la mémoire.
+ `T4G`—Type d'instance généraliste à faible coût et à faible coût de dernière génération alimenté par des processeurs AWS Graviton2 basés sur ARM qui fournit un niveau de performance CPU de référence, offrant un rapport prix/performances jusqu'à 35 % supérieur à celui des instances T3 et idéal pour exécuter des applications avec une utilisation modérée du processeur qui connaissent des pics d'utilisation temporaires.
+ `T3`—Type d'instance généraliste à faible coût qui fournit un niveau de performance du processeur de référence avec la possibilité d'augmenter l'utilisation du processeur à tout moment et aussi longtemps que nécessaire.
Pour obtenir des spécifications détaillées sur les classes d'instances, veuillez consulter [Spécifications des classes d'instances](#db-instance-class-specs).
**Note**
Le stockage optimisé pour les E/S n'est disponible que sur les versions 5.0 et 8.0 du moteur (clusters basés sur des instances).
Une classe d'instance particulière peut être prise en charge ou non dans une région donnée. Le tableau suivant indique quelles classes d'instances sont prises en charge par Amazon DocumentDB dans chaque région.
**Classes d'instances prises en charge par région**
| | Classes d'instances | Région | 8 G | R6GD | R6G | R5 | R4 | T4G | T3 | sans serveur |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| USA Est (Ohio) | Pris en charge | Pris en charge | Pris en charge | Pris en charge | Pris en charge | Pris en charge | Pris en charge | Pris en charge |
| USA Est (Virginie du Nord) | Pris en charge | Pris en charge | Pris en charge | Pris en charge | Pris en charge | Pris en charge | Pris en charge | Pris en charge |
| USA Ouest (Oregon) | Pris en charge | Pris en charge | Pris en charge | Pris en charge | Pris en charge | Pris en charge | Pris en charge | Pris en charge |
| Afrique (Le Cap) | | | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Amérique du Sud (São Paulo) | | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Asie-Pacifique (Hong Kong) | | | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Asie-Pacifique (Hyderabad) | | | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Asie-Pacifique (Malaisie) | | | Pris en charge | | | Pris en charge | Pris en charge | |
| Asie-Pacifique (Mumbai) | Pris en charge | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Asie-Pacifique (Osaka) | | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | |
| Asie-Pacifique (Séoul) | Pris en charge | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Asie-Pacifique (Sydney) | Pris en charge | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Asie-Pacifique (Jakarta) | Pris en charge | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | |
| Asie-Pacifique (Melbourne) | | | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | |
| Asie-Pacifique (Singapour) | Pris en charge | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Asie-Pacifique (Thaïlande) | | | Pris en charge | | | Pris en charge | Pris en charge | |
| Asie-Pacifique (Tokyo) | Pris en charge | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Canada (Centre) | | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Europe (Francfort) | Pris en charge | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Europe (Zurich) | | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | |
| Europe (Irlande) | Pris en charge | Pris en charge | Pris en charge | Pris en charge | Pris en charge | Pris en charge | Pris en charge | Pris en charge |
| Europe (Londres) | | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Europe (Milan) | | | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Europe (Paris) | | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Europe (Espagne) | Pris en charge | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Europe (Stockholm) | Pris en charge | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | |
| Mexique (Centre) | | | Pris en charge | | | Pris en charge | Pris en charge | |
| Moyen-Orient (EAU) | | | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Chine (Pékin) | | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Chine (Ningxia) | | | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| Israël (Tel Aviv) | | | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| AWS GovCloud (US-Ouest) | Pris en charge | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
| AWS GovCloud (USA Est) | | Pris en charge | Pris en charge | Pris en charge | | Pris en charge | Pris en charge | Pris en charge |
## Spécifications des classes d'instances
Le tableau suivant fournit des informations détaillées sur les classes d'instances Amazon DocumentDB, notamment les types d'instances pris en charge dans chaque classe. Vous trouverez des explications pour chaque colonne de tableau sous ce dernier.
| Classe d’instance | vCPU1 | Mémoire (GiB) 2 | NVMe Cache hiérarchisé SSD (GiB) 3 | Température maximale de stockage (GiB) 4 | Bande passante de référence/rafale (Gbit/s) 5 | Moteurs de soutien 6 |
| --- | --- | --- | --- | --- | --- | --- |
| R8G — Classe d'instance optimisée pour la mémoire de génération actuelle basée sur Graviton4 R8G est la toute dernière famille d'instances (Graviton4), disponible uniquement sur les versions 5.0 et 8.0 du moteur. Les tailles db.r8g.24xlarge et db.r8g.48xlarge ne sont pas encore disponibles. |
| db.r8g.large | 2 | 16 | - | 30 | 0,937 / 12,5 | 5.0.0 et 8.0.0 |
| db.r8g.xlarge | 4 | 32 | - | 60 | 1,875 / 12,5 | 5.0.0 et 8.0.0 |
| db.r8g.2xlarge | 8 | 64 | - | 121 | 3,75 / 15,0 | 5.0.0 et 8.0.0 |
| db.r8g.4xlarge | 16 | 128 | - | 243 | 7,5 / 15,0 | 5.0.0 et 8.0.0 |
| db.r8g.8xlarge | 32 | 256 | - | 488 | 15 | 5.0.0 et 8.0.0 |
| db.r8g.12xlarge | 48 | 384 | - | 732 | 22 | 5.0.0 et 8.0.0 |
| db.r8g.16xlarge | 64 | 512 | - | 987 | 30 | 5.0.0 et 8.0.0 |
| R6G — Classe d'instance optimisée pour la mémoire de génération actuelle basée sur Graviton2 |
| db.r6g.large | 2 | 16 | - | 32 | 0,75/10 | 4.0.0, 5.0.0 et 8.0.0 |
| db.r6g.xlarge | 4 | 32 | - | 63 | 1,25/10 | 4.0.0, 5.0.0 et 8.0.0 |
| db.r6g.2xlarge | 8 | 64 | - | 126 | 2,5/10 | 4.0.0, 5.0.0 et 8.0.0 |
| db.r6g.4xlarge | 16 | 128 | - | 252 | 5,0/ 10 | 4.0.0, 5.0.0 et 8.0.0 |
| db.r6g.8xlarge | 32 | 256 | - | 504 | 12 | 4.0.0, 5.0.0 et 8.0.0 |
| db.r6g.12xlarge | 48 | 384 | - | 756 | 20 | 4.0.0, 5.0.0 et 8.0.0 |
| db.r6g.16xlarge | 64 | 512 | - | 1008 | 25 | 4.0.0, 5.0.0 et 8.0.0 |
| R6GD — Classe d'instance basée sur Graviton2 NVMe basée sur la génération actuelle |
| db.r6gd.xlarge | 4 | 32 | 173 | 64 | 1,25/10 | 5.0.0 et 8.0.0 |
| db.r6gd.2xlarge | 8 | 64 | 346 | 128 | 2,5/10 | 5.0.0 et 8.0.0 |
| db.r6gd.4xlarge | 16 | 128 | 694 | 256 | 5,0/ 10 | 5.0.0 et 8.0.0 |
| db.r6gd.8xlarge | 32 | 256 | 1388 | 512 | 12 | 5.0.0 et 8.0.0 |
| db.r6gd.12xlarge | 48 | 384 | 2082 | 768 | 20 | 5.0.0 et 8.0.0 |
| db.r6gd.16xlarge | 64 | 512 | 2776 | 1 024 | 25 | 5.0.0 et 8.0.0 |
| R5 — Classe d'instance optimisée pour la mémoire de la génération précédente |
| db.r5.large | 2 | 16 | - | 31 | 0,75/10 | 3.6.0, 4.0.0, 5.0.0 et 8.0.0 |
| db.r5.xlarge | 4 | 32 | - | 62 | 1,25/10 | 3.6.0, 4.0.0, 5.0.0 et 8.0.0 |
| db.r5.2xlarge | 8 | 64 | - | 124 | 2,5/10 | 3.6.0, 4.0.0, 5.0.0 et 8.0.0 |
| db.r5.4xlarge | 16 | 128 | - | 249 | 5,0/ 10 | 3.6.0, 4.0.0, 5.0.0 et 8.0.0 |
| db.r5.8xlarge | 32 | 256 | - | 504 | 10 | 3.6.0, 4.0.0, 5.0.0 et 8.0.0 |
| db.r5.12xlarge | 48 | 384 | - | 748 | 12 | 3.6.0, 4.0.0, 5.0.0 et 8.0.0 |
| db.r5.16xlarge | 64 | 512 | - | 1008 | 20 | 3.6.0, 4.0.0, 5.0.0 et 8.0.0 |
| db.r5.24xlarge | 96 | 768 | - | 1 500 | 25 | 3.6.0, 4.0.0, 5.0.0 et 8.0.0 |
| R4 — Classe d'instance optimisée pour la mémoire de la génération précédente Les instances R4 ne sont prises en charge que sur la version 3.6 du moteur. Notez qu'Amazon DocumentDB 3.6 atteindra la fin du support standard le 30 mars 2026. Support étendu (payant) est disponible jusqu'en mars 2029. |
| db.r4.large | 2 | 15,25 | - | 30 | 0,75/10 | 3.6.0 uniquement |
| db.r4.xlarge | 4 | 30,5 | - | 60 | 1,25/10 | 3.6.0 uniquement |
| db.r4.2xlarge | 8 | 61 | - | 120 | 2,5/10 | 3.6.0 uniquement |
| db.r4.4xlarge | 16 | 122 | - | 240 | 5,0 /10 | 3.6.0 uniquement |
| db.r4.8xlarge | 32 | 244 | - | 480 | 10 | 3.6.0 uniquement |
| db.r4.16xlarge | 64 | 488 | - | 960 | 25 | 3.6.0 uniquement |
| T4G — Classes d'instances de performances éclatantes de dernière génération basées sur Graviton2 Les instances de la série T s'exécutent en mode Unlimited CPU burst. L'utilisation en rafale au-delà de la base de référence est facturée en supplément. Non pris en charge pour les clusters mondiaux. |
| db.t4g.medium | 2 | 4 | - | 8,13 | 0,256/5 | 4.0.0, 5.0.0 et 8.0.0 |
| T3 — Classes d'instances de performance burstable de la génération précédente |
| db.t3.medium | 2 | 4 | - | 7,5 | 0,256/5 | 3.6.0, 4.0.0, 5.0.0 et 8.0.0 |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/db-instance-classes.html) |
# Instances basées sur les volumes NVMe
NVMeLes instances sauvegardées offrent des performances de requête jusqu'à 7 fois plus rapides pour les applications dont les ensembles de données volumineux dépassent la mémoire d'une instance normale. Ces instances tirent parti du stockage SSD (Solid State DriveNVMe) basé sur la mémoire non volatile locale () disponible sur les instances r6gd pour stocker des données éphémères, réduisant ainsi l'accès au stockage sur le réseau et améliorant la latence et le débit de lecture.
L'espace SSD local est divisé en deux sections :
+ **Cache hiérarchisé** : environ 73 % du SSD local est alloué sous forme de cache de base de données, ce qui permet au système de stocker jusqu'à cinq fois plus de pages de base de données que la mémoire principale seule. Le SSD local fait office de cache de second niveau, tandis que le cache tampon en mémoire existant reste le cache de premier niveau. La requête n'accède au stockage externe que si le cache tampon et le cache SSD ne fonctionnent pas.
+ **Stockage temporaire** : les 27 % restants sont réservés au stockage de fichiers temporaires non persistants, utilisé pour des requêtes complexes impliquant des tris ou des opérations gourmandes en ressources, telles que la création d'index. Sur les instances normales, l'espace temporaire se trouve sur un volume Amazon Elastic Block Store (EBS). Le stockage temporaire hébergé localement sur le SSD réduit jusqu'à deux fois le temps de latence des requêtes impliquant des tris et accélère les opérations gourmandes en ressources, telles que la création d'index.
Les détails concernant le type d'instances NVMe sauvegardées pris en charge et ses spécifications se trouvent dans[Spécifications des classes d'instances](db-instance-classes.md#db-instance-class-specs).
**Topics**
+ [Cas d'utilisation recommandés pour les instances NVMe soutenues par -back](#nvme-use-cases)
+ [Utilisation d'instances NVMe sauvegardées avec Amazon DocumentDB](#using-nvme)
+ [Surveillance des instances NVMe basées sur la surveillance](#monitoring-nvme)
## Cas d'utilisation recommandés pour les instances NVMe soutenues par -back
Nous vous recommandons d'utiliser des instances NVMe basées sur -backed dans les scénarios suivants :
+ **Charges de travail intensives en lecture** : si votre charge de travail est gourmande en lecture et que la taille de votre ensemble de données est supérieure à la taille du cache tampon, comme en témoignent des `ReadIOPS` indicateurs faibles `BufferCacheHitRatio` et élevés, les instances NVMe sauvegardées peuvent apporter des avantages en termes de performances.
+ **Charges de travail gourmandes en mises à jour** : si votre charge de travail est gourmande en mises à jour et que la collecte des déchets ne parvient pas à suivre le rythme en raison de la latence de lecture sur le stockage réseau, les instances NVMe sauvegardées peuvent aider à atténuer le problème.
NVMe-les instances sauvegardées peuvent bénéficier de divers cas d'utilisation, notamment :
+ **Applications à l'échelle d'Internet** : les applications telles que le traitement des paiements, la facturation et le commerce électronique assorties d'accords de niveau de service (SLAs) stricts peuvent tirer parti des avantages en termes de performances des instances NVMe soutenues.
+ **Tableaux de bord de création de rapports en temps réel** — Les tableaux de bord qui exécutent des centaines de requêtes pour des mesures ou la collecte de données peuvent bénéficier de la faible latence et du débit élevé des instances soutenues. NVMe
+ **Applications d'intelligence artificielle génératives** : les applications qui utilisent la recherche vectorielle pour trouver les voisins exacts ou les plus proches parmi des millions d'intégrations vectorielles peuvent tirer parti des hautes performances des instances soutenues par des NVMe vecteurs.
## Utilisation d'instances NVMe sauvegardées avec Amazon DocumentDB
Pour utiliser des instances d'Amazon DocumentDB basées sur NVMe -backed, procédez comme suit :
+ Créez un cluster Amazon DocumentDB et ajoutez l'une des classes d'instance NVMe soutenues par -backed. Pour de plus amples informations, veuillez consulter [Création d'un cluster Amazon DocumentDB](db-cluster-create.md).
+ Vous pouvez également modifier un cluster Amazon DocumentDB existant pour utiliser l'une des classes d'instance NVMe soutenues par -backed. Pour de plus amples informations, veuillez consulter [Modification d'un cluster Amazon DocumentDB](db-cluster-modify.md).
Pour vérifier la disponibilité des instances NVMe soutenues dans différentes AWS régions, consultez[Classes d'instances prises en charge par région](db-instance-classes.md#db-instance-classes-by-region).
Si vous souhaitez revenir d'une instance basée sur NVMe -backed à une instance normale, modifiez la classe d'instance de base de données de votre instance Amazon DocumentDB en une classe d'instance similaire sans NVMe stockage. Par exemple, si votre classe d'instance actuelle est « db.r6gd.4xlarge », choisissez « db.r6g.4xlarge » pour revenir en arrière. Pour de plus amples informations, veuillez consulter [Modification d'un cluster Amazon DocumentDB](db-cluster-modify.md).
## Surveillance des instances NVMe basées sur la surveillance
Outre les métriques d'instance standard disponibles sur Amazon CloudWatch, les instances NVMe soutenues par -backed émettent des métriques supplémentaires spécifiques au stockage SSD NVMe basé sur le stockage, aux IOPS et au débit.
```
NVMeStorageCacheHitRatio
FreeNVMeStorage
ReadIOPSNVMeStorage
ReadLatencyNVMeStorage
ReadThroughputNVMeStorage
WriteIOPSNVMeStorage
WriteLatencyNVMeStorage
WriteThroughputNVMeStorage
```
Pour plus d'informations sur ces mesures, voir [NVMe-métriques d'instance soutenues](cloud_watch.md#nvme-metrics)