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.
CreateGlobalCluster
Crée un cluster global Amazon DocumentDB qui peut s'étendre sur plusieurs. Régions AWS Le cluster global contient un cluster principal doté d'une capacité de lecture-écriture, et jusqu'à des clusters secondaires en lecture seule. Les clusters mondiaux utilisent une réplication rapide basée sur le stockage entre les régions avec des latences inférieures à une seconde, en utilisant une infrastructure dédiée sans impact sur les performances de votre charge de travail.
Vous pouvez créer un cluster global initialement vide, puis y ajouter un cluster principal et un cluster secondaire. Vous pouvez également spécifier un cluster existant lors de l'opération de création, et ce cluster devient le principal du cluster global.
Note
Cette action s'applique uniquement aux clusters Amazon DocumentDB.
Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
- GlobalClusterIdentifier
-
Identifiant de cluster du nouveau cluster global.
Type : chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255.
Modèle :
[A-Za-z][0-9A-Za-z-:._]*Obligatoire : oui
- DatabaseName
-
Nom de votre base de données comprenant au maximum 64 caractères alphanumériques. Si vous ne fournissez pas de nom, Amazon DocumentDB ne créera pas de base de données dans le cluster global que vous créez.
Type : chaîne
Obligatoire : non
- DeletionProtection
-
Le paramètre de protection contre la suppression pour le nouveau cluster global. Le cluster global ne peut pas être supprimé lorsque la protection contre la suppression est activée.
Type : booléen
Obligatoire : non
- Engine
-
Nom du moteur de base de données à utiliser pour ce cluster.
Type : chaîne
Obligatoire : non
- EngineVersion
-
Version du moteur du cluster global.
Type : chaîne
Obligatoire : non
- SourceDBClusterIdentifier
-
Le nom de ressource Amazon (ARN) à utiliser comme cluster principal du cluster mondial. Ce paramètre est facultatif.
Type : chaîne
Obligatoire : non
- StorageEncrypted
-
Le paramètre de chiffrement du stockage pour le nouveau cluster global.
Type : booléen
Obligatoire : non
Éléments de réponse
L'élément suivant est renvoyé par le service.
- GlobalCluster
-
Type de données représentant un cluster global Amazon DocumentDB.
Type : objet GlobalCluster
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- DBClusterNotFoundFault
-
DBClusterIdentifierne fait pas référence à un cluster existant.Code d’état HTTP : 404
- GlobalClusterAlreadyExistsFault
-
GlobalClusterIdentifierexiste déjà. Choisissez un nouvel identifiant de cluster global (nom unique) pour créer un nouveau cluster global.Code d’état HTTP : 400
- GlobalClusterQuotaExceededFault
-
Le nombre de clusters globaux pour ce compte est déjà au maximum autorisé.
Code d’état HTTP : 400
- InvalidDBClusterStateFault
-
Le cluster n'est pas dans un état valide.
Code d’état HTTP : 400
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :
