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.

# FailoverGlobalCluster
<a name="API_FailoverGlobalCluster"></a>

Fait du cluster de base de données secondaire spécifié le cluster de base de données principal du cluster global en cas de basculement d'un cluster global.

Utilisez cette opération pour répondre à un événement imprévu, tel qu'une catastrophe régionale dans la région principale. Un échec peut entraîner la perte de données de transaction d'écriture qui n'ont pas été répliquées sur le secondaire choisi avant que le basculement ne se produise. Cependant, le processus de restauration qui fait d'une instance de base de données du cluster de base de données secondaire choisi l'instance de base de données principale du rédacteur garantit que les données sont dans un état de cohérence transactionnelle.

## Paramètres de demande
<a name="API_FailoverGlobalCluster_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 global Amazon DocumentDB pour appliquer cette opération. 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.  
Contraintes:  
+ Doit correspondre à l'identifiant d'un cluster global 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

 ** TargetDbClusterIdentifier **   
Identifiant du cluster Amazon DocumentDB secondaire que vous souhaitez promouvoir au rang de cluster principal pour le cluster 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

 ** AllowDataLoss **   
Spécifie s'il faut autoriser la perte de données pour cette opération de cluster globale. Autoriser la perte de données déclenche une opération de basculement globale.  
Si vous ne le spécifiez pas`AllowDataLoss`, le fonctionnement du cluster global est par défaut un basculement.  
Contraintes:  
+ Ne peut pas être spécifié en même temps que le `Switchover` paramètre.
Type : booléen  
Obligatoire : non

 ** Switchover **   
Spécifie s'il convient de basculer entre ce cluster de bases de données global.  
Contraintes:  
+ Ne peut pas être spécifié en même temps que le `AllowDataLoss` paramètre.
Type : booléen  
Obligatoire : non

## Éléments de réponse
<a name="API_FailoverGlobalCluster_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_FailoverGlobalCluster_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_FailoverGlobalCluster_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/FailoverGlobalCluster) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/FailoverGlobalCluster) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/FailoverGlobalCluster)