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.
# CreateDBCluster
Erstellt einen neuen Amazon DocumentDB-Cluster.
## Anforderungsparameter
Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).
** DBClusterIdentifier **
Die Cluster-ID. Dieser Parameter wird als Zeichenfolge in Kleinbuchstaben gespeichert.
Einschränkungen:
+ Muss zwischen 1 und 63 Buchstaben, Ziffern oder Bindestriche enthalten.
+ Das erste Zeichen muss ein Buchstabe sein.
+ Darf nicht mit einem Bindestrich enden oder zwei aufeinanderfolgende Bindestriche enthalten.
Beispiel: `my-cluster`
Typ: Zeichenfolge
Erforderlich: Ja
** Engine **
Der Name der Datenbank-Engine, die für diesen Cluster verwendet werden soll.
Zulässige Werte: `docdb`
Typ: Zeichenfolge
Erforderlich: Ja
**AvailabilityZones. AvailabilityZone**N
Eine Liste der Amazon EC2 Availability Zones, in denen Instances im DB-Cluster erstellt werden können.
Typ: Zeichenfolgen-Array
Erforderlich: Nein
** BackupRetentionPeriod **
Die Anzahl von Tagen, über die automatische Backups aufbewahrt werden. Sie müssen einen Mindestwert von 1 angeben.
Standard: 1
Einschränkungen:
+ Muss ein Wert zwischen 1 und 35 sein.
Typ: Ganzzahl
Erforderlich: Nein
** DBClusterParameterGroupName **
Der Name der Parameter-Gruppe, die mit diesem Cluster zu verknüpfen ist.
Typ: Zeichenfolge
Erforderlich: Nein
** DBSubnetGroupName **
Eine DB-Subnetzgruppe, die diesem DB-Cluster zugeordnet werden soll.
Einschränkungen: Der Wert muss mit dem Namen einer vorhandenen `DBSubnetGroup` übereinstimmen. Der Name darf nicht default sein.
Beispiel: `mySubnetgroup`
Typ: Zeichenfolge
Erforderlich: Nein
** DeletionProtection **
Gibt an, ob dieser Cluster gelöscht werden kann. Wenn `DeletionProtection` aktiviert, kann der Cluster nur gelöscht werden, wenn er geändert und `DeletionProtection` deaktiviert wurde. `DeletionProtection`schützt Cluster davor, versehentlich gelöscht zu werden.
Typ: Boolesch
Erforderlich: Nein
**EnableCloudwatchLogsExports.Mitglied.N**
Eine Liste von Protokolltypen, die für den Export nach Amazon CloudWatch Logs aktiviert werden müssen. Sie können Prüf- oder Profiler-Protokolle aktivieren. Weitere Informationen finden Sie unter [Amazon DocumentDB DocumentDB-Ereignisse prüfen und Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/event-auditing.html) [DocumentDB-Operationen profilieren](https://docs.aws.amazon.com/documentdb/latest/developerguide/profiling.html).
Typ: Zeichenfolgen-Array
Erforderlich: Nein
** EngineVersion **
Die Versionsnummer der zu verwendenden Datenbank-Engine. Die `--engine-version` wird standardmäßig auf die neueste Hauptversion des Moduls festgelegt. Bei Produktions-Workloads empfehlen wir, diesen Parameter explizit mit der beabsichtigten Hauptversion zu deklarieren.
Typ: Zeichenfolge
Erforderlich: Nein
** 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: Nein
** KmsKeyId **
Die AWS KMS Schlüssel-ID für einen verschlüsselten Cluster.
Die AWS KMS Schlüssel-ID ist der Amazon-Ressourcenname (ARN) für den AWS KMS Verschlüsselungsschlüssel. Wenn Sie einen Cluster mit demselben Cluster erstellen AWS-Konto , dem der AWS KMS Verschlüsselungsschlüssel gehört, der zum Verschlüsseln des neuen Clusters verwendet wird, können Sie den AWS KMS Schlüsselalias anstelle des ARN für den AWS KMS Verschlüsselungsschlüssel verwenden.
Wenn ein Verschlüsselungsschlüssel in `KmsKeyId` nicht angegeben ist:
+ Wenn der `StorageEncrypted`-Parameter `true` lautet, verwendet Amazon DocumentDB Ihren Standard-Verschlüsselungsschlüssel.
AWS KMS erstellt den Standard-Verschlüsselungsschlüssel für Ihren AWS-Konto. Ihr AWS-Konto hat für jeden einen anderen Standard-Verschlüsselungsschlüssel AWS-Regionen.
Typ: Zeichenfolge
Erforderlich: Nein
** ManageMasterUserPassword **
Gibt an, ob das Masterbenutzerpasswort mit Amazon Web Services Secrets Manager verwaltet werden soll.
Einschränkung: Sie können das Masterbenutzer-Passwort nicht mit Amazon Web Services Secrets Manager verwalten, wenn `MasterUserPassword` es angegeben ist.
Typ: Boolesch
Erforderlich: Nein
** MasterUsername **
Der Name des Masterbenutzers für diesen DB-Cluster.
Einschränkungen:
+ Muss zwischen 1 und 63 Buchstaben oder Zahlen enthalten.
+ Das erste Zeichen muss ein Buchstabe sein.
+ Darf kein Wort sein, das für die ausgewählte Datenbank-Engine reserviert ist.
Typ: Zeichenfolge
Erforderlich: Nein
** MasterUserPassword **
Das Passwort für den Masterbenutzer der Datenbank. Dieses Passwort kann alle druckbaren ASCII-Zeichen, außer Schrägstrich (/), doppeltes Anführungszeichen (") oder das "At"-Zeichen (@), enthalten.
Einschränkungen: Muss 8 bis 100 Zeichen enthalten.
Typ: Zeichenfolge
Erforderlich: Nein
** MasterUserSecretKmsKeyId **
Die Amazon Web Services KMS-Schlüssel-ID zur Verschlüsselung eines Geheimnisses, das automatisch im Amazon Web Services Secrets Manager generiert und verwaltet wird. Diese Einstellung ist nur gültig, wenn das Masterbenutzerkennwort von Amazon DocumentDB im Amazon Web Services Secrets Manager für den DB-Cluster verwaltet wird.
Die Amazon Web Services KMS-Schlüssel-ID ist der Schlüssel-ARN, die Schlüssel-ID, der Alias-ARN oder der Aliasname für den KMS-Schlüssel. Um einen KMS-Schlüssel in einem anderen Amazon Web Services Services-Konto zu verwenden, geben Sie den Schlüssel-ARN oder den Alias-ARN an.
Wenn Sie nichts angeben`MasterUserSecretKmsKeyId`, wird der `aws/secretsmanager` KMS-Schlüssel zur Verschlüsselung des Geheimnisses verwendet. Wenn sich das Geheimnis in einem anderen Amazon Web Services Services-Konto befindet, können Sie den `aws/secretsmanager` KMS-Schlüssel nicht verwenden, um das Geheimnis zu verschlüsseln, und Sie müssen einen vom Kunden verwalteten KMS-Schlüssel verwenden.
Es gibt einen Standard-KMS-Schlüssel für Ihr Amazon Web Services Services-Konto. Ihr Amazon Web Services Services-Konto hat für jede Amazon Web Services Services-Region einen anderen Standard-KMS-Schlüssel.
Typ: Zeichenfolge
Erforderlich: Nein
** NetworkType **
Der Netzwerktyp des Clusters.
Der Netzwerktyp wird durch den für den Cluster `DBSubnetGroup` angegebenen Netzwerktyp bestimmt. A `DBSubnetGroup` kann nur das IPv4 Protokoll oder die IPv4 und die IPv6 Protokolle (`DUAL`) unterstützen.
Weitere Informationen finden Sie unter [DocumentDB-Cluster in einer VPC](https://docs.aws.amazon.com/documentdb/latest/developerguide/vpc-clusters.html) im Amazon DocumentDB Developer Guide.
Zulässige Werte: `IPV4` \$1 `DUAL`
Typ: Zeichenfolge
Erforderlich: Nein
** Port **
Die Portnummer, auf der die Instances im Cluster Verbindungen akzeptieren.
Typ: Ganzzahl
Erforderlich: Nein
** PreferredBackupWindow **
Der tägliche Zeitraum, in dem automatische Sicherungen erstellt werden, wenn diese mit dem Parameter `BackupRetentionPeriod` aktiviert sind.
Die Standardeinstellung ist ein 30-minütiges Fenster, das nach dem Zufallsprinzip aus einem Zeitblock von jeweils AWS-Region 8 Stunden ausgewählt wird.
Einschränkungen:
+ Muss im Format `hh24:mi-hh24:mi` angegeben werden.
+ Muss in Universal Coordinated Time (UTC) angegeben werden.
+ Darf nicht mit dem bevorzugten Wartungsfenster in Konflikt treten.
+ Muss mindestens 30 Minuten betragen.
Typ: Zeichenfolge
Erforderlich: Nein
** PreferredMaintenanceWindow **
Der wöchentliche Zeitraum, in dem Systemwartungen durchgeführt werden können, in UTC (Universal Coordinated Time).
Format: `ddd:hh24:mi-ddd:hh24:mi`
Die Standardeinstellung ist ein 30-minütiges Fenster, das nach dem Zufallsprinzip aus einem 8-Stunden-Zeitblock ausgewählt wird und an einem zufälligen Wochentag stattfindet. AWS-Region
Gültige Tage: Mo, Di, Mi, Do, Fr, Sa, So
Einschränkungen: mindestens 30-Minuten-Zeitfenster.
Typ: Zeichenfolge
Erforderlich: Nein
** PreSignedUrl **
Wird derzeit nicht unterstützt.
Typ: Zeichenfolge
Erforderlich: Nein
** ServerlessV2ScalingConfiguration **
Enthält die Skalierungskonfiguration eines serverlosen Amazon DocumentDB-Clusters.
Typ: [ServerlessV2ScalingConfiguration](API_ServerlessV2ScalingConfiguration.md) Objekt
Erforderlich: Nein
** StorageEncrypted **
Gibt an, ob der Cluster verschlüsselt ist.
Typ: Boolesch
Erforderlich: Nein
** StorageType **
Der Speichertyp, der dem DB-Cluster zugeordnet werden soll.
Informationen zu Speichertypen für Amazon DocumentDB-Cluster finden Sie unter Cluster-Speicherkonfigurationen im *Amazon DocumentDB Developer Guide*.
Gültige Werte für den Speichertyp - `standard | iopt1`
Der Standardwert ist `standard `
Wenn Sie einen Amazon DocumentDB-Cluster mit dem Speichertyp auf erstellen`iopt1`, wird der Speichertyp in der Antwort zurückgegeben. Der Speichertyp wird nicht zurückgegeben, wenn Sie ihn auf `standard` setzen.
Typ: Zeichenfolge
Erforderlich: Nein
**Stichworte.Tag.N**
Die Tags, die dem Cluster zugewiesen werden sollen.
Typ: Array von [Tag](API_Tag.md)-Objekten
Erforderlich: Nein
**VpcSecurityGroupIds. VpcSecurityGroupId**N
Eine Liste der EC2-VPC-Sicherheitsgruppen, die mit diesem Cluster verknüpft werden sollen.
Typ: Zeichenfolgen-Array
Erforderlich: Nein
## Antwortelemente
Das folgende Element wird vom Dienst zurückgegeben.
** DBCluster **
Detaillierte Informationen zu einem Cluster.
Typ: [DBCluster](API_DBCluster.md) Objekt
## Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).
** DBClusterAlreadyExistsFault **
Sie haben bereits einen Cluster mit der angegebenen Kennung.
HTTP-Statuscode: 400
** DBClusterNotFoundFault **
`DBClusterIdentifier`bezieht sich nicht auf einen vorhandenen Cluster.
HTTP-Statuscode: 404
** DBClusterParameterGroupNotFound **
`DBClusterParameterGroupName`bezieht sich nicht auf eine bestehende Cluster-Parametergruppe.
HTTP-Statuscode: 404
** DBClusterQuotaExceededFault **
Der Cluster kann nicht erstellt werden, da Sie das maximal zulässige Kontingent an Clustern erreicht haben.
HTTP-Statuscode: 403
** DBInstanceNotFound **
`DBInstanceIdentifier`bezieht sich nicht auf eine bestehende Instanz.
HTTP-Statuscode: 404
** DBSubnetGroupDoesNotCoverEnoughAZs **
Subnetze in der Subnetzgruppe sollten mindestens zwei Availability Zones abdecken, es sei denn, es gibt nur eine Availability Zone.
HTTP-Statuscode: 400
** DBSubnetGroupNotFoundFault **
`DBSubnetGroupName`bezieht sich nicht auf eine bestehende Subnetzgruppe.
HTTP-Statuscode: 404
** GlobalClusterNotFoundFault **
Das bezieht sich `GlobalClusterIdentifier` nicht auf einen vorhandenen globalen Cluster.
HTTP-Statuscode: 404
** InsufficientStorageClusterCapacity **
Für die aktuelle Aktion ist nicht genügend Speicherplatz verfügbar. Möglicherweise können Sie diesen Fehler beheben, indem Sie Ihre Subnetzgruppe so aktualisieren, dass sie verschiedene Availability Zones verwendet, in denen mehr Speicherplatz verfügbar ist.
HTTP-Statuscode: 400
** InvalidDBClusterStateFault **
Der Cluster befindet sich nicht in einem gültigen Zustand.
HTTP-Statuscode: 400
** InvalidDBInstanceState **
Die angegebene Instanz befindet sich nicht im Status „*Verfügbar*“.
HTTP-Statuscode: 400
** InvalidDBSubnetGroupStateFault **
Die Subnetzgruppe kann nicht gelöscht werden, da sie verwendet wird.
HTTP-Statuscode: 400
** InvalidGlobalClusterStateFault **
Der angeforderte Vorgang kann nicht ausgeführt werden, solange sich der Cluster in diesem Zustand befindet.
HTTP-Statuscode: 400
** InvalidSubnet **
Das angeforderte Subnetz ist ungültig, oder es wurden mehrere Subnetze angefordert, die sich nicht alle in einer gemeinsamen Virtual Private Cloud (VPC) befinden.
HTTP-Statuscode: 400
** InvalidVPCNetworkStateFault **
Die Subnetzgruppe deckt nach ihrer Erstellung nicht alle Availability Zones ab, da Änderungen vorgenommen wurden.
HTTP-Statuscode: 400
** KMSKeyNotAccessibleFault **
Beim Zugriff auf einen AWS KMS Schlüssel ist ein Fehler aufgetreten.
HTTP-Statuscode: 400
** NetworkTypeNotSupported **
Der Netzwerktyp wird `DBSubnetGroup` weder von der DB-Engine-Version noch von der DB-Engine-Version unterstützt.
HTTP-Statuscode: 400
** StorageQuotaExceeded **
Die Anfrage würde dazu führen, dass Sie die zulässige Menge an Speicherplatz überschreiten, die für alle Instances verfügbar ist.
HTTP-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/CreateDBCluster)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/CreateDBCluster)