SwitchoverGlobalCluster - Amazon DocumentDB

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

DBClusterIdentifierbezieht 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: