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.

# SwitchoverGlobalCluster
<a name="API_SwitchoverGlobalCluster"></a>

Bascule le cluster Amazon DocumentDB secondaire spécifié en nouveau cluster Amazon DocumentDB principal dans le cluster de base de données global.

## Paramètres de demande
<a name="API_SwitchoverGlobalCluster_RequestParameters"></a>

 Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).

 ** GlobalClusterIdentifier **   
Identifiant du cluster de bases de données global Amazon DocumentDB à basculer. L'identifiant est la clé unique attribuée par l'utilisateur lors de la création du cluster. En d'autres termes, il s'agit du nom du cluster mondial. Ce paramètre ne fait pas la distinction majuscules/minuscules.  
Contraintes:  
+ Doit correspondre à l'identifiant d'un cluster global existant (base de données globale Amazon DocumentDB).
+ Longueur minimale de 1. Longueur maximale de 255 caractères.
Modèle : `[A-Za-z][0-9A-Za-z-:._]*`   
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

 ** TargetDbClusterIdentifier **   
Identifiant du cluster Amazon DocumentDB secondaire à promouvoir en tant que nouveau cluster principal pour le cluster de bases de données global. Utilisez l'Amazon Resource Name (ARN) comme identifiant afin qu'Amazon DocumentDB puisse localiser le cluster dans sa AWS région.  
Contraintes:  
+ Doit correspondre à l'identifiant d'un cluster secondaire existant.
+ Longueur minimale de 1. Longueur maximale de 255 caractères.
Modèle : `[A-Za-z][0-9A-Za-z-:._]*`   
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

## Éléments de réponse
<a name="API_SwitchoverGlobalCluster_ResponseElements"></a>

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
<a name="API_SwitchoverGlobalCluster_Errors"></a>

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

 ** GlobalClusterNotFoundFault **   
`GlobalClusterIdentifier`Cela ne fait pas référence à un cluster mondial existant.  
Code d’état HTTP :404

 ** InvalidDBClusterStateFault **   
Le cluster n'est pas dans un état valide.  
Code d’état HTTP : 400

 ** InvalidGlobalClusterStateFault **   
L'opération demandée ne peut pas être effectuée tant que le cluster est dans cet état.  
Code d’état HTTP : 400

## Voir aussi
<a name="API_SwitchoverGlobalCluster_SeeAlso"></a>

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/SwitchoverGlobalCluster) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/SwitchoverGlobalCluster) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/SwitchoverGlobalCluster)