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
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
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
- 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.
Modèle :
[A-Za-z][0-9A-Za-z-:._]*Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255.
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 le nom de ressource Amazon (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.
Modèle :
[A-Za-z][0-9A-Za-z-:._]*Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255.
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
Switchoverparamè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
AllowDataLossparamètre.
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.HTTPCode de statut : 404
- GlobalClusterNotFoundFault
-
GlobalClusterIdentifierCela ne fait pas référence à un cluster mondial existant.HTTPCode de statut : 404
- InvalidDBClusterStateFault
-
Le cluster n'est pas dans un état valide.
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
consultez aussi
Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :
