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
-
DBClusterIdentifier
bezieht 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: