CreateGlobalCluster - 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.

CreateGlobalCluster

Erstellt einen globalen Amazon DocumentDB-Cluster, der sich über mehrere AWS-Regionen erstrecken kann. Der globale Cluster enthält einen primären Cluster mit Lese- und Schreibfunktion und bis zu fünf schreibgeschützte sekundäre Cluster. Global Clusters verwendet speicherbasierte schnelle Replikation über Regionen hinweg mit Latenzen von weniger als einer Sekunde. Dabei wird eine dedizierte Infrastruktur verwendet, ohne dass die Leistung Ihrer Workloads beeinträchtigt wird.

Sie können einen globalen Cluster erstellen, der zunächst leer ist, und ihm dann einen primären und einen sekundären hinzufügen. Oder Sie können während des Erstellungsvorgangs einen vorhandenen Cluster angeben, der dann zum primären Cluster des globalen Clusters wird.

Anmerkung

Diese Aktion gilt nur für Amazon DocumentDB-Cluster.

Anforderungsparameter

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter Allgemeine Parameter.

GlobalClusterIdentifier

Die Cluster-ID des neuen globalen Clusters.

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

DatabaseName

Der Name für Ihre Datenbank mit bis zu 64 alphanumerischen Zeichen. Wenn Sie keinen Namen angeben, erstellt Amazon DocumentDB keine Datenbank in dem globalen Cluster, den Sie erstellen.

Typ: Zeichenfolge

Erforderlich: Nein

DeletionProtection

Die Löschschutzeinstellung für den neuen globalen Cluster. Der globale Cluster kann nicht gelöscht werden, wenn der Löschschutz aktiviert ist.

Typ: Boolesch

Erforderlich: Nein

Engine

Der Name der Datenbank-Engine, die für diesen Cluster verwendet werden soll.

Typ: Zeichenfolge

Erforderlich: Nein

EngineVersion

Die Engine-Version des globalen Clusters.

Typ: Zeichenfolge

Erforderlich: Nein

SourceDBClusterIdentifier

Der Amazon-Ressourcenname (ARN), der als primärer Cluster des globalen Clusters verwendet werden soll. Dieser Parameter ist optional.

Typ: Zeichenfolge

Erforderlich: Nein

StorageEncrypted

Die Einstellung für die Speicherverschlüsselung für den neuen globalen Cluster.

Typ: Boolesch

Erforderlich: Nein

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.

HTTP Status Code: 404

GlobalClusterAlreadyExistsFault

GlobalClusterIdentifier ist bereits vorhanden. Wählen Sie eine neue globale Cluster-ID (eindeutiger Name), um einen neuen globalen Cluster zu erstellen.

HTTP Status Code: 400

GlobalClusterQuotaExceededFault

Die Anzahl der globalen Cluster für dieses Konto hat bereits den zulässigen Höchstwert erreicht.

HTTP Status Code: 400

InvalidDBClusterStateFault

Der Cluster befindet sich nicht in einem gültigen Zustand.

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: