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
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
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.
- 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 distingue pas les majuscules et 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.
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 à 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.
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
-
É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
- GlobalClusterNotFoundFault
-
GlobalClusterIdentifierCela 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
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
