Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
SwitchoverGlobalCluster
Schaltet den angegebenen sekundären Amazon DocumentDB-Cluster in den neuen primären Amazon DocumentDB-Cluster im globalen Datenbank-Cluster um.
Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter Allgemeine Parameter.
- GlobalClusterIdentifier
-
Die Kennung des globalen Amazon DocumentDB DocumentDB-Datenbank-Clusters, zu dem gewechselt werden soll. Die Kennung ist der eindeutige Schlüssel, den der Benutzer bei der Erstellung des Clusters zugewiesen hat. Mit anderen Worten, es ist der Name des globalen Clusters. Bei diesem Parameter wird nicht zwischen Groß- und Kleinschreibung unterschieden.
Einschränkungen:
-
Muss mit der ID eines vorhandenen globalen Clusters (globale Amazon DocumentDB DocumentDB-Datenbank) übereinstimmen.
-
Mindestlänge 1. Maximale Länge beträgt 255 Zeichen.
Pattern:
[A-Za-z][0-9A-Za-z-:._]*
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 255 Zeichen.
Pattern:
[A-Za-z][0-9A-Za-z-:._]*
Erforderlich: Ja
-
- TargetDbClusterIdentifier
-
Die ID des sekundären Amazon DocumentDB-Clusters, der zum neuen primären Cluster für den globalen Datenbank-Cluster heraufgestuft werden soll. Verwenden Sie den Amazon-Ressourcennamen (ARN) als Kennung, damit Amazon DocumentDB den Cluster in seiner AWS Region lokalisieren kann.
Einschränkungen:
-
Muss mit der Kennung eines vorhandenen sekundären Clusters übereinstimmen.
-
Mindestlänge 1. Maximale Länge beträgt 255 Zeichen.
Pattern:
[A-Za-z][0-9A-Za-z-:._]*
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 255 Zeichen.
Pattern:
[A-Za-z][0-9A-Za-z-:._]*
Erforderlich: Ja
-
Antwortelemente
Das folgende Element wird vom Dienst zurückgegeben.
- GlobalCluster
-
Ein Datentyp, der einen globalen Amazon DocumentDB-Cluster darstellt.
Typ: GlobalCluster Objekt
Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.
- DBClusterNotFoundFault
-
DBClusterIdentifier
bezieht sich nicht auf einen vorhandenen Cluster.HTTPStatuscode: 404
- GlobalClusterNotFoundFault
-
Das bezieht sich
GlobalClusterIdentifier
nicht auf einen vorhandenen globalen Cluster.HTTPStatuscode: 404
- InvalidDBClusterStateFault
-
Der Cluster befindet sich nicht in einem gültigen Zustand.
HTTPStatuscode: 400
- InvalidGlobalClusterStateFault
-
Der angeforderte Vorgang kann nicht ausgeführt werden, solange sich der Cluster in diesem Zustand befindet.
HTTPStatuscode: 400
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: