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.
# DBCluster
Detaillierte Informationen zu einem Cluster.
## Inhalt
**Anmerkung**
In der folgenden Liste werden zunächst die erforderlichen Parameter beschrieben.
** AssociatedRoles.DBClusterRole.N **
Stellt eine Liste der AWS Identity and Access Management (IAM-) Rollen bereit, die dem Cluster zugeordnet sind. (IAM-) Rollen, die einem Cluster zugeordnet sind, gewähren dem Cluster die Berechtigung, in Ihrem Namen auf andere AWS Dienste zuzugreifen.
Typ: Array von [DBClusterRole](API_DBClusterRole.md)-Objekten
Erforderlich: Nein
** AvailabilityZones.AvailabilityZone.N **
Stellt die Liste der Amazon EC2 Availability Zones bereit, in denen Instances im Cluster erstellt werden können.
Typ: Zeichenfolgen-Array
Erforderlich: Nein
** BackupRetentionPeriod **
Gibt die Anzahl der Tage an, für die automatische Snapshots aufbewahrt werden.
Typ: Ganzzahl
Erforderlich: Nein
** CloneGroupId **
Identifiziert die Clone-Gruppe, mit der der DB-Cluster verknüpft ist.
Typ: Zeichenfolge
Erforderlich: Nein
** ClusterCreateTime **
Gibt die Uhrzeit der Clustererstellung in UTC (Universal Coordinated Time) an.
Typ: Zeitstempel
Erforderlich: Nein
** DBClusterArn **
Der Amazon-Ressourcenname (ARN) für den Cluster.
Typ: Zeichenfolge
Erforderlich: Nein
** DBClusterIdentifier **
Enthält eine vom Benutzer angegebene Cluster-ID. Dieser Bezeichner ist der eindeutige Schlüssel, der einen Cluster identifiziert.
Typ: Zeichenfolge
Erforderlich: Nein
** DBClusterMembers.DBClusterMember.N **
Stellt die Liste der Instanzen bereit, aus denen der Cluster besteht.
Typ: Array von [DBClusterMember](API_DBClusterMember.md)-Objekten
Erforderlich: Nein
** DBClusterParameterGroup **
Gibt den Namen der Cluster-Parametergruppe für den Cluster an.
Typ: Zeichenfolge
Erforderlich: Nein
** DbClusterResourceId **
Der AWS-Region eindeutige, unveränderliche Bezeichner für den Cluster. Dieser Bezeichner befindet AWS CloudTrail sich in Protokolleinträgen, wenn auf den AWS KMS Schlüssel für den Cluster zugegriffen wird.
Typ: Zeichenfolge
Erforderlich: Nein
** DBSubnetGroup **
Gibt Informationen über die Subnetzgruppe an, die dem Cluster zugeordnet ist, einschließlich des Namens, der Beschreibung und der Subnetze in der Subnetzgruppe.
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
** EarliestRestorableTime **
Der früheste Zeitpunkt, zu dem eine Datenbank mit point-in-time Restore wiederhergestellt werden kann.
Typ: Zeitstempel
Erforderlich: Nein
** EnabledCloudwatchLogsExports.member.N **
Eine Liste der Protokolltypen, für deren Export dieser Cluster nach Amazon CloudWatch Logs konfiguriert ist.
Typ: Zeichenfolgen-Array
Erforderlich: Nein
** Endpoint **
Gibt den Verbindungsendpunkt für die primäre Instance des Clusters an.
Typ: Zeichenfolge
Erforderlich: Nein
** Engine **
Gibt den Namen der Datenbank-Engine an, die für diesen Cluster verwendet werden soll.
Typ: Zeichenfolge
Erforderlich: Nein
** EngineVersion **
Gibt die Version der Datenbank-Engine an.
Typ: Zeichenfolge
Erforderlich: Nein
** HostedZoneId **
Gibt die ID an, die Amazon Route 53 zuweist, wenn Sie eine gehostete Zone erstellen.
Typ: Zeichenfolge
Erforderlich: Nein
** IOOptimizedNextAllowedModificationTime **
Beim nächsten Mal können Sie den Amazon DocumentDB-Cluster so ändern, dass er den Speichertyp iopt1 verwendet.
Typ: Zeitstempel
Erforderlich: Nein
** KmsKeyId **
Wenn ja `StorageEncrypted``true`, die AWS KMS Schlüssel-ID für den verschlüsselten Cluster.
Typ: Zeichenfolge
Erforderlich: Nein
** LatestRestorableTime **
Gibt den letzten Zeitpunkt an, zu dem eine Datenbank mit point-in-time restore wiederhergestellt werden kann.
Typ: Zeitstempel
Erforderlich: Nein
** MasterUsername **
Enthält den Master-Benutzernamen für den Cluster.
Typ: Zeichenfolge
Erforderlich: Nein
** MasterUserSecret **
Das von Amazon DocumentDB in AWS Secrets Manager verwaltete Geheimnis für das Masterbenutzer-Passwort.
Typ: [ClusterMasterUserSecret](API_ClusterMasterUserSecret.md) Objekt
Erforderlich: Nein
** MultiAZ **
Gibt an, ob der Cluster über Instances in mehreren Availability Zones verfügt.
Typ: Boolesch
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
** PercentProgress **
Gibt den Fortschritt der Operation als Prozentsatz an.
Typ: Zeichenfolge
Erforderlich: Nein
** Port **
Gibt die Portnummer an, die von der Datenbank-Engine überwacht wird.
Typ: Ganzzahl
Erforderlich: Nein
** PreferredBackupWindow **
Gibt den täglichen Zeitraum in koordinierter Weltzeit (UTC) an, in dem automatische Sicherungen erstellt werden, wenn automatische Sicherungen aktiviert sind, gemäß `BackupRetentionPeriod`.
Typ: Zeichenfolge
Erforderlich: Nein
** PreferredMaintenanceWindow **
Gibt den wöchentlichen Zeitraum, in dem Systemwartungen durchgeführt werden können, in UTC (Universal Coordinated Time) an.
Typ: Zeichenfolge
Erforderlich: Nein
** ReaderEndpoint **
Der Leser-Endpunkt für den Cluster. Der Reader-Endpunkt für einen Cluster verteilt die Lasten der Verbindungen zwischen den Amazon DocumentDB DocumentDB-Replikaten, die in einem Cluster verfügbar sind. Wenn Clients neue Verbindungen zum Reader-Endpunkt anfordern, verteilt Amazon DocumentDB die Verbindungsanfragen auf die Amazon DocumentDB DocumentDB-Replikate im Cluster. Diese Funktion kann Ihnen helfen, Ihre Lese-Arbeitslast auf mehrere Amazon DocumentDB DocumentDB-Replikate in Ihrem Cluster zu verteilen.
Wenn ein Failover auftritt und das Amazon DocumentDB DocumentDB-Replikat, mit dem Sie verbunden sind, zur primären Instance hochgestuft wird, wird Ihre Verbindung unterbrochen. Um Ihren Lese-Workload weiterhin an andere Amazon DocumentDB DocumentDB-Replikate im Cluster zu senden, können Sie dann erneut eine Verbindung zum Reader-Endpunkt herstellen.
Typ: Zeichenfolge
Erforderlich: Nein
** ReadReplicaIdentifiers.ReadReplicaIdentifier.N **
Enthält einen oder mehrere Identifikatoren der sekundären Cluster, die diesem Cluster zugeordnet sind.
Typ: Zeichenfolgen-Array
Erforderlich: Nein
** ReplicationSourceIdentifier **
Enthält den Bezeichner des Quellclusters, wenn es sich bei diesem Cluster um einen sekundären Cluster handelt.
Typ: Zeichenfolge
Erforderlich: Nein
** ServerlessV2ScalingConfiguration **
Die Skalierungskonfiguration eines serverlosen Amazon DocumentDB-Clusters.
Typ: [ServerlessV2ScalingConfigurationInfo](API_ServerlessV2ScalingConfigurationInfo.md) Objekt
Erforderlich: Nein
** Status **
Gibt den aktuellen Status dieses Clusters an.
Typ: Zeichenfolge
Erforderlich: Nein
** StorageEncrypted **
Gibt an, ob der Cluster verschlüsselt ist.
Typ: Boolesch
Erforderlich: Nein
** StorageType **
Speichertyp, der Ihrem Cluster zugeordnet ist
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 `
Typ: Zeichenfolge
Erforderlich: Nein
** VpcSecurityGroups.VpcSecurityGroupMembership.N **
Stellt eine Liste der Virtual Private Cloud (VPC) -Sicherheitsgruppen bereit, zu denen der Cluster gehört.
Typ: Array von [VpcSecurityGroupMembership](API_VpcSecurityGroupMembership.md)-Objekten
Erforderlich: Nein
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DBCluster)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DBCluster)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DBCluster)