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'à 10 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](CommonParameters.md).
** GlobalClusterIdentifier **
Identifiant de cluster du nouveau cluster global.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255 caractères.
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](API_GlobalCluster.md)
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** DBClusterNotFoundFault **
`DBClusterIdentifier`ne fait pas référence à un cluster existant.
Code d’état HTTP :404
** GlobalClusterAlreadyExistsFault **
`GlobalClusterIdentifier` existe 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
## 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/CreateGlobalCluster)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateGlobalCluster)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateGlobalCluster)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateGlobalCluster)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateGlobalCluster)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateGlobalCluster)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateGlobalCluster)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateGlobalCluster)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateGlobalCluster)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateGlobalCluster)