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.
# CreateDBInstance
Crée une nouvelle instance.
## Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).
** DBClusterIdentifier **
Identifiant du cluster auquel l'instance appartiendra.
Type : Chaîne
Obligatoire : oui
** DBInstanceClass **
Capacité de calcul et de mémoire de l'instance ; par exemple, `db.r5.large`.
Type : Chaîne
Obligatoire : oui
** DBInstanceIdentifier **
Identifiant de l’instance. Ce paramètre est stocké sous la forme d'une chaîne en lettres minuscules.
Contraintes:
+ Doit contenir entre 1 et 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.
Exemple : `mydbinstance`
Type : Chaîne
Obligatoire : oui
** Engine **
Nom du moteur de base de données à utiliser pour cette instance.
Valeur valide : `docdb`
Type : Chaîne
Obligatoire : oui
** AutoMinorVersionUpgrade **
Ce paramètre ne s'applique pas à Amazon DocumentDB. Amazon DocumentDB n'effectue pas de mises à niveau mineures de version, quelle que soit la valeur définie.
Valeur par défaut : `false`
Type : booléen
Obligatoire : non
** AvailabilityZone **
Zone de disponibilité Amazon EC2 dans laquelle l'instance est créée.
Par défaut : une zone de disponibilité choisie au hasard par le système dans le terminal. Région AWS
Exemple : `us-east-1d`
Type : chaîne
Obligatoire : non
** CACertificateIdentifier **
L'identifiant de certificat CA à utiliser pour le certificat de serveur de l'instance de base de données.
*Pour plus d'informations, consultez la section [Mise à jour de vos certificats TLS Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/ca_cert_rotation.html) et [chiffrement des données en transit dans le](https://docs.aws.amazon.com/documentdb/latest/developerguide/security.encryption.ssl.html) guide du développeur Amazon DocumentDB.*
Type : chaîne
Obligatoire : non
** CopyTagsToSnapshot **
Une valeur qui indique si vous voulez copier toutes les balises à partir de l'instance de base de données pour les instantanés de l'instance de base de données. Par défaut, les balises ne sont pas copiées.
Type : booléen
Obligatoire : non
** EnablePerformanceInsights **
Une valeur qui indique s'il convient d'activer Performance Insights pour l'instance de base de données. Pour plus d'informations, voir [Utilisation d'Amazon Performance Insights](https://docs.aws.amazon.com/documentdb/latest/developerguide/performance-insights.html).
Type : booléen
Obligatoire : non
** PerformanceInsightsKMSKeyId **
Identifiant AWS KMS clé pour le chiffrement des données Performance Insights.
L'identifiant de AWS KMS clé est l'ARN de la clé, l'ID de clé, l'alias ARN ou le nom d'alias de la clé KMS.
Si vous ne spécifiez aucune valeur pour PerformanceInsights KMSKey Id, Amazon DocumentDB utilise votre clé KMS par défaut. Il existe une clé KMS par défaut pour votre compte Amazon Web Services. Votre compte Amazon Web Services possède une clé KMS par défaut différente pour chaque région Amazon Web Services.
Type : chaîne
Obligatoire : non
** PreferredMaintenanceWindow **
Intervalle de temps hebdomadaire, au format UTC (temps universel), pendant lequel a lieu la maintenance du système.
Format : `ddd:hh24:mi-ddd:hh24:mi`
La valeur par défaut est une fenêtre de 30 minutes sélectionnée au hasard dans un intervalle de 8 heures pour chacune d'elles Région AWS, survenant un jour aléatoire de la semaine.
Jours valides : Mon, Tue, Wed, Thu, Fri, Sat, Sun
Contraintes : fenêtre minimale de 30 minutes.
Type : chaîne
Obligatoire : non
** PromotionTier **
Valeur qui indique l'ordre dans lequel une réplique Amazon DocumentDB est promue vers l'instance principale après une défaillance de l'instance principale existante.
Valeur par défaut : 1
Valeurs valides : 0 à 15
Type : Integer
Obligatoire : non
**Étiquettes.Tag.N**
Balises à attribuer à l'instance. Vous pouvez attribuer jusqu'à 10 balises à une instance.
Type : tableau d’objets [Tag](API_Tag.md)
Obligatoire : non
## Éléments de réponse
L'élément suivant est renvoyé par le service.
** DBInstance **
Informations détaillées sur une instance.
Type : objet [DBInstance](API_DBInstance.md)
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** AuthorizationNotFound **
L'adresse IP CIDR ou le groupe de sécurité Amazon EC2 spécifié n'est pas autorisé pour le groupe de sécurité spécifié.
Amazon DocumentDB peut également ne pas être autorisé à effectuer les actions nécessaires en votre nom à l'aide d'IAM.
Code d’état HTTP :404
** DBClusterNotFoundFault **
`DBClusterIdentifier`ne fait pas référence à un cluster existant.
Code d’état HTTP :404
** DBInstanceAlreadyExists **
Vous avez déjà une instance avec l'identifiant indiqué.
Code d’état HTTP : 400
** DBParameterGroupNotFound **
`DBParameterGroupName`ne fait pas référence à un groupe de paramètres existant.
Code d’état HTTP :404
** DBSecurityGroupNotFound **
`DBSecurityGroupName`ne fait pas référence à un groupe de sécurité existant.
Code d’état HTTP :404
** DBSubnetGroupDoesNotCoverEnoughAZs **
Les sous-réseaux du groupe de sous-réseaux doivent couvrir au moins deux zones de disponibilité, sauf s'il n'existe qu'une seule zone de disponibilité.
Code d’état HTTP : 400
** DBSubnetGroupNotFoundFault **
`DBSubnetGroupName`ne fait pas référence à un groupe de sous-réseaux existant.
Code d’état HTTP :404
** InstanceQuotaExceeded **
La demande vous obligerait à dépasser le nombre d'instances autorisé.
Code d’état HTTP : 400
** InsufficientDBInstanceCapacity **
La classe d'instance spécifiée n'est pas disponible dans la zone de disponibilité spécifiée.
Code d’état HTTP : 400
** InvalidDBClusterStateFault **
Le cluster n'est pas dans un état valide.
Code d’état HTTP : 400
** InvalidSubnet **
Le sous-réseau demandé n'est pas valide ou plusieurs sous-réseaux ont été demandés mais ils ne se trouvent pas tous dans un cloud privé virtuel (VPC) commun.
Code d’état HTTP : 400
** InvalidVPCNetworkStateFault **
Le groupe de sous-réseaux ne couvre pas toutes les zones de disponibilité après sa création en raison des modifications apportées.
Code d’état HTTP : 400
** KMSKeyNotAccessibleFault **
Une erreur s'est produite lors de l'accès à une AWS KMS clé.
Code d’état HTTP : 400
** StorageQuotaExceeded **
La demande vous obligerait à dépasser la quantité de stockage autorisée disponible sur toutes les instances.
Code d’état HTTP : 400
** StorageTypeNotSupported **
Le stockage du paramètre spécifié ne `StorageType` peut pas être associé à l'instance de base de données.
Code d’état HTTP : 400
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateDBInstance)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateDBInstance)