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 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.
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 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
-
É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 :
