CreateDBCluster - Amazon DocumentDB

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.

CreateDBCluster

Crée un nouveau cluster Amazon DocumentDB.

Paramètres de demande

Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.

DBClusterIdentifier

L'identifiant du cluster. 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 trait d'union ni contenir deux traits d'union consécutifs.

Exemple : my-cluster

Type : String

Obligatoire : oui

Engine

Nom du moteur de base de données à utiliser pour ce cluster.

Valeurs valides : docdb

Type : String

Obligatoire : oui

AvailabilityZones. AvailabilityZoneN.

Liste des zones de EC2 disponibilité Amazon dans lesquelles les instances du cluster peuvent être créées.

Type : tableau de chaînes

Obligatoire : non

BackupRetentionPeriod

Nombre de jours de conservation des sauvegardes automatiques. Vous devez spécifier une valeur minimale de 1.

Par défaut : 1

Contraintes :

  • Doit être une valeur comprise entre 1 et 35.

Type : entier

Obligatoire : non

DBClusterParameterGroupName

Nom du groupe de paramètres de cluster à associer à ce cluster.

Type : chaîne

Obligatoire : non

DBSubnetGroupName

Groupe de sous-réseaux à associer à ce cluster.

Contraintes : doit correspondre au nom d'un DBSubnetGroup existant. Impossible de conserver le nom par défaut.

Exemple : mySubnetgroup

Type : chaîne

Obligatoire : non

DeletionProtection

Spécifie si ce cluster peut être supprimé. Si cette option DeletionProtection est activée, le cluster ne peut pas être supprimé sauf s'il DeletionProtection est modifié et désactivé. DeletionProtectionprotège les clusters contre la suppression accidentelle.

Type : booléen

Obligatoire : non

EnableCloudwatchLogsExports.membre.n

Liste des types de journaux qui doivent être activés pour être exportés vers Amazon CloudWatch Logs. Vous pouvez activer les journaux d'audit ou les journaux de profileur. Pour plus d'informations, consultez Audit des événements Amazon DocumentDB et profilage des opérations Amazon DocumentDB.

Type : tableau de chaînes

Obligatoire : non

EngineVersion

Numéro de version du moteur de base de données à utiliser. La version --engine-version utilise par défaut la dernière version majeure du moteur. Pour les charges de travail de production, nous vous recommandons de déclarer explicitement ce paramètre avec la version majeur du moteur prévue.

Type : chaîne

Obligatoire : non

GlobalClusterIdentifier

Identifiant de cluster du nouveau cluster global.

Type : String

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255.

Modèle : [A-Za-z][0-9A-Za-z-:._]*

Obligatoire : non

KmsKeyId

Identifiant de AWS KMS clé pour un cluster chiffré.

L'identifiant de AWS KMS clé est le nom de ressource Amazon (ARN) de la clé de AWS KMS chiffrement. Si vous créez un cluster en utilisant celui Compte AWS qui possède la clé de AWS KMS chiffrement utilisée pour chiffrer le nouveau cluster, vous pouvez utiliser l'alias de AWS KMS clé au lieu de celui ARN pour la clé de AWS KMS chiffrement.

Si aucune clé de chiffrement n'est spécifiée dans KmsKeyId :

  • Si le paramètre StorageEncrypted est true, Amazon DocumentDB utilise votre clé de chiffrement par défaut.

AWS KMS crée la clé de chiffrement par défaut pour votre Compte AWS. Vous disposez Compte AWS d'une clé de chiffrement par défaut différente pour chacune d'entre elles Régions AWS.

Type : chaîne

Obligatoire : non

ManageMasterUserPassword

Spécifie s'il faut gérer le mot de passe de l'utilisateur principal avec Amazon Web Services Secrets Manager.

Contrainte : vous ne pouvez pas gérer le mot de passe de l'utilisateur principal avec Amazon Web Services Secrets Manager s'il MasterUserPassword est spécifié.

Type : booléen

Obligatoire : non

MasterUsername

Nom de l'utilisateur principal du cluster.

Contraintes :

  • Doit comporter entre 1 et 63 lettres ou chiffres.

  • Le premier caractère doit être une lettre.

  • Ne doit pas être un mot réservé pour le moteur de base de données choisi.

Type : chaîne

Obligatoire : non

MasterUserPassword

Mot de passe de l'utilisateur principal de la base de données. Ce mot de passe peut contenir n'importe quel ASCII caractère imprimable à l'exception d'une barre oblique (/), d'un guillemet double («) ou du symbole « at » (@).

Contraintes : doit comporter entre 8 et 100 caractères.

Type : chaîne

Obligatoire : non

MasterUserSecretKmsKeyId

Identifiant KMS clé Amazon Web Services permettant de chiffrer un secret généré et géré automatiquement dans Amazon Web Services Secrets Manager. Ce paramètre n'est valide que si le mot de passe de l'utilisateur principal est géré par Amazon DocumentDB dans Amazon Web Services Secrets Manager pour le cluster de base de données.

L'identifiant de KMS clé Amazon Web Services est la cléARN, l'identifiant de clé, l'alias ARN ou le nom d'alias de la KMS clé. Pour utiliser une KMS clé dans un autre compte Amazon Web Services, spécifiez la clé ARN ou l'aliasARN.

Si vous ne le spécifiez pasMasterUserSecretKmsKeyId, la aws/secretsmanager KMS clé est utilisée pour chiffrer le secret. Si le secret se trouve dans un autre compte Amazon Web Services, vous ne pouvez pas utiliser la aws/secretsmanager KMS clé pour le chiffrer et vous devez utiliser une KMS clé gérée par le client.

Il existe une KMS clé par défaut pour votre compte Amazon Web Services. Votre compte Amazon Web Services possède une KMS clé par défaut différente pour chaque région Amazon Web Services.

Type : chaîne

Obligatoire : non

Port

Numéro de port sur lequel les instances du cluster acceptent les connexions.

Type : entier

Obligatoire : non

PreferredBackupWindow

Plage de temps quotidienne au cours de laquelle les sauvegardes automatiques sont créées si cette fonctionnalité est activée via le paramètre BackupRetentionPeriod.

La valeur par défaut est une fenêtre de 30 minutes sélectionnée au hasard dans un intervalle de 8 heures pour chacune d'entre elles. Région AWS

Contraintes :

  • Doit être au format hh24:mi-hh24:mi.

  • Doit être exprimé en temps universel coordonné (UTC).

  • Ne doit pas être en conflit avec la fenêtre de maintenance préférée.

  • Doit être de 30 minutes minimum.

Type : chaîne

Obligatoire : non

PreferredMaintenanceWindow

La plage horaire hebdomadaire pendant laquelle la maintenance du système peut avoir lieu, en temps universel coordonné (UTC).

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

PreSignedUrl

Cette option n'est pas prise en charge actuellement.

Type : chaîne

Obligatoire : non

StorageEncrypted

Indique si le cluster est chiffré.

Type : booléen

Obligatoire : non

StorageType

Type de stockage à associer au cluster de base de données.

Pour plus d'informations sur les types de stockage pour les clusters Amazon DocumentDB, consultez la section Configurations de stockage des clusters dans le manuel Amazon DocumentDB Developer Guide.

Valeurs valides pour le type de stockage - standard | iopt1

La valeur par défaut est standard

Note

Lorsque vous créez un cluster de base de données DocumentDB avec le type de stockage défini suriopt1, le type de stockage est renvoyé dans la réponse. Le type de stockage n'est pas renvoyé lorsque vous le définissez surstandard.

Type : chaîne

Obligatoire : non

Étiquettes.Tag.N

Balises à attribuer au cluster.

Type : tableau d’objets Tag

Obligatoire : non

VpcSecurityGroupIds. VpcSecurityGroupIdN.

Liste des groupes de EC2 VPC sécurité à associer à ce cluster.

Type : tableau de chaînes

Obligatoire : non

Éléments de réponse

L'élément suivant est renvoyé par le service.

DBCluster

Informations détaillées sur un cluster.

Type : objet DBCluster

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

DBClusterAlreadyExistsFault

Vous avez déjà un cluster avec l'identifiant indiqué.

HTTPCode de statut : 400

DBClusterNotFoundFault

DBClusterIdentifierne fait pas référence à un cluster existant.

HTTPCode de statut : 404

DBClusterParameterGroupNotFound

DBClusterParameterGroupNamene fait pas référence à un groupe de paramètres de cluster existant.

HTTPCode de statut : 404

DBClusterQuotaExceededFault

Le cluster ne peut pas être créé car vous avez atteint le quota maximum autorisé de clusters.

HTTPCode de statut : 403

DBInstanceNotFound

DBInstanceIdentifierne fait pas référence à une instance existante.

HTTPCode de statut : 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é.

HTTPCode de statut : 400

DBSubnetGroupNotFoundFault

DBSubnetGroupNamene fait pas référence à un groupe de sous-réseaux existant.

HTTPCode de statut : 404

GlobalClusterNotFoundFault

GlobalClusterIdentifierCela ne fait pas référence à un cluster mondial existant.

HTTPCode de statut : 404

InsufficientStorageClusterCapacity

L'espace de stockage disponible est insuffisant pour l'action en cours. Vous pouvez peut-être résoudre cette erreur en mettant à jour votre groupe de sous-réseaux afin qu'il utilise différentes zones de disponibilité disposant d'un espace de stockage plus important.

HTTPCode de statut : 400

InvalidDBClusterStateFault

Le cluster n'est pas dans un état valide.

HTTPCode de statut : 400

InvalidDBInstanceState

L'instance spécifiée n'est pas dans l'état disponible.

HTTPCode de statut : 400

InvalidDBSubnetGroupStateFault

Le groupe de sous-réseaux ne peut pas être supprimé car il est en cours d'utilisation.

HTTPCode de statut : 400

InvalidGlobalClusterStateFault

L'opération demandée ne peut pas être effectuée tant que le cluster est dans cet état.

HTTPCode de statut : 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 commun ()VPC.

HTTPCode de statut : 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.

HTTPCode de statut : 400

KMSKeyNotAccessibleFault

Une erreur s'est produite lors de l'accès à une AWS KMS clé.

HTTPCode de statut : 400

StorageQuotaExceeded

La demande vous obligerait à dépasser la quantité de stockage autorisée disponible sur toutes les instances.

HTTPCode de statut : 400

consultez aussi

Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :