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.
FailoverDBCluster
Erzwingt einen Failover für einen Cluster.
Bei einem Failover für einen Cluster wird eine der Amazon DocumentDB DocumentDB-Repliken (schreibgeschützte Instances) im Cluster zur primären Instance (Cluster-Writer) heraufgestuft.
Wenn die primäre Instance ausfällt, wechselt Amazon DocumentDB automatisch zu einem Amazon DocumentDB DocumentDB-Replikat, falls eines existiert. Sie können ein Failover erzwingen, wenn Sie einen Ausfall einer primären Instance zum Testen simulieren möchten.
Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter Allgemeine Parameter.
- DBClusterIdentifier
-
Eine Cluster-ID, für die ein Failover erzwungen werden soll. Bei diesem Parameter wird nicht zwischen Groß- und Kleinschreibung unterschieden.
Einschränkungen:
-
Muss mit der Kennung eines vorhandenen
DBClusterübereinstimmen.
Typ: Zeichenfolge
Erforderlich: Nein
-
- TargetDBInstanceIdentifier
-
Der Name der Instance, die zur primären Instance hochgestuft werden soll.
Sie müssen die Instance-ID für ein Amazon DocumentDB DocumentDB-Replikat im Cluster angeben. Beispiel,
mydbcluster-replica1.Typ: Zeichenfolge
Erforderlich: Nein
Antwortelemente
Das folgende Element wird vom Service zurückgegeben.
- DBCluster
-
Detaillierte Informationen zu einem Cluster.
Typ: DBCluster 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.HTTP Status Code: 404
- InvalidDBClusterStateFault
-
Der Cluster befindet sich nicht in einem gültigen Zustand.
HTTP Status Code: 400
- InvalidDBInstanceState
-
Die angegebene Instanz befindet sich nicht im Status „Verfügbar“.
HTTP Status Code: 400
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden:
