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.
# Verwaltung von Amazon DocumentDB-Clustern
Um einen Amazon DocumentDB-Cluster zu verwalten, benötigen Sie eine IAM-Richtlinie mit den entsprechenden Berechtigungen für die Amazon DocumentDB-Steuerebene. Diese Berechtigungen ermöglichen das Erstellen, Ändern und Löschen von Clustern und Instances. Die `AmazonDocDBFullAccess` Richtlinie bietet alle erforderlichen Berechtigungen für die Verwaltung eines Amazon DocumentDB-Clusters.
Die folgenden Themen zeigen, wie Sie bei der Arbeit mit Amazon DocumentDB-Clustern verschiedene Aufgaben ausführen, darunter das Erstellen, Löschen, Ändern, Herstellen einer Verbindung zu und das Anzeigen von Clustern.
**Topics**
+ [Cluster verstehen](db-clusters-understanding.md)
+ [Cluster-Einstellungen](db-cluster-parameters.md)
+ [Cluster-Speicherkonfigurationen](db-cluster-storage-configs.md)
+ [Den Status eines Clusters ermitteln](db-cluster-status.md)
+ [Cluster-Lebenszyklus](db-cluster-life-cycle.md)
+ [Skalierung von Clustern](db-cluster-manage-performance.md)
+ [Klonen eines Volumes für einen Cluster](db-cluster-cloning.md)
+ [Die Cluster-Fehlertoleranz verstehen](db-cluster-fault-tolerance.md)
# Cluster verstehen
Amazon DocumentDB trennt Rechenleistung und Speicher und verlagert Datenreplikation und Backup auf das Cluster-Volume. Ein Cluster-Volume bietet eine dauerhafte, zuverlässige und hochverfügbare Speicherschicht, die Daten auf sechs Arten über drei Availability Zones repliziert. Replikate ermöglichen eine höhere Datenverfügbarkeit und Leseskalierung. Jeder Cluster kann auf bis zu 15 Replikate skaliert werden.
| Substantiv | Description | API-Operationen (Verben) |
| --- | --- | --- |
| Cluster | Besteht aus einer oder mehreren Instances und einem Cluster-Storage-Volume, das die Daten für diese Instances verwaltet. | `create-db-cluster` `delete-db-cluster` `describe-db-clusters` `modify-db-cluster` |
| Instance | Das Lesen und Schreiben von Daten auf das Cluster-Speichervolumen erfolgt über Instances. In einem gegebenen Cluster gibt es zwei Arten von Instances: Primär und Replikat. Ein Cluster hat immer eine primäre Instanz und kann 0—15 Replikate haben. | `create-db-instance` `delete-db-instance` `describe-db-instances` `modify-db-instance` `describe-orderable-db-instance-options` `reboot-db-instance` |
| Cluster-Volumen | Ein virtuelles Datenbankspeichervolumen, das sich über drei Availability Zones erstreckt, wobei jede Availability Zone zwei Kopien der Cluster-Daten aufweist. | – |
| Primäre Instance | Unterstützt Lese- und Schreiboperationen und führt alle Datenänderungen im Cluster-Volume durch. Jeder Cluster verfügt über eine primäre Instance. | – |
| Replikat-Instance | Unterstützt nur Lesevorgänge. Jeder Amazon DocumentDB-Cluster kann zusätzlich zur primären Instance bis zu 15 Replikat-Instances haben. Mehrere Replikate verteilen den Lese-Workload. Durch die Platzierung von Replikaten in separaten Availability Zones können Sie außerdem die Verfügbarkeit der Datenbank erhöhen. | – |
| Cluster-Endpunkt | Ein Endpunkt für einen Amazon DocumentDB-Cluster, der eine Verbindung zur aktuellen primären Instance für den Cluster herstellt. Jeder Amazon DocumentDB-Cluster hat einen Cluster-Endpunkt und eine primäre Instance. | – |
| Leser-Endpunkt | Ein Endpunkt für einen Amazon DocumentDB-Cluster, der eine Verbindung zu einem der verfügbaren Replikate für diesen Cluster herstellt. Jeder Amazon DocumentDB-Cluster hat einen Leser-Endpunkt. Wenn es mehr als ein Replikat gibt, leitet der Leser-Endpunkt jede Verbindungsanfrage an eines der Amazon DocumentDB DocumentDB-Replikate weiter. | – |
| Instance-Endpunkt | Ein Endpunkt für eine Instance in einem Amazon DocumentDB-Cluster, der eine Verbindung zu einer bestimmten Instance herstellt. Jede Instance in einem Cluster hat unabhängig vom Instance-Typ einen eigenen eindeutigen Instance-Endpunkt. | – |
# Amazon DocumentDB-Cluster-Einstellungen
Beim Erstellen oder Ändern eines Clusters müssen Sie wissen, welche Parameter unveränderlich und welche nach dem Anlegen des Clusters veränderbar sind. Die folgende Tabelle listet alle Einstellungen bzw. Parameter auf, die für einen Cluster spezifisch sind. Wie in der Tabelle angegeben, sind nur einige Parameter änderbar.
**Anmerkung**
Diese Einstellungen sollten nicht mit Amazon DocumentDB-Cluster-Parametergruppen und ihren Parametern verwechselt werden. Weitere Informationen zu Cluster-Parametergruppen finden Sie unter [Verwaltung von Amazon DocumentDB-Cluster-Parametergruppen](cluster_parameter_groups.md).
| Parameter | Anpassbar | Hinweise |
| --- | --- | --- |
| DBClusterIdentifier | Ja | Benennungseinschränkungen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/db-cluster-parameters.html) |
| Engine | Nein | Der Wert muss docdb sein. |
| BackupRetentionPeriod | Ja | Muss zwischen 1 und 35 Tagen liegen. |
| DBClusterParameterGroupName | Ja | Benennungseinschränkungen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/db-cluster-parameters.html) |
| DBSubnetGroupName | Nein | Sie können das Subnetz des Clusters nach dem Anlegen eines Clusters nicht mehr ändern. |
| EngineVersion | Nein | Der Wert kann 5.0.0 (Standard), 4.0.0 oder sein. 3.6.0 |
| KmsKeyId | Nein | Wenn Sie Ihren Cluster verschlüsseln möchten, können Sie den AWS KMS Schlüssel, den Sie zur Verschlüsselung Ihres Clusters verwendet haben, nicht ändern. |
| MasterUsername | Nein | Sie können den `MasterUsername` nach dem Anlegen eines Clusters nicht mehr ändern. Benennungseinschränkungen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/db-cluster-parameters.html) |
| MasterUserPassword | Ja | Einschränkungen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/db-cluster-parameters.html) |
| Port | Ja | Die Portnummer gilt für alle Instances im Cluster. |
| PreferredBackupWindow | Ja | |
| PreferredMaintenanceWindow | Ja | |
| StorageEncrypted | Nein | Wenn Sie Ihren Cluster verschlüsseln, kann er nicht unverschlüsselt sein. |
| StorageType | Ja | Der Speichertyp für den DB-Cluster: Standard (`standard`) oder I/O-Optimiert (). `iopt1` Standard: `standard` Dieser Parameter kann mit `CreateDBCluster` und konfiguriert werden. `ModifyDBCluster` Weitere Informationen finden Sie unter [Amazon DocumentDB-Cluster-Speicherkonfigurationen](db-cluster-storage-configs.md). |
| Tags | Ja | |
| VpcSecurityGroupIds | Nein | Nachdem ein Cluster erstellt wurde, können Sie die VPC nicht ändern, in der sich der Cluster befindet. |
# Amazon DocumentDB-Cluster-Speicherkonfigurationen
Ab Amazon DocumentDB 5.0 unterstützen instanzbasierte Cluster zwei Speicherkonfigurationstypen:
+ **Amazon DocumentDB DocumentDB-Standardspeicher**: Konzipiert für Kunden mit geringem bis moderatem I/O Verbrauch. Wenn Sie davon ausgehen, dass Ihre I/O Kosten weniger als 25% Ihres gesamten Amazon DocumentDB-Clusters ausmachen werden, ist diese Wahl möglicherweise ideal für Sie. Bei der Standardspeicherkonfiguration von Amazon DocumentDB werden Ihnen zusätzlich zu den Instance- und Speichergebühren zusätzliche Gebühren in Rechnung gestellt. pay-per-request I/O Das bedeutet, dass Ihre Abrechnung je nach Nutzung von einem Zyklus zum anderen variieren kann. Die Konfiguration ist auf die schwankenden I/O Anforderungen Ihrer Anwendung zugeschnitten.
+ **I/O-optimierter Speicher von Amazon DocumentDB**: Konzipiert für Kunden, die Wert auf Preisvorhersehbarkeit legen oder umfangreiche Anwendungen haben. I/O Der I/O-optimized configuration offers improved performance, increased throughput, and reduced latency for customers with I/O intensive workloads. If you expect your I/O costs to exceed 25% of your total Amazon DocumentDB cluster costs, this option offers enhanced price performance. With the Amazon DocumentDB I/O-optimized storage configuration, you won't be charged based on I/O Betrieb sorgt für vorhersehbare Kosten in jedem Abrechnungszeitraum. Die Konfiguration stabilisiert die Kosten und verbessert gleichzeitig die Leistung.
Sie können Ihre vorhandenen Datenbank-Cluster einmal alle 30 Tage auf Amazon DocumentDB umstellen. I/O-optimized storage. You can switch back to Amazon DocumentDB standard storage at any time. The next date to modify the storage configuration to I/O Optimiert kann mit dem `describe-db-clusters` Befehl über AWS CLI oder über die auf der Konfigurationsseite des Clusters nachverfolgt werden. AWS-Managementkonsole
Sie können einen neuen Datenbank-Cluster einschließlich der I/O-optimierten Amazon DocumentDB DocumentDB-Konfiguration erstellen oder Ihre vorhandenen Datenbank-Cluster mit ein paar Klicks [AWS-Managementkonsole](https://console.aws.amazon.com/docdb/), einer einzigen Parameteränderung in [AWS Command Line Interface (AWS CLI)](https://aws.amazon.com/cli/) oder so konvertieren. [AWS SDKs](https://aws.amazon.com/developer/tools/) Während oder nach der Änderung der Speicherkonfiguration sind keine Ausfallzeiten oder Neustarts von Instances erforderlich.
![\[Bild: Eine Tabelle, in der die Unterschiede zwischen Amazon DocumentDB DocumentDB-Standardspeicher und optimiertem Speicher beschrieben werden.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/io-diagram-1.png)
## Einen I/O-optimierten Cluster erstellen
------
#### [ Using the AWS-Managementkonsole ]
Um einen I/O-optimierten Cluster zu erstellen oder zu ändern, verwenden Sie: AWS-Managementkonsole
1. Wählen Sie in der Amazon DocumentDB-Managementkonsole unter **Clusters** entweder **Create** oder wählen Sie den Cluster aus und wählen Sie **Actions** und anschließend **Modify** aus.
1. Wenn Sie einen neuen Cluster erstellen, stellen Sie sicher, dass Sie im Abschnitt **Clustertyp die Option Instance Based** **Cluster** auswählen (dies ist die Standardoption).
![\[Bild: Eine Bildschirmaufnahme der Optionen für den Clustertyp auf der Konsole.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/create-cluster/cc-type.png)
1. Wählen Sie im Abschnitt **Konfiguration** unter **Cluster-Speicherkonfiguration** die Option **Amazon DocumentDB I/O-Optimized** aus.
![\[Bild: Eine Bildschirmaufnahme der Cluster-Speicherkonfigurationsoptionen auf der Konsole.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/storage-config-1.png)
1. Schließen Sie die Erstellung oder Änderung Ihres Clusters ab und wählen Sie **Cluster erstellen** oder **Cluster ändern** aus.
Den vollständigen Vorgang zum Erstellen eines Clusters finden Sie unter[Erstellen eines Clusters und einer primären Instance mit dem AWS-Managementkonsole](db-cluster-create.md#db-cluster-create-con).
Den vollständigen Vorgang zum Ändern des Clusters finden Sie unter[Ändern eines Amazon DocumentDB-Clusters](db-cluster-modify.md).
------
#### [ Using the AWS CLI ]
Um einen I/O-optimierten Cluster zu erstellen, verwenden Sie: AWS CLI
Ersetzen Sie in den folgenden Beispielen jedes *user input placeholder* durch Ihre eigenen Informationen.
Für Linux, macOS oder Unix:
```
aws docdb create-db-cluster \
--db-cluster-identifier sample-cluster \
--engine docdb \
--engine-version 5.0.0 \
--storage-type iopt1 \
--deletion-protection \
--master-username username \
--master-user-password password
```
Für Windows:
```
aws docdb create-db-cluster ^
--db-cluster-identifier sample-cluster ^
--engine docdb ^
--engine-version 5.0.0 ^
--storage-type iopt1 ^
--deletion-protection ^
--master-username username ^
--master-user-password password
```
------
## Kostenanalyse zur Bestimmung der Speicherkonfiguration
Mit Amazon DocumentDB haben Sie die Flexibilität, Ihre Speicherkonfiguration für jeden vorhandenen Datenbank-Cluster auszuwählen. Um Ihre Cluster ordnungsgemäß zwischen Standard- und I/O-optimierten Clustern zuzuordnen, können Sie Ihre Amazon DocumentDB DocumentDB-Kosten clusterweise verfolgen. Zu diesem Zweck können Sie vorhandenen Clustern Tags hinzufügen, die Kostenzuordnungskennzeichnung in Ihrem [AWS Fakturierung und Kostenmanagement Dashboard](https://aws.amazon.com/pricing/) aktivieren und Ihre Kosten für einen bestimmten Cluster in der analysieren. [AWS Cost Explorer Service](https://aws.amazon.com/aws-cost-management/aws-cost-explorer/) Informationen zur Kostenanalyse finden Sie in unserem Blog [Verwenden von Kostenzuordnungs-Tags](https://aws.amazon.com/blogs/database/using-cost-allocation-tags-with-amazon-documentdb-with-mongodb-compatibility/).
# Den Status eines Clusters ermitteln
Sie können den Status eines Clusters mit dem AWS-Managementkonsole oder ermitteln AWS CLI.
------
#### [ Using the AWS-Managementkonsole ]
Gehen Sie wie folgt vor, um den Status Ihres Amazon DocumentDB-Clusters mithilfe der AWS-Managementkonsole
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Klicken Sie im Navigationsbereich auf **Cluster**.
1. Suchen Sie in der Spalte **Cluster identifier (Cluster-ID)** den Namen des Clusters, der Sie interessiert. Um dann den Status des Clusters zu ermitteln, lesen Sie diese Zeile in die Spalte **Status**, wie unten gezeigt.
![\[Screenshot der Cluster-Seite mit Muster-Cluster, der den aktiven Status anzeigt.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cluster-status-con.png)
------
#### [ Using the AWS CLI ]
Verwenden Sie den `describe-db-clusters` Vorgang, um den Status Ihres Amazon DocumentDB-Clusters mithilfe von zu überprüfen. AWS CLI
Der folgende Code ermittelt den Status des Clusters `sample-cluster`.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
Für Windows:
```
aws docdb describe-db-clusters ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterIdentifier,Status]'
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
[
[
"sample-cluster",
"available"
]
]
```
------
# Amazon DocumentDB-Cluster-Lebenszyklus
Der Lebenszyklus eines Amazon DocumentDB-Clusters umfasst das Erstellen, Beschreiben, Ändern und Löschen des Clusters. Dieser Abschnitt enthält Informationen darüber, wie Sie diese Prozesse abschließen können.
**Topics**
+ [Einen Cluster erstellen](db-cluster-create.md)
+ [Beschreibung von Clustern](db-cluster-view-details.md)
+ [Modifizieren eines Clusters](db-cluster-modify.md)
+ [Ermittlung ausstehender Wartungsarbeiten](db-cluster-determine-pending-maintenance.md)
+ [Patch zur Aktualisierung der Engine-Version eines Clusters](db-cluster-version-upgrade.md)
+ [Stoppen und Starten eines Clusters](db-cluster-stop-start.md)
+ [Löschen eines Clusters](db-cluster-delete.md)
# Einen Amazon DocumentDB-Cluster erstellen
Ein Amazon DocumentDB-Cluster besteht aus Instances und einem Cluster-Volume, das die Daten für den Cluster darstellt. Das Cluster-Volumen wird auf sechs Arten über drei Availability Zones als ein einziges, virtuelles Volume repliziert. Der Cluster enthält eine primäre Instance und optional bis zu 15 Replikat-Instances.
In den folgenden Abschnitten wird gezeigt, wie Sie einen Amazon DocumentDB-Cluster mit dem AWS-Managementkonsole oder dem AWS CLI erstellen. Sie können dann weitere Replikat-Instances für diesen Cluster hinzufügen. Wenn Sie die Konsole verwenden, um Ihren Amazon DocumentDB-Cluster zu erstellen, wird gleichzeitig automatisch eine primäre Instance für Sie erstellt. Wenn Sie den verwenden, AWS CLI um Ihren Amazon DocumentDB-Cluster zu erstellen, müssen Sie, nachdem der Status des Clusters *verfügbar* ist, die primäre Instance für diesen Cluster erstellen.
## Voraussetzungen
Im Folgenden sind die Voraussetzungen für die Erstellung eines Amazon DocumentDB-Clusters aufgeführt.
Wenn Sie noch keinen haben AWS-Konto, führen Sie die folgenden Schritte aus, um einen zu erstellen.
**Um sich für eine anzumelden AWS-Konto**
1. Öffnen Sie [https://portal.aws.amazon.com/billing/die Anmeldung.](https://portal.aws.amazon.com/billing/signup)
1. Folgen Sie den Online-Anweisungen.
Während der Anmeldung erhalten Sie einen Telefonanruf oder eine Textnachricht und müssen einen Verifizierungscode über die Telefontasten eingeben.
Wenn Sie sich für eine anmelden AWS-Konto, *Root-Benutzer des AWS-Kontos*wird eine erstellt. Der Root-Benutzer hat Zugriff auf alle AWS-Services und Ressourcen des Kontos. Als bewährte Sicherheitsmethode weisen Sie einem Benutzer Administratorzugriff zu und verwenden Sie nur den Root-Benutzer, um [Aufgaben auszuführen, die Root-Benutzerzugriff erfordern](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
### VPC-Voraussetzungen
Sie können einen Amazon DocumentDB-Cluster nur in einer Amazon Virtual Private Cloud (Amazon VPC) erstellen. Ihre Amazon VPC muss mindestens ein Subnetz in jeder von mindestens zwei Availability Zones haben, damit Sie sie mit einem Amazon DocumentDB-Cluster verwenden können. Durch die Verteilung Ihrer Cluster-Instances auf Availability Zones stellen Sie sicher, dass Instances in Ihrem Cluster für den unwahrscheinlichen Fall eines Ausfalls der Availability Zone verfügbar sind.
### Voraussetzungen für das Subnetz
Wenn Sie einen Amazon DocumentDB-Cluster erstellen, müssen Sie eine VPC und die entsprechende Subnetzgruppe innerhalb dieser VPC auswählen, um Ihren Cluster zu starten. Subnetze bestimmen die Availability Zone und den IP-Bereich innerhalb dieser Availability Zone, die Sie zum Starten einer Instance verwenden möchten. Im Rahmen dieser Ausführungen werden die Begriffe *Subnetz* und *Availability Zone* synonym verwendet. Eine Subnetzgruppe ist ein benannter Satz von Subnetzen (oder Availability Zones). Mit einer Subnetzgruppe können Sie die Availability Zones angeben, die Sie zum Starten von Amazon DocumentDB DocumentDB-Instances verwenden möchten. So wird beispielsweise in einem Cluster mit drei Instances für eine hohe Verfügbarkeit empfohlen, dass jede dieser Instances in separaten Availability Zones bereitgestellt wird. Wenn eine einzelne Availability Zones ausfällt, wirkt sich dies nur auf eine einzelne Instance aus.
Amazon DocumentDB DocumentDB-Instances können derzeit in bis zu drei Availability Zones bereitgestellt werden. Selbst wenn eine Subnetzgruppe mehr als drei Subnetze hat, können Sie nur drei dieser Subnetze verwenden, um einen Amazon DocumentDB-Cluster zu erstellen. Daher wird empfohlen, dass Sie beim Anlegen einer Subnetzgruppe nur die drei Subnetze auswählen, in denen Sie Ihre Instances bereitstellen möchten. In USA Ost (Nord-Virginia) kann Ihre Subnetzgruppe sechs Subnetze (oder Availability Zones) haben. Wenn jedoch ein Amazon DocumentDB-Cluster bereitgestellt wird, wählt Amazon DocumentDB drei der Availability Zones aus, die es für die Bereitstellung von Instances verwendet.
Nehmen wir beispielsweise an, dass Amazon DocumentDB beim Erstellen eines Clusters die Availability Zones \$11A, 1B und 1C\$1 auswählt. Wenn Sie nun versuchen, eine Instance in Availability Zone \$11D\$1 zu erstellen, schlägt der API-Aufruf fehl. Wenn Sie sich jedoch dafür entscheiden, eine Instance zu erstellen, ohne eine bestimmte Availability Zone anzugeben, wählt Amazon DocumentDB in Ihrem Namen eine Availability Zone aus. Amazon DocumentDB verwendet einen Algorithmus für den Lastenausgleich der Instances in den Availability Zones, um Ihnen zu helfen, eine hohe Verfügbarkeit zu erreichen. Wenn beispielsweise drei Instances bereitgestellt werden, werden diese standardmäßig über drei Availability Zones verteilt und nicht alle in einer einzigen Availability Zone bereitgestellt.
**Empfehlungen:**
+ Wenn Sie keinen speziellen Grund haben, legen Sie immer eine Subnetzgruppe mit drei Subnetzen an. Auf diese Weise wird sichergestellt, dass Cluster mit drei oder mehr Instances eine höhere Verfügbarkeit erreichen können, da Instances über drei Availability Zones bereitgestellt werden.
+ Verteilen Sie Instances immer über mehrere Availability Zones, um eine hohe Verfügbarkeit zu erreichen. Platzieren Sie niemals alle Instances für einen Cluster in einer einzigen Availability Zone.
+ Da Failover-Ereignisse jederzeit auftreten können, sollten Sie nicht davon ausgehen, dass sich eine primäre Instance oder Replikat-Instance immer in einer bestimmten Availability Zone befinden.
### Zusätzliche Voraussetzungen
Im Folgenden sind einige zusätzliche Voraussetzungen für die Erstellung eines Amazon DocumentDB-Clusters aufgeführt:
+ Wenn Sie eine Verbindung AWS mit AWS Identity and Access Management (IAM-) Anmeldeinformationen herstellen, muss Ihr IAM-Konto über IAM-Richtlinien verfügen, die die Berechtigungen gewähren, die für die Ausführung von Amazon DocumentDB DocumentDB-Vorgängen erforderlich sind.
Wenn Sie ein IAM-Konto für den Zugriff auf die Amazon DocumentDB DocumentDB-Konsole verwenden, müssen Sie sich zunächst AWS-Managementkonsole mit Ihrem IAM-Konto bei der anmelden. Rufen Sie dann die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) auf.
+ Wenn Sie die Konfigurationsparameter für Ihren Cluster anpassen möchten, müssen Sie eine Cluster-Parametergruppe und eine Parametergruppe mit den erforderlichen Parametereinstellungen festlegen. Informationen zum Erstellen oder Ändern einer Cluster-Parametergruppe oder Parametergruppe finden Sie unter [Verwaltung von Amazon DocumentDB-Cluster-Parametergruppen](cluster_parameter_groups.md).
+ Sie müssen die TCP/IP Portnummer ermitteln, die Sie für Ihren Cluster angeben möchten. Die Firewalls einiger Unternehmen blockieren Verbindungen zu den Standardports für Amazon DocumentDB. Wenn die Firewall Ihres Unternehmens den Standard-Port blockiert, wählen Sie einen anderen Port für Ihr Cluster aus. Alle Instances in einem Cluster verwenden denselben Port.
## Erstellen eines Clusters und einer primären Instance mit dem AWS-Managementkonsole
Die folgenden Verfahren beschreiben, wie Sie die Konsole verwenden, um einen Amazon DocumentDB-Cluster mit einer oder mehreren Instances zu starten.
### Erstellen Sie einen Cluster: Verwenden Sie die Standardeinstellungen
**Um einen Cluster mit Instanzen unter Verwendung der Standardeinstellungen zu erstellen, verwenden Sie AWS-Managementkonsole**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Wenn Sie Ihren Cluster in einer AWS-Region anderen Region als der Region USA Ost (Nord-Virginia) erstellen möchten, wählen Sie die Region aus der Liste oben rechts in der Konsole aus.
1. Wählen Sie im Navigationsbereich **Clusters (Cluster)** und dann **Create (Erstellen)**.
**Tipp**
Wenn der Navigationsbereich auf der linken Seite des Bildschirms nicht angezeigt wird, wählen Sie links oben auf der Seite das Menüsymbol (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-menu-icon.png)) aus.
1. Füllen Sie auf der Seite **Amazon DocumentDB-Cluster erstellen** den Bereich **Konfiguration** aus.
1. **Cluster-ID** — Akzeptieren Sie den von Amazon DocumentDB angegebenen Namen, oder geben Sie einen Namen für Ihren Cluster ein, z. B. **sample-cluster**
Einschränkungen bei der Benennung von Clustern:
+ Die Länge beträgt [1—63] Buchstaben, Zahlen oder Bindestriche.
+ Muss mit einem Buchstaben beginnen.
+ Darf nicht mit einem Bindestrich enden oder zwei aufeinanderfolgende Bindestriche enthalten.
+ Muss für alle Cluster in Amazon RDS, Neptune und Amazon DocumentDB pro AWS-Konto Region eindeutig sein.
1. **Engine-Version** — Akzeptieren Sie die Standard-Engine-Version 5.0.0 oder wählen Sie optional 8.0.0, 4.0.0 oder 3.6.0.
1. **Instanzklasse** — Akzeptieren Sie die Standardklasse`db.r5.large`, oder wählen Sie die gewünschte Instanzklasse aus der Liste aus.
1. **Anzahl der Instanzen** — Wählen Sie in der Liste die Anzahl der Instances aus, die Sie mit diesem Cluster erstellen möchten. Die erste Instance ist die primäre Instance. Alle anderen Instances sind schreibgeschützte Replikat-Instances. Sie können später Instances hinzufügen und löschen. Standardmäßig wird ein Amazon DocumentDB-Cluster mit drei Instances (einer primären und zwei Replikaten) gestartet.
1. Füllen Sie den Abschnitt **Cluster-Speicherkonfiguration** aus.
Wählen Sie entweder **Amazon DocumentDB Standard (Standard**) oder **Amazon DocumentDB** I/O-Optimized. Weitere Informationen finden Sie unter [Amazon DocumentDB-Cluster-Speicherkonfigurationen](db-cluster-storage-configs.md).
1. Vervollständigen Sie den Bereich **Authentication (Authentifizierung)**.
1. **Benutzername** — Geben Sie einen Namen für den Hauptbenutzer ein. Um sich bei Ihrem Cluster anzumelden, müssen Sie den primären Benutzernamen verwenden.
Einschränkungen bei der Benennung primärer Benutzer:
+ Die Länge beträgt [1—63] alphanumerische Zeichen.
+ Muss mit einem Buchstaben beginnen.
+ Darf kein Wort sein, das von der Datenbank-Engine reserviert ist.
1. Wählen Sie eine der folgenden Passwortoptionen:
+ **Verwaltet in AWS Secrets Manager** — Wählen Sie diese Option, wenn Sie Ihr primäres Benutzerkennwort automatisch verwalten möchten AWS Secrets Manager .
Wenn Sie diese Option wählen, konfigurieren Sie den KMS-Schlüssel, indem Sie entweder Ihren eigenen Schlüssel erstellen oder einen Schlüssel verwenden, den Secrets Manager erstellt.
+ **Selbstverwaltet** — Wählen Sie diese Option, wenn Sie Ihr primäres Benutzerkennwort selbst verwalten möchten. Wenn Sie diese Option wählen, geben Sie ein Passwort für den Hauptbenutzer ein und bestätigen Sie es dann. Um sich bei Ihrem Cluster anzumelden, müssen Sie das Passwort für den Hauptbenutzer verwenden.
Passwortbeschränkungen:
+ Länge beträgt [8–100] druckbare ASCII-Zeichen.
+ Es können alle druckbaren ASCII-Zeichen mit Ausnahme der folgenden verwendet werden:
+ **/** (Schrägstrich)
+ **"** (doppeltes Anführungszeichen)
+ **@** ('At'-Symbol)
1. Wählen Sie am unteren Rand der Seite eine der folgenden Optionen:
+ Um den Cluster jetzt zu erstellen, wählen Sie **Create Cluster (Cluster erstellen)** aus.
+ Wenn der Cluster nicht neu erstellt werden soll, wählen Sie **Cancel (Abbrechen)** aus.
+ Um den Cluster vor der Erstellung weiter zu konfigurieren, wählen Sie **Show additional configurations (Weitere Konfigurationen anzeigen)** aus und fahren dann mit [Einen Cluster erstellen: zusätzliche Konfigurationen](#db-cluster-create-con-additional-configs) fort.
Im Bereich **Additional Configurations (Zusätzliche Konfigurationen)** sind die folgenden Konfigurationen zu finden:
+ **Netzwerkeinstellungen** — Standardmäßig wird die `default` VPC-Sicherheitsgruppe verwendet.
+ **Clusteroptionen** — Standardmäßig wird der Port 27017 und die Standardparametergruppe verwendet.
+ **Verschlüsselung** — Standardmäßig wird die Verschlüsselung mithilfe des `(default) aws/rds` Schlüssels aktiviert.
**Wichtig**
Die Verschlüsselung eines einmal verschlüsselten Clusters kann nicht wieder aufgehoben werden.
+ **Backup** — Standardmäßig werden Backups für einen Tag aufbewahrt und Amazon DocumentDB das Backup-Fenster wählen lassen.
+ **Protokollexporte** — Standardmäßig werden Audit-Logs nicht in Logs exportiert CloudWatch .
+ **Wartung** — Standardmäßig lässt Amazon DocumentDB das Wartungsfenster wählen.
+ **Löschschutz** — Schützt Ihren Cluster vor versehentlichem Löschen. Cluster, die mit der Konsole erstellt wurden, sind standardmäßig *aktiviert*.
Wenn Sie die Standardeinstellungen jetzt übernehmen, können Sie die meisten davon später durch Bearbeitung des Clusters wieder ändern.
1. Aktivieren Sie eingehende Verbindungen für die Sicherheitsgruppe Ihres Clusters.
Wenn Sie die Standardeinstellungen für Ihr Cluster nicht geändert haben, wurde mithilfe der Standard-Sicherheitsgruppe ein Cluster für die Standard-VPC in der angegebenen Region erstellt. Um eine Verbindung zu Amazon DocumentDB herzustellen, müssen Sie eingehende Verbindungen auf Port 27017 (oder dem Port Ihrer Wahl) für die Sicherheitsgruppe Ihres Clusters aktivieren.
**So fügen Sie eine eingehende Verbindung zur Sicherheitsgruppe**Ihres Clusters hinzu:
1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon EC2 EC2-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Wählen Sie im Abschnitt **Resources (Ressourcen)** des Hauptfensters die Option **Security groups (Sicherheitsgruppen)**.
![\[Bild: Ressourcenliste, in der die Link-Option „Sicherheitsgruppen“ hervorgehoben ist.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-ec2-security-groups.png)
1. Wählen Sie in der Liste der Sicherheitsgruppen die Sicherheitsgruppe aus, die Sie bei der Erstellung Ihres Cluster verwendet haben (höchstwahrscheinlich handelt es sich dabei um die *Standard*-Sicherheitsgruppe), und wählen Sie das Feld links neben dem Name der Sicherheitsgruppe aus.
![\[Bild: Liste der Sicherheitsgruppen, in der eine Sicherheitsgruppe mit aktiviertem Kästchen hervorgehoben wird.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-ec2-default-sg.png)
1. Wählen Sie im Menü **Aktionen** die Option **Eingangsregeln bearbeiten** aus. Wählen Sie dann die Regeleinschränkungen aus oder geben Sie diese ein.
1. **Typ** — Wählen Sie aus der Liste das Protokoll aus, das für den Netzwerkverkehr geöffnet werden soll.
1. **Protokoll** — Wählen Sie aus der Liste den Protokolltyp aus.
1. **Portbereich** — Geben Sie für eine benutzerdefinierte Regel eine Portnummer oder einen Portbereich ein. Stellen Sie sicher, dass die Portnummer bzw. der Portbereich den Port enthält, den Sie beim Erstellen des Clusters angegeben haben (Standard: 27017).
1. **Quelle** — Gibt den Datenverkehr an, der Ihre Instance erreichen kann. Wählen Sie die Datenverkehrquelle aus der Liste aus. Wenn Sie **Custom (Benutzerdefiniert)** auswählen, geben Sie eine einzelne IP-Adresse oder einen IP-Adressbereich CIDR-Notation an (z. B. 203.0.113.5/32).
1. **Beschreibung** — Geben Sie eine Beschreibung für diese Regel ein.
1. Wenn Sie die Regel fertig erstellt haben, wählen Sie **Save (Speichern)**.
### Einen Cluster erstellen: zusätzliche Konfigurationen
Wenn Sie die Standardeinstellungen für Ihren Cluster übernehmen möchten, können Sie die folgenden Schritte überspringen und **Create cluster (Cluster erstellen)** auswählen.
1. Vervollständigen Sie den Bereich **Network settings (Netzwerkeinstellungen)**.
![\[Screenshot mit dem Bereich "Network Settings (Netzwerkeinstellungen)" und den Schritten zur Konfiguration der Netzwerkeinstellungen\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/create-db-cluster-console-network-settings.png)
1. **Virtual Private Cloud (VPC)** — Wählen Sie in der Liste die Amazon-VPC aus, in der Sie diesen Cluster starten möchten.
1. **Subnetzgruppe** — Wählen Sie in der Liste die Subnetzgruppe aus, die Sie für diesen Cluster verwenden möchten.
1. **VPC-Sicherheitsgruppen** — Wählen Sie in der Liste die VPC-Sicherheitsgruppe für diesen Cluster aus.
1. Vervollständigen Sie den Bereich **Cluster options (Cluster-Optionen)**.
![\[Screenshot mit dem Bereich "Cluster Options (Cluster-Optionen)" und den Schritten zur Konfiguration der Cluster-Einstellungen\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/create-db-cluster-console-cluster-options.png)
1. **Datenbankport** — Verwenden Sie die Aufwärts- und Abwärtspfeile, um den TCP/IP Port festzulegen, über den Anwendungen eine Verbindung zu Ihrer Instance herstellen.
1. **Cluster-Parametergruppe** — Wählen Sie in der Liste der Parametergruppen die Cluster-Parametergruppe für diesen Cluster aus.
1. Vervollständigen Sie den Bereich **Encryption (Verschlüsselung)**.
![\[Screenshot mit dem Bereich "Encryption (Verschlüsselung)" und den Schritten zur Konfiguration der Verschlüsselung des Clusters\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/encrypt-at-rest.png)
1. **E ncryption-at-rest** — Wählen Sie eine der folgenden Optionen:
+ **Verschlüsselung aktivieren — Standard**. Alle Daten im Ruhezustand werden verschlüsselt. Wenn Sie sich für die Verschlüsselung Ihrer Daten entscheiden, können Sie diese Aktion nicht rückgängig machen.
+ **Verschlüsselung deaktivieren** — Ihre Daten sind nicht verschlüsselt.
1. **AWS KMS-Schlüssel** — Dieser Schlüssel ist nur verfügbar, wenn Sie Ihre Daten verschlüsseln. Wählen Sie aus der Liste den Schlüssel aus, den Sie für die Verschlüsselung der Daten in diesem Cluster verwenden möchten. Der Standardwert ist `(default) aws/rds`.
Wenn Sie **Enter a key ARN (Einen Schlüssel-ARN eingeben)** auswählen, müssen Sie einen Amazon-Ressourcenname (ARN) für den Schlüssel eingeben.
1. Vervollständigen Sie den Bereich **Backup**.
![\[Screenshot mit dem Bereich "Backup (Sicherung)" und den Schritten zur Konfiguration des Cluster-Sicherungsfensters\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/create-db-cluster-console-backup.png)
1. **Aufbewahrungszeitraum für Backup** — Wählen Sie in der Liste die Anzahl der Tage aus, für die automatische Backups dieses Clusters aufbewahrt werden sollen, bevor sie gelöscht werden.
1. **Backup-Fenster** — Legen Sie die tägliche Uhrzeit und Dauer fest, während der Amazon DocumentDB Backups dieses Clusters erstellen soll.
1. **Startzeit** — Wählen Sie in der ersten Liste die Startzeit (UTC) für den Start Ihrer automatischen Backups aus. Wählen Sie in der zweiten Liste die Minute für den Beginn der automatischen Backups aus.
1. **Dauer** — Wählen Sie in der Liste die Anzahl der Stunden aus, die für die Erstellung automatischer Backups reserviert werden sollen.
1. Füllen **Sie den Bereich Protokollexporte** aus, indem Sie die Protokolltypen auswählen, die Sie in CloudWatch Protokolle exportieren möchten.
![\[Screenshot des Bereichs Protokollexporte mit den Schritten zur Konfiguration der DML-Protokollierung des Clusters.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/create-db-cluster-console-log-exports.png)
+ **Audit-Logs** — Wählen Sie diese Option, um den Export von Audit-Logs nach Amazon CloudWatch Logs zu ermöglichen. Wenn Sie **Audit logs (Auditprotokolle)**, auswählen, müssen Sie `audit_logs` in der benutzerdefinierten Parametergruppe des Clusters aktivieren. Weitere Informationen finden Sie unter [Amazon DocumentDB DocumentDB-Ereignisse prüfen](event-auditing.md).
+ **Profiler-Protokolle** — Wählen Sie diese Option, um den Export von Operation-Profiler-Protokollen nach Amazon Logs zu aktivieren. CloudWatch Wenn Sie **Profiler logs (Profiler-Protokolle)** auswählen, müssen Sie auch die folgenden Parameter in der benutzerdefinierten Parametergruppe des Clusters ändern:
+ `profiler`— Eingestellt auf. `enabled`
+ `profiler_threshold_ms`— Auf einen Wert setzen, `[0-INT_MAX]` um den Schwellenwert für Profilerstellungsvorgänge festzulegen.
+ `profiler_sampling_rate`— Legen Sie einen Wert fest, um den Prozentsatz langsamer Vorgänge festzulegen`[0.0-1.0]`, für den ein Profil erstellt werden soll.
Weitere Informationen finden Sie unter [Profilierung von Amazon DocumentDB DocumentDB-Vorgängen](profiling.md).
1. Schließen Sie den Bereich **Maintenance (Wartung)** ab.
![\[Screenshot mit dem Bereich "Maintenance (Wartung)" und den Schritten zur Konfiguration des Wartungsfensters des Clusters\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/create-db-cluster-console-maintenance.png)
1. Wählen Sie eine der folgenden Optionen aus:
+ **Fenster auswählen** — Sie können den Wochentag, die UTC-Startzeit und die Dauer angeben, für die Amazon DocumentDB Wartungsarbeiten an Ihrem Cluster durchführt.
1. **Starttag** — Wählen Sie in der Liste den Wochentag aus, an dem die Cluster-Wartung gestartet werden soll.
1. **Startzeit** — Wählen Sie in den Listen die Stunde und Minute (UTC) aus, um mit der Wartung zu beginnen.
1. **Dauer** — Wählen Sie in der Liste aus, wie viel Zeit für die Cluster-Wartung reserviert werden soll. Wenn die Wartung nicht innerhalb der angegebenen Zeit abgeschlossen werden kann, wird der Wartungsprozess über die angegebene Zeit hinaus bis zum Abschluss fortgesetzt.
+ **Keine Präferenz** — Amazon DocumentDB wählt den Wochentag, die Startzeit und die Dauer für die Durchführung von Wartungsarbeiten.
1. Wenn Sie diesem Cluster ein oder mehrere Tags hinzufügen möchten, stellen Sie den Bereich **Tags** fertig.
![\[Screenshot des ausgewählten Kontrollkästchens zum Aktivieren des Löschschutzes\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/create-db-cluster-console-tags.png)
Wiederholen Sie die folgenden Schritte für alle Tags, die Sie dem Cluster hinzufügen möchten. Sie können bis zu 10 in einem Cluster haben.
1. Wählen Sie **Tags hinzufügen** aus.
1. Geben Sie den **Schlüssel** des Tags ein.
1. Optional können Sie auch den **Wert** des Tags eingeben.
Klicken Sie zum Entfernen eines Tags auf **Tag entfernen**.
1. Der **Löschschutz** ist standardmäßig aktiviert, wenn Sie ein Cluster mit der Konsole erstellen. Deaktivieren Sie zum Ausschalten des Löschschutzes die Option **Löschschutz aktivieren**. Wenn diese Option aktiviert ist, verhindert der Löschschutz das Löschen eines Clusters. Wenn Sie einen löschgeschützten Cluster löschen möchten, müssen Sie zuerst den Cluster-Löschschutz deaktivieren.
![\[Screenshot des ausgewählten Kontrollkästchens zum Aktivieren des Löschschutzes\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/create-db-cluster-console-deletion-protection.png)
Weitere Informationen über den Löschschutz finden Sie unter [Löschen eines Amazon DocumentDB-Clusters](db-cluster-delete.md).
1. Wählen Sie zum Erstellen des Clusters **Cluster erstellen** aus. Wählen Sie andernfalls **Abbrechen**.
## Erstellen eines Clusters mit dem AWS CLI
Die folgenden Verfahren beschreiben, wie Sie den verwenden, um einen Amazon DocumentDB-Cluster AWS CLI zu starten und ein Amazon DocumentDB DocumentDB-Replikat zu erstellen.
**Parameters**
+ **--db-cluster-identifier**—Erforderlich. Eine Zeichenfolge in Kleinbuchstaben, die diesen Cluster identifiziert.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/db-cluster-create.html)
+ **--engine**—Erforderlich. Der Wert muss **docdb** sein.
+ **--deletion-protection \$1 --no-deletion-protection**— Fakultativ. Der aktivierte Löschschutz verhindert, dass ein Cluster gelöscht wird. Wenn Sie die verwenden AWS CLI, ist der Löschschutz standardmäßig deaktiviert.
Weitere Informationen über den Löschschutz finden Sie unter [Löschen eines Amazon DocumentDB-Clusters](db-cluster-delete.md).
+ **--storage-type standard \$1 iopt1**— Fakultativ. Standard: **standard**. Die Speicherkonfiguration des Clusters. Gültige Werte sind `standard` (Standard) oder `iopt1` (I/O-optimiert).
+ **--master-username**—Erforderlich. Der Benutzername für die Authentifizierung des Benutzers.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/db-cluster-create.html)
+ **--master-user-password**— Optional. Das Passwort für die Authentifizierung des Benutzers.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/db-cluster-create.html)
+ **--manage-master-user-password**—Fakultativ. Amazon DocumentDB generiert das Masterbenutzerkennwort und verwaltet es während seines gesamten Lebenszyklus in Secrets Manager.
Weitere Parameter finden Sie unter [CreateDBCluster](API_CreateDBCluster.md).
**Um einen Amazon DocumentDB-Cluster mit dem AWS CLI**
Um einen Amazon DocumentDB-Cluster zu erstellen, rufen Sie den auf `create-db-cluster` AWS CLI. Der folgende AWS CLI Befehl erstellt einen Amazon DocumentDB-Cluster `sample-cluster` mit dem Namen und aktiviertem Löschschutz. Weitere Informationen zum Löschschutz finden Sie unter[Löschen eines Amazon DocumentDB-Clusters](db-cluster-delete.md).
Außerdem `--engine-version` ist dies ein optionaler Parameter, der standardmäßig die neueste Hauptversion der Engine verwendet. Die aktuelle Standard-Engine-Version ist 5.0.0 (Hinweis: Amazon DocumentDB 8.0 ist verfügbar, muss aber explizit angegeben werden). Wenn neue Hauptversionen der Engine veröffentlicht werden, `--engine-version` wird die Standard-Engine-Version für aktualisiert, sodass sie die letzte Hauptversion der Engine widerspiegelt. Daher empfehlen wir für Produktionsworkloads, insbesondere solche, die von Skripten, Automatisierung oder CloudFormation Vorlagen abhängig sind, die Angabe der `--engine-version` beabsichtigten Hauptversion ausdrücklich.
**Anmerkung**
Wenn ein `db-subnet-group-name` oder nicht angegeben `vpc-security-group-id` ist, verwendet Amazon DocumentDB die Standard-Subnetzgruppe und die Amazon VPC-Sicherheitsgruppe für die angegebene Region.
Für Linux, macOS oder Unix:
```
aws docdb create-db-cluster \
--db-cluster-identifier sample-cluster \
--engine docdb \
--engine-version 5.0.0 \
--deletion-protection \
--master-username masteruser \
--master-user-password password
```
Für Windows:
```
aws docdb create-db-cluster ^
--db-cluster-identifier sample-cluster ^
--engine docdb ^
--engine-version 5.0.0 ^
--deletion-protection ^
--master-username masteruser ^
--master-user-password password
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
{
"DBCluster": {
"StorageEncrypted": false,
"DBClusterMembers": [],
"Engine": "docdb",
"DeletionProtection" : "enabled",
"ClusterCreateTime": "2018-11-26T17:15:19.885Z",
"DBSubnetGroup": "default",
"EngineVersion": "5.0.0",
"MasterUsername": "masteruser",
"BackupRetentionPeriod": 1,
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"DBClusterIdentifier": "sample-cluster",
"MultiAZ": false,
"DBClusterParameterGroup": "default.docdb5.0",
"PreferredBackupWindow": "09:12-09:42",
"DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
"PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
"Port": 27017,
"Status": "creating",
"ReaderEndpoint": "sample-cluster.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
"AssociatedRoles": [],
"HostedZoneId": "ZNKXTT8WH85VW",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"AvailabilityZones": [
"us-east-1a",
"us-east-1c",
"us-east-1e"
],
"Endpoint": "sample-cluster.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
}
}
```
Die Erstellung des Clusters dauert mehrere Minuten. Sie können das AWS-Managementkonsole oder verwenden AWS CLI , um den Status Ihres Clusters zu überwachen. Weitere Informationen finden Sie unter [Den Status eines Amazon DocumentDB-Clusters überwachen](monitoring_docdb-cluster_status.md).
**Wichtig**
Wenn Sie den verwenden AWS CLI , um einen Amazon DocumentDB-Cluster zu erstellen, werden keine Instances erstellt. Daher müssen Sie explizit eine primäre Instance und alle benötigten Replikat-Instances anlegen. Sie können entweder die Konsole oder AWS CLI zum Erstellen der Instances verwenden. Weitere Informationen finden Sie unter [Hinzufügen einer Amazon DocumentDB DocumentDB-Instance zu einem Cluster](db-instance-add.md).
Weitere Informationen finden Sie [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html)in der *Amazon DocumentDB DocumentDB-API-Referenz.*
# Beschreibung von Amazon DocumentDB-Clustern
Sie können entweder die Amazon DocumentDB Management Console oder die verwenden, AWS CLI um Details wie Verbindungsendpunkte, Sicherheitsgruppen und Parametergruppen zu Ihren Amazon DocumentDB-Clustern anzuzeigen. VPCs
Weitere Informationen finden Sie hier:
+ [Den Status eines Amazon DocumentDB-Clusters überwachen](monitoring_docdb-cluster_status.md)
+ [Die Endpunkte eines Clusters finden](db-cluster-endpoints-find.md)
------
#### [ Using the AWS-Managementkonsole ]
Gehen Sie wie folgt vor, um die Details eines bestimmten Amazon DocumentDB-Clusters mithilfe der Konsole anzuzeigen.
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Klicken Sie im Navigationsbereich auf **Cluster**.
**Tipp**
Wenn der Navigationsbereich auf der linken Seite des Bildschirms nicht angezeigt wird, wählen Sie links oben auf der Seite das Menüsymbol (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-menu-icon.png)) aus.
1. Wählen Sie in der Liste der Cluster den Namen des Clusters aus, dessen Details Sie sehen möchten. Die Informationen über den Cluster sind in die folgenden Gruppierungen unterteilt:
+ **Zusammenfassung** — Allgemeine Informationen über den Cluster, einschließlich der Engine-Version, des Cluster-Status, ausstehender Wartungsarbeiten und des Status der zugehörigen Parametergruppe.
+ **Konnektivität und Sicherheit** — Der Abschnitt **Connect** listet Verbindungsendpunkte auf, um mit der Mongo-Shell oder mit einer Anwendung eine Verbindung zu diesem Cluster herzustellen. Im Abschnitt **Sicherheitsgruppen** werden die Sicherheitsgruppen aufgeführt, die diesem Cluster zugeordnet sind, sowie ihre VPC-ID und Beschreibungen.
+ **Konfiguration** — Im Abschnitt **Cluster-Details** werden Details zum Cluster aufgeführt, einschließlich des Amazon-Ressourcennamens (ARN), des Endpunkts und der Parametergruppe des Clusters. Außerdem werden die Sicherungsinformationen, Wartungsdetails sowie Sicherheits- und Netzwerkeinstellungen des Clusters aufgelistet. Im Abschnitt **Cluster-Instances** werden die Instances aufgeführt, die zu diesem Cluster gehören, mit dem Status der einzelnen Instance-Rollen und Cluster-Parametergruppen.
+ **Überwachung** — Die Amazon CloudWatch Logs-Metriken für diesen Cluster. Weitere Informationen finden Sie unter [Überwachen von Amazon DocumentDB mit CloudWatch](cloud_watch.md).
+ **Ereignisse und Tags** — Im Abschnitt **Aktuelle Ereignisse** sind die jüngsten Ereignisse für diesen Cluster aufgeführt. Amazon DocumentDB zeichnet Ereignisse auf, die sich auf Ihre Cluster, Instances, Snapshots, Sicherheitsgruppen und Cluster-Parametergruppen beziehen. Zu diesen Informationen gehören Datum, Uhrzeit und Nachricht, die jedem Ereignis zugeordnet sind. Der Abschnitt **Tags** listet die an diesen Cluster angehängten Tags auf.
------
#### [ Using the AWS CLI ]
Um die Details Ihrer Amazon DocumentDB-Cluster mithilfe von anzuzeigen AWS CLI, verwenden Sie den `describe-db-clusters` Befehl, wie in den folgenden Beispielen gezeigt. Weitere Informationen finden Sie [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html)in der *Amazon DocumentDB Resource Management API-Referenz.*
**Anmerkung**
Für bestimmte Verwaltungsfunktionen wie Cluster- und Instance-Lebenszyklusmanagement nutzt Amazon DocumentDB Betriebstechnologie, die mit Amazon RDS gemeinsam genutzt wird. Der `filterName=engine,Values=docdb` Filterparameter gibt nur Amazon DocumentDB-Cluster zurück.
**Example**
**Beispiel 1: Alle Amazon DocumentDB-Cluster auflisten**
Der folgende AWS CLI Code listet die Details für alle Amazon DocumentDB-Cluster in einer Region auf.
```
aws docdb describe-db-clusters --filter Name=engine,Values=docdb
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
{
"DBClusters": [
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-1",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-2",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-3",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
}
]
}
```
**Example**
**Beispiel 2: Alle Details für einen bestimmten Amazon DocumentDB-Cluster auflisten**
Der folgende AWS CLI Code listet die Details für den Cluster `sample-cluster` auf.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-clusters \
--filter Name=engine,Values=docdb \
--db-cluster-identifier sample-cluster
```
Für Windows:
```
aws docdb describe-db-clusters ^
--filter Name=engine,Values=docdb ^
--db-cluster-identifier sample-cluster
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
{
"DBClusters": [
{
"AllocatedStorage": 1,
"AvailabilityZones": [
"us-east-1c",
"us-east-1a",
"us-east-1d"
],
"BackupRetentionPeriod": 2,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
"EarliestRestorableTime": "2023-11-07T22:34:08.148000+00:00",
"Endpoint": "sample-cluster.node.us-east-1.amazon.com",
"ReaderEndpoint": "sample-cluster.node.us-east-1.amazon.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "5.0.0",
"LatestRestorableTime": "2023-11-10T07:21:16.772000+00:00",
"Port": 27017,
"MasterUsername": "chimeraAdmin",
"PreferredBackupWindow": "22:22-22:52",
"PreferredMaintenanceWindow": "sun:03:01-sun:03:31",
"ReadReplicaIdentifiers": [],
"DBClusterMembers": [
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-9084c2ec",
"Status": "active"
}
],
"HostedZoneId": "Z06853723JYKYBXTJ49RB",
"StorageEncrypted": false,
"DbClusterResourceId": "cluster-T4LGLANHVAPGQYYULWUDKLVQL4",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"AssociatedRoles": [],
"IAMDatabaseAuthenticationEnabled": false,
"ClusterCreateTime": "2023-11-06T18:05:41.568000+00:00",
"EngineMode": "provisioned",
"DeletionProtection": false,
"HttpEndpointEnabled": false,
"CopyTagsToSnapshot": false,
"CrossAccountClone": false,
"DomainMemberships": [],
"TagList": [],
"StorageType": "iopt1",
"AutoMinorVersionUpgrade": false,
"NetworkType": "IPV4",
"IOOptimizedNextAllowedModificationTime": "2023-12-07T18:05:41.580000+00:00"
}
]
}
```
**Example**
**Beispiel 3: Spezifische Details für einen Amazon DocumentDB-Cluster auflisten**
Um eine Teilmenge der Cluster-Details mithilfe von aufzulisten AWS CLI, fügen Sie eine hinzu, die `--query` angibt, welche Cluster-Mitglieder der `describe-db-clusters` Vorgang auflisten soll. Der `--db-cluster-identifier`-Parameter ist der Bezeichner für den jeweiligen Cluster, dessen Details Sie anzeigen möchten. *Weitere Informationen zu Abfragen finden Sie unter [So filtern Sie die Ausgabe mit der `--query` Option](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output.html#controlling-output-filter) im AWS Command Line Interface Benutzerhandbuch.*
Das folgende Beispiel listet die Instances in einem Amazon DocumentDB-Cluster auf.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-clusters \
--filter Name=engine,Values=docdb \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterMembers]'
```
Für Windows:
```
aws docdb describe-db-clusters ^
--filter Name=engine,Values=docdb ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterMembers]'
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
[
[
[
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": false,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
]
]
]
```
------
# Ändern eines Amazon DocumentDB-Clusters
Nur Cluster, die sich im Status *available* befinden, können geändert werden. Ein angehaltener Cluster kann nicht geändert werden. Wenn der Cluster angehalten ist, starten Sie zuerst den Cluster, warten Sie, bis der Cluster *verfügbar* wird, und nehmen Sie dann die gewünschten Änderungen vor. Weitere Informationen finden Sie unter [Einen Amazon DocumentDB-Cluster stoppen und starten](db-cluster-stop-start.md).
------
#### [ Using the AWS-Managementkonsole ]
Gehen Sie wie folgt vor, um einen bestimmten Amazon DocumentDB-Cluster mithilfe der Konsole zu ändern.
**So ändern Sie einen Amazon-DocumentDB-Cluster**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Klicken Sie im Navigationsbereich auf **Cluster**.
**Tipp**
Wenn der Navigationsbereich auf der linken Seite des Bildschirms nicht angezeigt wird, wählen Sie links oben auf der Seite das Menüsymbol (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-menu-icon.png)) aus.
1. Geben Sie den Cluster an, den Sie ändern möchten, indem Sie die Schaltfläche links neben dem Namen des Clusters auswählen.
1. Wählen Sie **Actions (Aktionen)** und dann **Modify (Ändern)** aus.
1. Nehmen Sie im Bereich **Modify Cluster: (Cluster ändern: )** die gewünschten Änderungen vor. Sie können in den folgenden Bereichen Änderungen durchführen:
+ **Clusterspezifikationen** — Der Name des Clusters, die Sicherheitsgruppen und die Verwaltung der Anmeldeinformationen.
+ **Cluster-Speicherkonfiguration** — Der Datenspeichermodus des Clusters. Wählen Sie zwischen Standard- und I/O-optimierter Konfiguration.
+ **Clusteroptionen** — Der Port und die Parametergruppe des Clusters.
+ **Backup** — Der Aufbewahrungszeitraum für Backups und das Backup-Fenster des Clusters.
+ **Protokollexporte** — Aktiviert oder deaktiviert den Export von Audit- oder Profiler-Protokollen.
+ **Wartung** — Legt das Wartungsfenster des Clusters fest.
+ **Löschschutz** — Aktiviert oder deaktiviert den Löschschutz auf dem Cluster. Der Löschschutz ist standardmäßig aktiviert.
1. Wenn Sie fertig sind, wählen Sie **Continue (Weiter)** aus, um eine Zusammenfassung Ihrer Änderungen anzuzeigen.
1. Wenn Sie mit den Änderungen zufrieden sind, können Sie **Modify cluster (Cluster ändern)** auswählen, um den Cluster zu ändern. Alternativ können Sie **Back (Zurück)** oder **Cancel (Abbrechen)** wählen, um die Änderungen zu bearbeiten oder abzubrechen.
Es dauert einige Minuten, bis Ihre Änderungen übernommen werden. Sie können den Cluster nur verwenden, wenn sein Status *available* ist. Sie können den Status des Clusters über die Konsole oder AWS CLIüberwachen. Weitere Informationen finden Sie unter [Den Status eines Amazon DocumentDB-Clusters überwachen](monitoring_docdb-cluster_status.md).
------
#### [ Using the AWS CLI ]
Verwenden Sie die `modify-db-cluster`-Operation, um den angegebenen Cluster mit der AWS CLI zu ändern. Weitere Informationen finden Sie [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html)in der *Amazon DocumentDB DocumentDB-API-Referenz.*
**Parameters**
+ **--db-cluster-identifier**—Erforderlich. Die ID des Amazon DocumentDB-Clusters, den Sie ändern werden.
+ **--backup-retention-period**— Fakultativ. Die Anzahl von Tagen, über die automatische Backups aufbewahrt werden. Gültige Werte sind 1—35.
+ **--storage-type**— Fakultativ. Die Speicherkonfiguration des Clusters. Gültige Werte sind `standard` (Standard) oder `iopt1` (I/O-optimiert).
+ **--db-cluster-parameter-group-name**— Optional. Der Name der Cluster-Parametergruppe, die für den Cluster verwendet werden soll.
+ **--manage-master-user-password**—Fakultativ. Amazon DocumentDB generiert das Masterbenutzerkennwort und verwaltet es während seines gesamten Lebenszyklus in Secrets Manager.
+ **--rotate-master-user-password**— Fakultativ. Secrets Manager generiert eine neue geheime Version für das bestehende Geheimnis. Die neue Version des Secrets enthält das neue primäre Benutzerkennwort. Amazon DocumentDB ändert das primäre Benutzerkennwort für den Cluster so, dass es mit dem Passwort für die neue geheime Version übereinstimmt.
Sie müssen die **--apply-immediately** Option angeben, wenn Sie das primäre Passwort ändern.
+ **--master-user-password**— Fakultativ. Das neue Passwort für den primären Datenbankbenutzer.
Passwortbeschränkungen:
+ Die Länge beträgt [8—100] druckbare ASCII-Zeichen.
+ Es können alle druckbaren ASCII-Zeichen mit Ausnahme der folgenden verwendet werden:
+ **/** (Schrägstrich)
+ **"** (doppeltes Anführungszeichen)
+ **@** ('At'-Symbol)
+ **--new-db-cluster-identifier**— Fakultativ. Die neue Cluster-ID für den Cluster beim Umbenennen eines Clusters. Dieser Wert wird als Zeichenfolge in Kleinbuchstaben gespeichert.
Benennungseinschränkungen:
+ Die Länge beträgt [1—63] Buchstaben, Zahlen oder Bindestriche.
+ Muss mit einem Buchstaben beginnen.
+ Darf nicht mit einem Bindestrich enden oder zwei aufeinanderfolgende Bindestriche enthalten.
+ Muss für alle Cluster in Amazon RDS, Amazon Neptune und Amazon DocumentDB pro AWS-Konto Region eindeutig sein.
+ **--preferred-backup-window**— Fakultativ. Der tägliche Zeitbereich, in dem automatisierte Backups erstellt werden, in Universal Coordinated Time (UTC).
+ Format: `hh24:mm-hh24:mm`
+ **--preferred-maintenance-window**—Fakultativ. Der wöchentliche Zeitbereich, in dem Systemwartungen stattfinden können, in UTC.
+ Format: `ddd:hh24:mm-ddd:hh24:mm`
+ Gültige Tage: `Sun`, `Mon`, `Tue`, `Wed`, `Thu`, `Fri` und `Sat`.
+ **--deletion-protection**oder **--no-deletion-protection** — Optional. Gibt an, ob der Löschschutz für diesen Cluster aktiviert werden soll. Der Löschschutz verhindert, dass ein Cluster versehentlich gelöscht wird, solange der Cluster-Löschschutz nicht deaktiviert wurde. Weitere Informationen finden Sie unter [Löschen eines Amazon DocumentDB-Clusters](db-cluster-delete.md).
+ **--apply-immediately**oder **--no-apply-immediately** — Verwenden Sie diese Option`--apply-immediately`, um die Änderung sofort vorzunehmen. Verwenden Sie `--no-apply-immediately`, um die Änderung während des nächsten Wartungsfensters Ihres Clusters vorzunehmen.
**Example**
Der folgende Code ändert die Aufbewahrungsfrist für das Backup für den Cluster `sample-cluster`.
Für Linux, macOS oder Unix:
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--apply-immediately \
--backup-retention-period 7
```
Für Windows:
```
aws docdb modify-db-cluster ^
--db-cluster-identifier sample-cluster ^
--apply-immediately ^
--backup-retention-period 7
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
{
"DBCluster": {
"BackupRetentionPeriod": 7,
"DbClusterResourceId": "cluster-VDP53QEWST7YHM36TTXOPJT5YE",
"Status": "available",
"DBClusterMembers": [
{
"PromotionTier": 1,
"DBClusterParameterGroupStatus": "in-sync",
"DBInstanceIdentifier": "sample-cluster-instance",
"IsClusterWriter": true
}
],
"ReadReplicaIdentifiers": [],
"AvailabilityZones": [
"us-east-1b",
"us-east-1c",
"us-east-1a"
],
"ReaderEndpoint": "sample-cluster.cluster-ro-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"PreferredMaintenanceWindow": "sat:09:51-sat:10:21",
"EarliestRestorableTime": "2018-06-17T00:06:19.374Z",
"StorageEncrypted": false,
"MultiAZ": false,
"AssociatedRoles": [],
"MasterUsername": "",
"DBClusterIdentifier": "sample-cluster",
"VpcSecurityGroups": [
{
"Status": "active",
"VpcSecurityGroupId": "sg-77186e0d"
}
],
"HostedZoneId": "Z2SUY0A1719RZT",
"LatestRestorableTime": "2018-06-18T21:17:05.737Z",
"AllocatedStorage": 1,
"Port": 27017,
"Engine": "docdb",
"DBClusterParameterGroup": "default.docdb3.4",
"Endpoint": "sample-cluster.cluster-ctevjxdlur57.us-east-1.rds.amazonaws.com",
"DBSubnetGroup": "default",
"PreferredBackupWindow": "00:00-00:30",
"EngineVersion": "3.4",
"ClusterCreateTime": "2018-06-06T19:25:47.991Z",
"IAMDatabaseAuthenticationEnabled": false
}
}
```
Es dauert einige Minuten, bis Ihre Änderungen übernommen werden. Sie können den Cluster nur verwenden, wenn sein Status *available* ist. Sie können den Status des Clusters über die Konsole oder AWS CLIüberwachen. Weitere Informationen finden Sie unter [Den Status eines Amazon DocumentDB-Clusters überwachen](monitoring_docdb-cluster_status.md).
------
# Ermittlung ausstehender Wartungsarbeiten
Sie können feststellen, ob Sie über die neueste Version der Amazon DocumentDB DocumentDB-Engine verfügen, indem Sie feststellen, ob die Cluster-Wartung noch aussteht.
------
#### [ Using the AWS-Managementkonsole ]
Sie können den verwenden AWS-Managementkonsole , um festzustellen, ob für einen Cluster noch Wartungsarbeiten anstehen.
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Klicken Sie im Navigationsbereich auf **Cluster**.
**Tipp**
Wenn der Navigationsbereich auf der linken Seite des Bildschirms nicht angezeigt wird, wählen Sie links oben auf der Seite das Menüsymbol (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-menu-icon.png)) aus.
1. Überprüfen Sie die Spalte **Maintenance (Wartung)**, um festzustellen, ob ein Cluster eine ausstehende Wartung hat.
![\[Konsolen-Screenshot mit dem Amazon DocumentDB-Cluster-Wartungsfeld.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-cluster-pending-maintenance.png)
**None (Keine)** bedeutet, dass auf dem Cluster die neueste Engine-Version ausgeführt wird. **Available (Verfügbar)** bedeutet, dass der Cluster noch nicht gewartet wurde. Somit ist ein Engine-Upgrade erforderlich.
1. Wenn Ihr Cluster noch nicht gewartet wurde, fahren Sie mit den Schritten unter [Durchführen eines Patch-Updates für die Engine-Version eines Clusters](db-cluster-version-upgrade.md) fort.
------
#### [ Using the AWS CLI ]
Sie können den verwenden AWS CLI , um festzustellen, ob ein Cluster über die neueste Engine-Version verfügt, indem Sie den `describe-pending-maintenance-actions` Vorgang mit den folgenden Parametern verwenden.
**Parameters**
+ **--resource-identifier**— Optional. Der ARN der Ressource (Cluster). Wenn dieser Parameter weggelassen wird, werden ausstehende Wartungsaktionen für alle Cluster aufgelistet.
+ **--region**—Fakultativ. Die AWS-Region, in der Sie diese Operation durchführen möchten (z. B. `us-east-1`).
**Example**
Für Linux, macOS oder Unix:
```
aws docdb describe-pending-maintenance-actions \
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster \
--region us-east-1
```
Für Windows:
```
aws docdb describe-pending-maintenance-actions ^
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
--region us-east-1
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"PendingMaintenanceActionDetails": [
{
"Description": "New feature",
"Action": "db-upgrade",
"ForcedApplyDate": "2019-02-25T21:46:00Z",
"AutoAppliedAfterDate": "2019-02-25T07:41:00Z",
"CurrentApplyDate": "2019-02-25T07:41:00Z"
}
]
}
]
}
```
Wenn Ihr Cluster noch nicht gewartet wurde, fahren Sie mit den Schritten unter [Durchführen eines Patch-Updates für die Engine-Version eines Clusters](db-cluster-version-upgrade.md) fort.
------
# Durchführen eines Patch-Updates für die Engine-Version eines Clusters
In diesem Abschnitt erklären wir, wie Sie ein Patch-Update mit dem AWS-Managementkonsole oder dem bereitstellen AWS CLI. Ein Patch-Update ist ein Update innerhalb derselben Engine-Version (z. B. die Aktualisierung einer 3.6-Engine-Version auf eine neuere 3.6-Engine-Version). Sie können es sofort oder während des nächsten Wartungsfensters Ihres Clusters aktualisieren. Informationen darüber, ob Ihre Engine aktualisiert werden muss, finden Sie unter[Ermittlung ausstehender Wartungsarbeiten](db-cluster-determine-pending-maintenance.md). Bitte beachten Sie, dass es bei der Installation des Updates zu einigen Ausfallzeiten auf Ihrem Cluster kommen kann.
**Anmerkung**
Wenn Sie versuchen, ein Upgrade von einer Hauptversion der Engine auf eine andere durchzuführen, z. B. 3.6 auf 5.0, finden Sie entweder [Direktes Upgrade der Hauptversion von Amazon DocumentDB](docdb-mvu.md) oder[Aktualisieren Ihres Amazon DocumentDB-Clusters mit AWS Database Migration Service](docdb-migration.versions.md). Ein direktes Upgrade der Hauptversion unterstützt nur docdb 5.0 als Ziel-Engine-Version.
Es gibt zwei Konfigurationsanforderungen, um die neuesten Patch-Updates für die Engine-Version eines Clusters zu erhalten:
+ Der Cluster-Status muss *available (verfügbar)* lauten.
+ Der Cluster muss eine ältere Engine-Version ausführen.
------
#### [ Using the AWS-Managementkonsole ]
Das folgende Verfahren wendet mithilfe der Konsole Patch-Updates auf die Engine-Version Ihres Clusters an. Sie haben die Möglichkeit, das Update sofort oder während des nächsten Wartungsfensters Ihres Clusters durchzuführen.
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Klicken Sie im Navigationsbereich auf **Cluster**. Wählen Sie in der Liste der Cluster die Schaltfläche links neben dem Cluster aus, den Sie upgraden möchten. Der Cluster-Status muss *available (verfügbar)* lauten.
**Tipp**
Wenn der Navigationsbereich auf der linken Seite des Bildschirms nicht angezeigt wird, wählen Sie links oben auf der Seite das Menüsymbol (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-menu-icon.png)) aus.
1. Wählen Sie im Menü **Actions (Aktionen)** eine der folgenden Optionen aus. Diese Menüoptionen sind nur auswählbar, wenn der ausgewählte Cluster nicht die neueste Engine-Version ausführt.
![\[Bild: Amazon DocumentDB DocumentDB-Upgrade-Aktionen\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-upgrade-action.png)
+ **Jetzt aktualisieren** — Startet sofort den Upgrade-Vorgang. Ihr Cluster ist eine zeitlang offline, während er auf die neueste Engine-Version aktualisiert wird.
+ **Upgrade im nächsten Fenster** — Initiiert den Upgrade-Vorgang während des nächsten Wartungsfensters des Clusters. Ihr Cluster ist eine zeitlang offline, während er auf die neueste Engine-Version aktualisiert wird.
1. Wenn sich das Bestätigungsfenster öffnet, wählen Sie eine der folgenden Optionen aus:
+ **Upgrade** — Um Ihren Cluster gemäß dem im vorherigen Schritt ausgewählten Zeitplan auf die neueste Engine-Version zu aktualisieren.
+ **Abbrechen** — Um das Engine-Upgrade des Clusters abzubrechen und mit der aktuellen Engine-Version des Clusters fortzufahren.
------
#### [ Using the AWS CLI ]
Sie können Patch-Updates auf Ihren Cluster anwenden, indem Sie den `apply-pending-maintenance-action` Vorgang AWS CLI und mit den folgenden Parametern verwenden.
**Parameters**
+ **--resource-identifier**—Erforderlich. Der ARN des Amazon DocumentDB-Clusters, den Sie aktualisieren möchten.
+ **--apply-action**—Erforderlich. Die folgenden Werte sind zulässig. Verwenden Sie `db-upgrade`, um Ihre Cluster-Engine-Version upzugraden.
+ **db-upgrade**
+ **system-update**
+ **--opt-in-type**—Erforderlich. Die folgenden Werte sind zulässig.
+ `immediate`— Wenden Sie die Wartungsmaßnahme sofort an.
+ `next-maintenance`— Wendet die Wartungsaktion im nächsten Wartungsfenster an.
+ `undo-opt-in`— Stornieren Sie alle bestehenden `next-maintenance` Opt-In-Anfragen.
**Example**
Mit dem folgenden Beispiel-Patch wird die Engine-Version von `sample-cluster` auf Version 4.0.0 aktualisiert.
Für Linux, macOS oder Unix:
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \
--apply-action db-upgrade \
--opt-in-type immediate
```
Für Windows:
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
--apply-action db-upgrade ^
--opt-in-type immediate
```
Die Ausgabe dieser Operation sieht folgendermaßen aus.
```
{
"ResourcePendingMaintenanceActions": {
"ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
"PendingMaintenanceActionDetails": [
{
"CurrentApplyDate": "2019-02-20T20:57:06.904Z",
"Description": "Bug fixes",
"ForcedApplyDate": "2019-02-25T21:46:00Z",
"OptInStatus": "immediate",
"Action": "db-upgrade",
"AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
}
]
}
}
```
------
# Einen Amazon DocumentDB-Cluster stoppen und starten
Das Stoppen und Starten von Amazon DocumentDB-Clustern kann Ihnen helfen, die Kosten für Entwicklungs- und Testumgebungen zu verwalten. Anstatt jedes Mal, wenn Sie Amazon DocumentDB verwenden, Cluster und Instances zu erstellen und zu löschen, können Sie alle Instances in Ihrem Cluster vorübergehend beenden, wenn sie nicht benötigt werden. Sie können sie neu starten, wenn Sie Ihre Tests fortsetzen.
**Topics**
+ [Übersicht über das Stoppen und Starten eines Clusters](#db-cluster-stop-start-overview)
+ [Operationen, die Sie auf einem gestoppten Cluster ausführen können](#db-cluster-stopped-operations)
## Übersicht über das Stoppen und Starten eines Clusters
In Zeiten, in denen Sie keinen Amazon DocumentDB-Cluster benötigen, können Sie alle Instances in diesem Cluster gleichzeitig stoppen. Bei Bedarf können Sie den Cluster jederzeit erneut starten. Durch das Starten und Stoppen werden die Einrichtungs- und Entfernungsvorgänge für Cluster erleichtert, die in der Entwicklung, für Tests oder ähnliche Aktivitäten verwendet werden und keine kontinuierliche Verfügbarkeit erfordern. Sie können einen Cluster mithilfe von AWS-Managementkonsole oder AWS CLI mit einer einzigen Aktion beenden und starten, unabhängig davon, wie viele Instances sich im Cluster befinden.
Während Ihr Cluster gestoppt ist, bleibt des Cluster-Speichervolumen unverändert. Sie zahlen nur für Speicherung, manuelle Snapshots und automatischen Sicherungsspeicher innerhalb des angegebenen Aufbewahrungsfensters. Ihnen werden keine Instance-Stunden in Rechnung gestellt. Amazon DocumentDB startet Ihren Cluster automatisch nach sieben Tagen, sodass er nicht hinter den erforderlichen Wartungsupdates zurückbleibt. Wenn Ihr Cluster nach sieben Tagen wieder startet, werden Ihnen die Instances im Cluster wieder in Rechnung gestellt. Während Ihr Cluster gestoppt ist, können Sie Ihr Speichervolumen nicht abfragen, da die Abfrage erfordert, dass sich Instances im Status „available (verfügbar)“ befinden.
Wenn ein Amazon DocumentDB-Cluster gestoppt wird, können weder der Cluster noch seine Instances in irgendeiner Weise geändert werden. Dies umfasst das Hinzufügen oder Entfernen von Instances oder das Löschen des Clusters.
------
#### [ Using the AWS-Managementkonsole ]
Das folgende Verfahren zeigt, wie Sie einen Cluster mit einer oder mehreren Instances im Status „verfügbar“ stoppen oder einen gestoppten Cluster wieder starten.
**So beenden oder starten Sie einen Amazon DocumentDB-Cluster**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Klicken Sie im Navigationsbereich auf **Cluster**.
**Tipp**
Wenn der Navigationsbereich auf der linken Seite des Bildschirms nicht angezeigt wird, wählen Sie links oben auf der Seite das Menüsymbol (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-menu-icon.png)) aus.
1. Wählen Sie in der Liste der Cluster die Schaltfläche links neben dem Namen des Clusters aus, den Sie stoppen oder starten möchten.
1. Wählen Sie **Aktionen** aus und dann die Aktion, die Sie auf dem Cluster ausführen möchten.
+ Wenn Sie den Cluster stoppen möchten und der Cluster verfügbar ist:
1. Wählen Sie **Beenden** aus.
![\[Bild: Stoppen eines Clusters\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cluster-stop.png)
Damit der Failover-Mechanismus nicht aktiviert wird, werden beim Stoppvorgang zuerst die Replikat-Instances und dann die primäre Instance gestoppt.
1. Wenn Sie den Cluster stoppen möchten, wählen Sie im Bestätigungsdialogfeld **Cluster stoppen** aus und wenn der Cluster weiter ausgeführt werden soll, wählen Sie **Abbrechen** aus.
![\[Bild: Starten eines Clusters\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cluster-stop-confirm.png)
+ Wenn Sie einen gestoppten Cluster starten möchten, wählen Sie **Starten** aus.
![\[Bild: Starten eines Clusters\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cluster-start.png)
1. Überwachen Sie den Status des Clusters und seiner Instances. Wenn Sie den Cluster gestartet haben, können Sie die Ausführung des Clusters fortsetzen, wenn der Cluster und dessen Instances *verfügbar* sind. Weitere Informationen finden Sie unter [Den Status eines Clusters ermitteln](db-cluster-status.md).
![\[Bild: Status von gestoppten und gestarteten Clustern\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cluster-stop-start-status.png)
------
#### [ Using the AWS CLI ]
Die folgenden Codebeispiele zeigen, wie Sie einen Cluster mit einer oder mehreren Instances im Status „verfügbar“ stoppen oder einen gestoppten Cluster starten.
Um einen Cluster mit einer oder mehreren verfügbaren Instances mithilfe von zu beenden AWS CLI, verwenden Sie den Vorgang. `stop-db-cluster` Verwenden Sie die `start-db-cluster`-Operation, um einen gestoppten Cluster zu starten. Beide Operationen verwenden den `--db-cluster-identifier`-Parameter.
**Parameter:**
+ **--db-cluster-identifier**—Erforderlich. Der Name des Clusters, der gestoppt oder gestartet werden soll.
**Example — Um einen Cluster mit dem zu beenden AWS CLI**
Der folgende Code stoppt den Cluster `sample-cluster`. Der Cluster muss eine oder mehrere Instances im verfügbaren Zustand haben.
Für Linux, macOS oder Unix:
```
aws docdb stop-db-cluster \
--db-cluster-identifier sample-cluster
```
Für Windows:
```
aws docdb stop-db-cluster ^
--db-cluster-identifier sample-cluster
```
**Example — Um einen Cluster mit dem zu starten AWS CLI**
Der folgende Code startet den Cluster `sample-cluster`. Der Cluster muss jetzt gestoppt werden.
Für Linux, macOS oder Unix:
```
aws docdb start-db-cluster \
--db-cluster-identifier sample-cluster
```
Für Windows:
```
aws docdb start-db-cluster ^
--db-cluster-identifier sample-cluster
```
------
## Operationen, die Sie auf einem gestoppten Cluster ausführen können
Während ein Amazon DocumentDB-Cluster gestoppt ist, können Sie eine point-in-time Wiederherstellung an einem beliebigen Punkt innerhalb des angegebenen Zeitfensters für die automatische Aufbewahrung von Backups durchführen. Einzelheiten zur Durchführung einer point-in-time Wiederherstellung finden Sie unter[Zu einem bestimmten Zeitpunkt wiederherstellen](backup_restore-point_in_time_recovery.md).
Sie können die Konfiguration eines Amazon DocumentDB-Clusters oder einer seiner Instances nicht ändern, solange der Cluster gestoppt ist. Es ist auch nicht möglich, Instances zum Cluster hinzuzufügen oder daraus zu entfernen oder den Cluster zu löschen, wenn ihm noch Instances zugeordnet sind. Vor solchen administrativen Aktionen müssen Sie den Cluster starten.
Amazon DocumentDB wendet alle geplanten Wartungsarbeiten auf Ihren gestoppten Cluster erst an, nachdem er erneut gestartet wurde. Nach sieben Tagen startet Amazon DocumentDB automatisch einen gestoppten Cluster, sodass er in seinem Wartungsstatus nicht zu weit zurückfällt. Sobald Ihr Cluster neu gestartet wird, werden Ihnen die Instances im Cluster wieder in Rechnung gestellt.
Solange ein Cluster gestoppt ist, führt Amazon DocumentDB keine automatisierten Backups durch und verlängert auch nicht den Aufbewahrungszeitraum für Backups.
# Löschen eines Amazon DocumentDB-Clusters
Sie können einen Amazon DocumentDB-Cluster mit dem AWS-Managementkonsole oder dem AWS CLI löschen. Um einen Cluster zu löschen, muss sich der Cluster im Status *available (verfügbar)* befinden und es dürfen keine Instances mit ihm verknüpft sein. Wenn der Cluster angehalten ist, starten Sie zuerst den Cluster, warten Sie, bis der Cluster *verfügbar* wird, und löschen Sie dann den Cluster. Weitere Informationen finden Sie unter [Einen Amazon DocumentDB-Cluster stoppen und starten](db-cluster-stop-start.md).
## Löschschutz
Zum Schutz Ihrer Cluster vor versehentlichem Löschen, können Sie den *Löschschutz* aktivieren. Wenn Sie mithilfe der Konsole einen Cluster erstellen, ist der Löschschutz standardmäßig aktiviert. Der Löschschutz ist jedoch standardmäßig deaktiviert, wenn Sie einen Cluster über die AWS CLI erstellen.
Amazon DocumentDB erzwingt den Löschschutz für einen Cluster, unabhängig davon, ob Sie den Löschvorgang über die Konsole oder die ausführen. AWS CLI Sie können einen Cluster nicht löschen, solange der Löschschutz aktiviert ist. Um einen Cluster mit aktiviertem Löschschutz zu löschen, müssen Sie zuerst den Cluster ändern und den Löschschutz deaktivieren.
Wenn Sie die Konsole mit aktiviertem Löschschutz für einen Cluster verwenden, können Sie die letzte Instance des Clusters nicht löschen, da dadurch auch der Cluster gelöscht werden würde. Sie können die letzte Instance eines mit Löschschutz geschützten Clusters mit der AWS CLI löschen. In diesen Fall bleibt der Cluster selbst bestehen und die Daten werden beibehalten. Sie können zum Zugriff auf die Daten neue Instances für den Cluster erstellen. Weitere Informationen zum Aktivieren und Deaktivieren des Löschschutzes siehe:
+ [Einen Amazon DocumentDB-Cluster erstellen](db-cluster-create.md)
+ [Ändern eines Amazon DocumentDB-Clusters](db-cluster-modify.md)
------
#### [ Using the AWS-Managementkonsole ]
Um einen Cluster mit dem zu löschen AWS-Managementkonsole, muss der Löschschutz deaktiviert sein.
**So finden Sie heraus, ob der Löschschutz für einen Cluster aktiviert ist:**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Klicken Sie im Navigationsbereich auf **Cluster**.
**Tipp**
Wenn der Navigationsbereich auf der linken Seite des Bildschirms nicht angezeigt wird, wählen Sie links oben auf der Seite das Menüsymbol (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/docdb-menu-icon.png)) aus.
1. Beachten Sie, dass im Cluster-Navigationsfeld in der Spalte **Cluster-ID sowohl Cluster** als auch Instances angezeigt werden. Instances werden unter Clustern aufgeführt, ähnlich wie in der Abbildung unten.
![\[Bild: Das Cluster-Navigationsfeld mit einer Liste der vorhandenen Cluster-Links und der entsprechenden Instanz-Links.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/clusters.png)
1. Wählen Sie den Namen des Clusters und die Registerkarte **Configuration (Konfiguration)** aus. Suchen Sie im Abschnitt **Cluster-Details** die Option **Deletion protection (Löschschutz)**. Wenn der Löschschutz aktiviert ist, bearbeiten Sie den Cluster, um den Löschschutz zu deaktivieren. Informationen über das Ändern eines Clusters finden Sie unter [Ändern eines Amazon DocumentDB-Clusters](db-cluster-modify.md).
Nachdem Sie den **Löschschutz** deaktiviert haben, können Sie den Cluster löschen.
**So löschen Sie einen Cluster:**
1. Klicken Sie im Navigationsbereich auf **Cluster**.
1. Ermitteln Sie, ob der Cluster über Instances verfügt, indem Sie in der Spalte **Cluster-ID** nach den darunter aufgelisteten Instances suchen. Bevor Sie einen Cluster löschen können, müssen Sie alle seine Instances löschen. Weitere Informationen finden Sie unter [Löschen einer Amazon DocumentDB DocumentDB-Instance](db-instance-delete.md).
1. Abhängig davon, ob Ihr Cluster Instances hat oder nicht, führen Sie einen der folgenden Schritte aus:
+ Wenn der Cluster über keine Instances verfügt, wählen Sie die Schaltfläche links neben dem Cluster-Namen und dann **Actions (Aktionen)** aus. Wählen Sie im Dropdown-Menü **Löschen** aus. Füllen Sie das Dialogfeld ** löschen** aus und klicken Sie dann auf **Löschen**.
+ Wenn der Cluster eine oder mehrere Instances hat, gehen Sie wie folgt vor:
1. Klicken Sie im Navigationsbereich auf **Cluster**.
1. Löschen Sie alle Instanzen des Clusters, indem Sie das Kontrollkästchen links neben dem Namen des Clusters aktivieren. Wählen Sie **Actions (Aktionen)** und anschließend **Delete (Löschen)** aus. Füllen Sie das Dialogfeld ** löschen** aus und klicken Sie dann auf **Löschen**.
Wenn Sie die letzte Instanz löschen, wird auch der Cluster gelöscht. Weitere Informationen zum Löschen von Instanzen finden Sie unter[Löschen einer Amazon DocumentDB DocumentDB-Instance](db-instance-delete.md).
Es dauert einige Minuten, bis der Cluster gelöscht ist. Informationen zur Überwachung des Status des Clusters finden Sie unter [Den Status eines Amazon DocumentDB-Clusters überwachen](monitoring_docdb-cluster_status.md).
------
#### [ Using the AWS CLI ]
Sie können einen Cluster, dem Instances zugeordnet sind, nicht löschen. Um festzustellen, welche Instances mit dem Cluster verknüpft sind, führen Sie den Befehl `describe-db-clusters` aus und löschen Sie alle Instances des Clusters. Deaktivieren Sie dann bei Bedarf den Löschschutz auf Ihrem Cluster und löschen Sie schließlich den Cluster.
1. **Löschen Sie zuerst alle Instances des Clusters.**
Um festzustellen, welche Instances Sie löschen müssen, führen Sie den folgenden Befehl aus.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]'
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
Wenn der Cluster, den Sie löschen möchten, Instances enthält, löschen Sie diese wie unten dargestellt.
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance
```
1. **Zweitens deaktivieren Sie den Löschschutz.**
Wenn AWS CLI Sie alle Instanzen eines Clusters löschen, wird der Cluster nicht gelöscht. Sie müssen auch den Cluster löschen, aber dies ist nur möglich, wenn der Löschschutz deaktiviert ist.
Um festzustellen, ob der Löschschutz für den Cluster aktiviert ist, führen Sie den folgenden Befehl aus.
**Tipp**
Um den Löschschutzstatus all Ihrer Amazon DocumentDB-Cluster zu sehen, lassen Sie den `--db-cluster-identifier` Parameter weg.
```
aws docdb describe-db-clusters \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,DeletionProtection]'
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
[
[
"sample-cluster",
"true"
]
]
```
Wenn für einen Cluster der Löschschutz aktiviert ist, bearbeiten Sie den Cluster, um den Löschschutz zu deaktivieren. Führen Sie den folgenden Befehl aus, um den Löschschutz des Clusters zu deaktivieren.
```
aws docdb modify-db-cluster \
--db-cluster-identifier sample-cluster \
--no-deletion-protection \
--apply-immediately
```
1. **Löschen Sie schließlich den Cluster.**
Nachdem Sie den Löschschutz deaktiviert haben, können Sie den Cluster löschen. Um einen Cluster zu löschen, verwenden Sie die `delete-db-cluster`-Operation mit den folgenden Parametern.
+ **--db-cluster-identifier**—Erforderlich. Die ID des Clusters, den Sie löschen möchten.
+ **--final-db-snapshot-identifier**— Fakultativ. Wenn Sie einen endgültigen Snapshot wünschen, müssen Sie diesen Parameter mit einem Namen für den endgültigen Snapshot angeben. Sie müssen entweder `--final-db-snapshot-identifier` oder `--skip-final-snapshot` angeben.
Benennungseinschränkungen:
+ Die Länge beträgt [1—63] Buchstaben, Zahlen oder Bindestriche.
+ Muss mit einem Buchstaben beginnen.
+ Darf nicht mit einem Bindestrich enden oder zwei aufeinanderfolgende Bindestriche enthalten.
+ Muss für alle Cluster in Amazon RDS, Amazon Neptune und Amazon DocumentDB pro AWS-Konto Region eindeutig sein.
+ **--skip-final-snapshot**— Fakultativ. Verwenden Sie diesen Parameter nur, wenn Sie vor dem Löschen Ihres Clusters keinen letzten Snapshot machen möchten. Standardmäßig wird ein letzter Snapshot erstellt. Sie müssen entweder `--final-db-snapshot-identifier` oder `--skip-final-snapshot` angeben.
Der folgende AWS CLI Code löscht den Cluster `sample-cluster` mit einem endgültigen Snapshot. Die Operation schlägt fehl, wenn Instances vorhanden sind, die mit dem Cluster verknüpft sind, oder wenn der Löschschutz aktiviert ist.
**Example**
Für Linux, macOS oder Unix:
```
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--final-db-snapshot-identifier sample-cluster-final-snapshot
```
Für Windows:
```
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--final-db-snapshot-identifier sample-cluster-final-snapshot
```
**Example**
Der folgende AWS CLI Code löscht den Cluster, `sample-cluster` ohne einen endgültigen Snapshot zu erstellen.
Für Linux, macOS oder Unix:
```
aws docdb delete-db-cluster \
--db-cluster-identifier sample-cluster \
--skip-final-snapshot
```
Für Windows:
```
aws docdb delete-db-cluster ^
--db-cluster-identifier sample-cluster ^
--skip-final-snapshot
```
Die Ausgabe der `delete-db-cluster`-Operation ist der Cluster, den Sie löschen.
Es dauert einige Minuten, bis der Cluster gelöscht ist. Informationen zur Überwachung des Status des Clusters finden Sie unter [Den Status eines Clusters überwachen](monitoring_docdb-cluster_status.md).
------
# Skalierung von Amazon DocumentDB-Clustern
Mit Amazon DocumentDB können Sie den Speicher und die Rechenleistung in Ihren Clustern nach Ihren Bedürfnissen skalieren. In diesem Abschnitt wird beschrieben, wie Sie Speicherskalierung, Instanzskalierung und Leseskalierung verwenden können, um die Leistung und Skalierung für Ihre Amazon DocumentDB-Cluster und -Instances zu verwalten.
**Topics**
+ [Speicherskalierung](#db-cluster-manage-scaling-storage)
+ [Skalierung von Instances](#db-cluster-manage-scaling-instance)
+ [Skalierung von Lesevorgängen](#db-cluster-manage-scaling-reads)
+ [Skalierung schreiben](#db-cluster-manage-scaling-writes)
## Speicherskalierung
Der Amazon DocumentDB DocumentDB-Speicher wird automatisch mit den Daten in Ihrem Cluster-Volume skaliert. Wenn Ihre Daten wachsen, wächst Ihr Cluster-Volumenspeicher in Schritten von 10 GiB auf bis zu 128 TiB.
## Skalierung von Instances
Sie können Ihren Amazon DocumentDB-Cluster nach Bedarf skalieren, indem Sie die Instance-Klasse für jede Instance im Cluster ändern. Amazon DocumentDB unterstützt mehrere Instance-Klassen, die für Amazon DocumentDB optimiert sind.
Weitere Informationen finden Sie unter [Ändern einer Amazon DocumentDB DocumentDB-Instance](db-instance-modify.md).
## Skalierung von Lesevorgängen
Sie können die Leseskalierung für Ihren Amazon DocumentDB-Cluster erreichen, indem Sie bis zu 15 Amazon DocumentDB DocumentDB-Replikate im Cluster erstellen. Jedes Amazon DocumentDB DocumentDB-Replikat gibt dieselben Daten aus dem Cluster-Volume mit minimaler Replikatverzögerung zurück — normalerweise weniger als 100 Millisekunden, nachdem die primäre Instance ein Update geschrieben hat. Wenn Ihr Lesedatenverkehr zunimmt, können Sie zusätzliche Amazon DocumentDB DocumentDB-Replikate erstellen und sich direkt mit ihnen verbinden, um die Leselast für Ihren Cluster zu verteilen. Amazon DocumentDB DocumentDB-Replikate müssen nicht derselben Instance-Klasse angehören wie die primäre Instance.
Weitere Informationen finden Sie unter [Hinzufügen einer Amazon DocumentDB DocumentDB-Instance zu einem Cluster](db-instance-add.md).
Um den Lesesatz mit Amazon DocumentDB zu nutzen, empfehlen wir, dass Sie eine Verbindung zu Ihrem Cluster als Replikatsatz herstellen und Lesevorgänge mithilfe der integrierten Leseeinstellungen Ihres Treibers an Replikatinstanzen verteilen. Weitere Informationen finden Sie unter [Als Replikatsatz eine Verbindung zu Amazon DocumentDB herstellen](connect-to-replica-set.md).
## Skalierung schreiben
Sie können die Schreibkapazität in Ihrem Amazon DocumentDB-Cluster skalieren, indem Sie die Größe der primären Instance Ihres Clusters erhöhen. In diesem Abschnitt werden zwei Methoden für die Skalierung der primären Instance Ihres Clusters abhängig von Ihren Anforderungen beschrieben. Die erste Option zielt darauf ab, die Auswirkungen auf die Anwendung so gering wie möglich zu halten, erfordert jedoch mehr Schritte. Die zweite Option ermöglicht Ihnen die Optimierung in Bezug auf die Einfachheit, da sie weniger Schritte erfordert. Die potenziellen Auswirkungen auf Anwendungen sind jedoch größer.
Abhängig von Ihrer Anwendung können Sie wählen, welcher Ansatz für Sie am besten geeignet ist. Weitere Informationen zu verfügbaren Instance-Größen und Kosten finden Sie auf der Seite mit den [Amazon DocumentDB DocumentDB-Preisen](https://aws.amazon.com/documentdb/pricing/).
1. **Optimieren Sie für hohe Verfügbarkeit und Leistung** — Wenn Sie im [Replica-Set-Modus](connect-to-replica-set.md) (empfohlen) eine Verbindung zu Ihrem Cluster herstellen, können Sie den folgenden Prozess verwenden, um die Auswirkungen auf Ihre Anwendung bei der Skalierung Ihrer primären Instance zu minimieren. Diese Methode minimiert die Auswirkungen, da Ihr Cluster den von Ihnen festgelegten Wert für Hochverfügbarkeit weiter einhält oder überschreitet. Darüber hinaus werden Leseskalierungsziele dem Cluster als Instances hinzugefügt, anstatt an Ort und Stelle aktualisiert zu werden.
1. Fügen Sie ein oder mehrere Replikate des größeren Instance-Typs zu Ihrem Cluster hinzu (siehe [Hinzufügen einer Amazon DocumentDB DocumentDB-Instance zu einem Cluster](db-instance-add.md)). Alle Replikate sollten einen Instance-Typ besitzen, der größer oder gleich dem Typ der primären Instance ist. Dies vermeidet eine unbeabsichtigte Reduzierung der Schreibleistung aufgrund eines Failovers zu einem kleineren Instance-Typ. Für die meisten Kunden bedeutet dies, dass die Anzahl der Instances in ihrem Cluster vorübergehend verdoppelt wird und die kleineren Replikate nach Abschluss der Skalierung entfernt werden.
1. Legen Sie die Failover-Stufe für alle neuen Replikate auf die Priorität Null fest. Dies stellt sicher, dass ein Replikat des kleineren Instance-Typs die höchste Failover-Priorität besitzt. Weitere Informationen finden Sie unter [Steuerung des Failover-Ziels](failover.md#failover-target_control).
1. Initiieren Sie einen manuellen Failover. Hierdurch wird eines der neuen Replikate zur primären Instance hochgestuft. Weitere Informationen finden Sie unter [Testen eines Failovers](failover.md#failover-testing).
**Anmerkung**
Dies führt zu einer Ausfallzeit von ca. 30 Sekunden für Ihren Cluster. Bitte planen Sie entsprechend.
1. Entfernen Sie aus dem Cluster alle Replikate von Instance-Typen, die kleiner als der neue primäre Instance-Typ sind.
1. Setzen Sie die Failover-Stufe aller Instances auf dieselbe Priorität zurück. (In der Regel bedeutet dies, dass sie auf 1 zurückgesetzt werden.)
Angenommen, Sie führen einen Cluster aus, der zurzeit drei `r5.large`-Instances enthält (eine primäre Instance und zwei Replikate). Sie möchten diese Instances auf den Instance-Typ `r5.xlarge` skalieren. Hierzu fügen Sie dem Cluster zunächst drei `r5.xlarge`-Replikat-Instances hinzu und legen anschließend die Failover-Stufe der neuen `r5.xlarge`-Replikate auf null fest. Als Nächstes leiten Sie einen manuellen Failover ein. (Ihnen ist bekannt, dass dies zu einer Ausfallzeit von ca. 30 Sekunden für Ihre Anwendung führt.) Nach Abschluss des Failovers entfernen Sie alle drei `r5.large`-Instances aus dem Cluster. Der Cluster ist nun auf `r5.xlarge`-Instances skaliert.
Um die Kosten zu optimieren, werden Amazon DocumentDB DocumentDB-Instances in Sekundenschritten abgerechnet, wobei eine Mindestgebühr von zehn Minuten nach einer Änderung des fakturierbaren Status, z. B. beim Erstellen, Ändern oder Löschen einer Instance, anfällt. Weitere Informationen finden Sie unter [Kostenoptimierung](best_practices.md#best_practices-cost_optimization) in der Dokumentation zu bewährten Methoden.
1. Aus **Gründen der Einfachheit optimieren** — Dieser Ansatz ist aus Gründen der Einfachheit optimiert. Dadurch wird der Cluster nicht erweitert und verkleinert, aber es kann Ihre Lesekapazität vorübergehend reduzieren.
Es ist möglich, dass das Ändern der Instanzklasse eines Replikats dazu führt, dass diese Instanz für einen kurzen Zeitraum, von einigen Sekunden bis weniger als 30 Sekunden, keine Anfragen bearbeitet. Wenn Sie im [Replikat-Set-Modus](connect-to-replica-set.md) (empfohlen) eine Verbindung zu Ihrem Cluster herstellen, würde dies Ihre Lesekapazität während des Skalierungsvorgangs um ein Replikat reduzieren (z. B. auf 66% Kapazität in einem 3-Knoten-Cluster oder 75% Kapazität in einem 4-Knoten-Cluster usw.).
1. Skalieren Sie eine der Replikatinstanzen in Ihrem Cluster. Weitere Informationen finden Sie unter [Instanzklassen verwalten](db-instance-classes.md).
1. Warten Sie, bis die Instanz verfügbar ist (siehe[Den Status einer Amazon DocumentDB DocumentDB-Instance überwachen](monitoring_docdb-instance_status.md)).
**Anmerkung**
Dies führt zu einer Ausfallzeit von ca. 30 Sekunden für Ihren Cluster. Bitte planen Sie entsprechend.
1. Fahren Sie mit der Ausführung der Schritte 1 und 2 fort, bis alle Replikatinstanzen nacheinander skaliert wurden.
1. Initiieren Sie ein manuelles Failover. Dadurch wird eines der Replikate zur primären Instanz heraufgestuft. Weitere Informationen finden Sie unter [Amazon DocumentDB-Failover](failover.md).
**Anmerkung**
Dies führt zu Ausfallzeiten von bis zu 30 Sekunden für Ihren Cluster, dauert aber oft weniger Zeit. Bitte planen Sie entsprechend.
1. Skalieren Sie die frühere primäre Instanz (jetzt ein Replikat).
# Klonen eines Volumes für einen Amazon DocumentDB-Cluster
Durch das Klonen von Amazon DocumentDB können Sie einen neuen Cluster erstellen, der dasselbe Amazon DocumentDB-Cluster-Volume verwendet und dieselben Daten wie das Original hat. Der Prozess ist so konzipiert, dass er schnell und kostengünstig ist. Der neue Cluster mit dem zugehörigen Datenvolume wird als *clone* (Klon) bezeichnet. Das Erstellen eines Klons ist schneller und platzsparender als das physische Kopieren der Daten mit anderen Techniken, wie z. B. das Wiederherstellen eines Snapshots.
Amazon DocumentDB unterstützt die Erstellung eines von Amazon DocumentDB bereitgestellten Klons aus einem bereitgestellten Amazon DocumentDB-Cluster. Wenn Sie einen Clone mit einer anderen Bereitstellungskonfiguration als der Quelle erstellen, wird der Clone mit der neuesten Version der Amazon DocumentDB DocumentDB-Engine der Quelle erstellt.
Wenn Sie Klone aus Ihren Amazon DocumentDB-Clustern erstellen, werden die Klone in Ihrem Konto erstellt AWS — demselben Konto, dem der Amazon DocumentDB DocumentDB-Quellcluster gehört.
**Topics**
+ [Überblick über das Klonen von Amazon DocumentDB](#db-cloning-overview)
+ [Einschränkungen beim Klonen von Amazon DocumentDB](#db-cloning-limitations)
+ [So funktioniert das Klonen von Amazon DocumentDB](#db-how-db-cloning-works)
+ [Einen Amazon DocumentDB-Klon erstellen](#db-creating-db-clone)
## Überblick über das Klonen von Amazon DocumentDB
Amazon DocumentDB verwendet ein *copy-on-write Protokoll*, um einen Klon zu erstellen. Dieser Mechanismus verwendet minimalen zusätzlichen Speicherplatz, um einen ersten Klon zu erstellen. Wenn der Klon zum ersten Mal erstellt wird, behält Amazon DocumentDB eine einzige Kopie der Daten, die vom Quell-DB-Cluster und dem neuen (geklonten) Amazon DocumentDB-Cluster verwendet werden. Zusätzlicher Speicherplatz wird nur zugewiesen, wenn Änderungen an Daten (auf dem Amazon DocumentDB-Speichervolume) durch den Amazon DocumentDB-Quellcluster oder den Amazon DocumentDB-Cluster-Klon vorgenommen werden. Weitere Informationen über das copy-on-write Protokoll finden Sie unter. [So funktioniert das Klonen von Amazon DocumentDB](#db-how-db-cloning-works)
Das Klonen von Amazon DocumentDB ist besonders nützlich, um schnell Testumgebungen mit Ihren Produktionsdaten einzurichten, ohne das Risiko einer Datenbeschädigung einzugehen. Sie können Klone für viele Arten von Anwendungen verwenden, z. B. für Folgende:
+ Experimentieren Sie mit möglichen Änderungen (z. B. Schemaänderungen und Parametergruppenänderungen), um alle Auswirkungen zu bewerten.
+ Führen Sie Workload-intensive Vorgänge aus, z. B. das Exportieren von Daten oder das Ausführen analytischer Abfragen auf dem Klon.
+ Erstellen Sie eine Kopie Ihres Produktions-DB-Clusters zu Entwicklungs-, Test- oder anderen Zwecken.
Sie können mehr als einen Klon aus demselben Amazon DocumentDB-Cluster erstellen. Sie können auch mehrere Klone aus einem anderen Klon erstellen.
Nachdem Sie einen Amazon DocumentDB-Klon erstellt haben, können Sie die Amazon DocumentDB DocumentDB-Instances anders konfigurieren als der Amazon DocumentDB DocumentDB-Quellcluster. Beispielsweise benötigen Sie möglicherweise keinen Klon für Entwicklungszwecke, um dieselben Hochverfügbarkeitsanforderungen wie der Amazon DocumentDB DocumentDB-Quellproduktionscluster zu erfüllen. In diesem Fall können Sie den Clone mit einer einzigen Amazon DocumentDB-Instance statt mit mehreren DB-Instances konfigurieren, die vom Amazon DocumentDB-Cluster verwendet werden.
Wenn Sie den Klon für Test-, Entwicklungs- oder andere Zwecke nicht mehr verwenden, können Sie ihn löschen.
## Einschränkungen beim Klonen von Amazon DocumentDB
Amazon DocumentDB; für das Klonen gelten derzeit die folgenden Einschränkungen:
+ Sie können so viele Klone erstellen, wie Sie möchten, bis zur maximalen Anzahl von DB-Clustern, die in der AWS-Region zulässig sind. Nachdem Sie jedoch 15 Klone erstellt haben, ist der nächste Klon eine vollständige Kopie. Der Klonvorgang funktioniert wie eine Wiederherstellung. point-in-time
+ Sie können keinen Clone in einer anderen AWS Region als dem Amazon DocumentDB DocumentDB-Quellcluster erstellen.
+ Sie können keinen Clone aus einem Amazon DocumentDB-Cluster erstellen, der keine DB-Instances hat. Sie können nur Amazon DocumentDB-Cluster klonen, die über mindestens eine DB-Instance verfügen.
+ Sie können einen Clone in einer anderen Virtual Private Cloud (VPC) als der des Amazon DocumentDB-Clusters erstellen. Wenn Sie dies tun, VPCs müssen die Subnetze von denselben Availability Zones zugeordnet werden.
## So funktioniert das Klonen von Amazon DocumentDB
Das Klonen von Amazon DocumentDB funktioniert auf der Speicherebene eines Amazon DocumentDB-Clusters. Es verwendet ein *copy-on-write*Protokoll, das sowohl schnell als auch platzsparend ist, was die zugrunde liegenden dauerhaften Medien angeht, die das Amazon DocumentDB DocumentDB-Speichervolumen unterstützen. Weitere Informationen zu Amazon DocumentDB-Cluster-Volumes finden Sie unter[Verwaltung von Amazon DocumentDB-Clustern](db-clusters.md).
**Topics**
+ [Das Protokoll verstehen copy-on-write](#db-copy-on-write-protocol)
+ [Löschen eines Quell-Cluster-Volumes](#db-deleting-source-cluster-volume)
### Das Protokoll verstehen copy-on-write
Ein Amazon DocumentDB-Cluster speichert Daten in Seiten auf dem zugrunde liegenden Amazon DocumentDB DocumentDB-Speichervolume.
Im folgenden Diagramm finden Sie beispielsweise einen Amazon DocumentDB-Cluster (A) mit vier Datenseiten, 1, 2, 3 und 4. Stellen Sie sich vor, dass ein Klon, B, aus dem Amazon DocumentDB-Cluster erstellt wird. Wenn der Klon erstellt wird, werden keine Daten kopiert. Vielmehr verweist der Klon auf denselben Seitensatz wie der Amazon DocumentDB DocumentDB-Quellcluster.
![\[Amazon DocumentDB-Cluster-Volume mit 4 Seiten für Quell-Cluster A und Clone B\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-1.png)
Wenn der Klon erstellt wird, ist normalerweise kein zusätzlicher Speicher erforderlich. Das copy-on-write Protokoll verwendet dasselbe Segment auf dem physischen Speichermedium wie das Quellsegment. Zusätzlicher Speicher ist nur erforderlich, wenn die Kapazität des Quellsegments für das gesamte Klonsegment nicht ausreicht. Wenn dies der Fall ist, wird das Quellsegment auf ein anderes physisches Gerät kopiert.
In den folgenden Diagrammen finden Sie ein Beispiel für das copy-on-write Protokoll in Aktion, das denselben Cluster A und seinen Klon B verwendet, wie oben gezeigt. Nehmen wir an, Sie nehmen eine Änderung an Ihrem Amazon DocumentDB-Cluster (A) vor, die zu einer Änderung der auf Seite 1 gespeicherten Daten führt. Anstatt auf die ursprüngliche Seite 1 zu schreiben, erstellt Amazon DocumentDB eine neue Seite 1 [A]. Das Amazon DocumentDB-Cluster-Volume für Cluster (A) verweist jetzt auf die Seiten 1 [A], 2, 3 und 4, während der Klon (B) immer noch auf die Originalseiten verweist.
![\[Amazon DocumentDB DocumentDB-Quell-DB-Cluster-Volume und sein Klon, beide mit Änderungen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-2.png)
Auf dem Klon wird eine Änderung an Seite 4 auf dem Speichervolume vorgenommen. Anstatt auf die ursprüngliche Seite 4 zu schreiben, erstellt Amazon DocumentDB eine neue Seite, 4 [B]. Der Klon verweist nun auf die Seiten 1, 2, 3 und auf Seite 4[B], während der Cluster (A) weiterhin auf 1[A], 2, 3 und 4 verweist.
![\[Amazon DocumentDB DocumentDB-Quell-DB-Cluster-Volume und sein Klon, beide mit Änderungen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-3.png)
Da im Laufe der Zeit immer mehr Änderungen sowohl im Amazon DocumentDB DocumentDB-Quell-Cluster-Volume als auch im Clone vorgenommen werden, wird mehr Speicherplatz benötigt, um die Änderungen zu erfassen und zu speichern.
### Löschen eines Quell-Cluster-Volumes
Wenn Sie ein Quell-Cluster-Volume löschen, dem ein oder mehrere Klone zugeordnet sind, sind die Klone nicht betroffen. Die Klone verweisen weiter auf die Seiten, die zuvor im Besitz des Quell-Cluster-Volumes waren.
## Einen Amazon DocumentDB-Klon erstellen
Sie können einen Clone in demselben AWS Konto wie der Amazon DocumentDB DocumentDB-Quellcluster erstellen. Dazu können Sie das AWS-Managementkonsole oder das AWS CLI und die folgenden Verfahren verwenden.
Mithilfe von Amazon DocumentDB-Cloning können Sie einen bereitgestellten Amazon DocumentDB-Cluster-Klon aus einem bereitgestellten Amazon DocumentDB-Cluster erstellen.
------
#### [ Using the AWS-Managementkonsole ]
Das folgende Verfahren beschreibt, wie Sie einen Amazon DocumentDB-Cluster mit dem AWS-Managementkonsole klonen.
Erstellen eines Klons anhand der AWS-Managementkonsole Ergebnisse in einem Amazon DocumentDB-Cluster mit einer Amazon DocumentDB DocumentDB-Instance.
Diese Anweisungen gelten für DB-Cluster, die demselben AWS Konto gehören, das den Klon erstellt. Der DB-Cluster muss demselben AWS Konto gehören, da kontoübergreifendes Klonen in Amazon DocumentDB nicht unterstützt wird.
**Um einen Klon eines DB-Clusters zu erstellen, der Ihrem AWS Konto gehört, verwenden Sie AWS-Managementkonsole**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Klicken Sie im Navigationsbereich auf **Cluster**.
1. Wählen Sie Ihren Amazon DocumentDB-Cluster aus der Liste aus und wählen Sie für **Aktionen** die Option **Create clone** aus.
![\[Die Erstellung eines Klons beginnt mit der Auswahl Ihres Amazon DocumentDB-Clusters.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cloning-create-clone-1.png)
Die Seite „Clone erstellen“ wird geöffnet, auf der Sie eine **Cluster-ID** und eine **Instance-Klasse** sowie andere Optionen für den Amazon DocumentDB-Cluster-Klon konfigurieren können.
1. Gehen Sie im Abschnitt **Settings** (Einstellungen) wie folgt vor:
1. Geben Sie **unter Cluster-ID** den Namen ein, den Sie Ihrem geklonten Amazon DocumentDB-Cluster geben möchten.
1. Wählen Sie für die **Instance-Konfiguration** eine geeignete **Instance-Klasse** für Ihren geklonten Amazon DocumentDB-Cluster aus.
![\[Die Erstellung eines Klons beginnt mit der Auswahl Ihres Amazon DocumentDB-Clusters und der Angabe einer DB-Instance-Größe.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cloning-create-clone-2.png)
1. Wählen Sie für **Netzwerkeinstellungen** eine **Subnetzgruppe** für Ihren Anwendungsfall und die zugehörigen VPC-Sicherheitsgruppen aus.
1. Wenn für **E ncryption-at-rest** die Verschlüsselung für den Quellcluster (der Cluster, der geklont wird) aktiviert ist, muss auch für den geklonten Cluster die Verschlüsselung aktiviert sein. Wenn dieses Szenario zutrifft, sind die Optionen **Verschlüsselung aktivieren** ausgegraut (deaktiviert), aber die Option **Verschlüsselung aktivieren** ist ausgewählt. Umgekehrt, wenn für den Quellcluster keine Verschlüsselung aktiviert ist, sind die Optionen **Verschlüsselung aktivieren** verfügbar und Sie können wählen, ob die Verschlüsselung aktiviert oder deaktiviert werden soll.
![\[Geben Sie die Netzwerk- und Verschlüsselungseinstellungen für Ihren Amazon DocumentDB-Cluster-Klon an.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cloning-create-clone-3-nw-encryption.png)
1. Vervollständigen Sie die neue Cluster-Clone-Konfiguration, indem Sie den Typ der zu exportierenden Protokolle auswählen (optional), einen bestimmten Port eingeben, der für die Verbindung mit dem Cluster verwendet wird, und den Schutz vor versehentlichem Löschen des Clusters aktivieren (standardmäßig aktiviert).
![\[Vervollständigen Sie die neue Clone-Konfiguration, indem Sie optional den Typ der zu exportierenden Protokolle, einen bestimmten Port für die Verbindung mit dem Cluster und den Schutz vor versehentlichem Löschen des Clusters auswählen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cloning-create-clone-4-log-options-del-prot-b.png)
1. Beenden Sie die Eingabe aller Einstellungen für Ihren Amazon DocumentDB-Cluster-Klon. Weitere Informationen zu den Cluster- und Instance-Einstellungen von Amazon DocumentDB finden Sie unter[Verwaltung von Amazon DocumentDB-Clustern](db-clusters.md).
1. Wählen Sie **Create clone**, um den Amazon DocumentDB-Klon Ihres ausgewählten Amazon DocumentDB-Clusters zu starten.
Wenn der Klon erstellt wurde, wird er zusammen mit Ihren anderen Amazon DocumentDB-Clustern im Bereich **Datenbanken** der Konsole aufgeführt und zeigt seinen aktuellen Status an. Ihr Klon ist einsatzbereit, wenn sein Status **Verfügbar** ist.
------
#### [ Using the AWS CLI ]
Die Verwendung des AWS CLI zum Klonen Ihres Amazon DocumentDB-Clusters umfasst einige Schritte.
Der `restore-db-cluster-to-point-in-time` AWS CLI Befehl, den Sie verwenden, führt zu einem leeren Amazon DocumentDB-Cluster mit 0 Amazon DocumentDB DocumentDB-Instances. Das heißt, der Befehl stellt nur den Amazon DocumentDB-Cluster wieder her, nicht die DB-Instances für diesen Cluster. Sie tun dies separat, nachdem der Klon verfügbar ist. Die zwei Schritte im Prozess sind wie folgt:
1. Erstellen Sie den Klon mit dem Befehl [restore-db-cluster-to- point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI. Die Parameter, die Sie mit diesem Befehl verwenden, steuern den Kapazitätstyp und andere Details des leeren Amazon DocumentDB-Clusters (Klons), der erstellt wird.
1. Erstellen Sie die Amazon DocumentDB-Instance für den Clone, indem Sie den [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI-Befehl verwenden, um die Amazon DocumentDB DocumentDB-Instance im wiederhergestellten Amazon DocumentDB-Cluster neu zu erstellen.
Bei den folgenden Befehlen AWS CLI wird davon ausgegangen, dass Ihre AWS Region standardmäßig eingerichtet ist. Dieser Ansatz erspart Ihnen die Übergabe des `--region`-Namens in jedem der Befehle. Weitere Informationen finden Sie unter [Konfigurieren der AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html). Sie können die `--region` auch in jedem der folgenden CLI-Befehle angeben.
**Topics**
**Der Klon wird erstellt**
Die spezifischen Parameter, die Sie an den `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)`-CLI-Befehl übergeben, variieren. Was Sie übergeben, hängt von der Art des Klons ab, den Sie erstellen möchten.
Gehen Sie wie folgt vor, um einen bereitgestellten Amazon DocumentDB-Klon aus einem bereitgestellten Amazon DocumentDB-Cluster zu erstellen.
**Um einen Klon desselben Engine-Modus wie der Amazon DocumentDB DocumentDB-Quellcluster zu erstellen**
+ Verwenden Sie den `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)`-CLI-Befehl und geben Sie Werte für die folgenden Parameter an:
+ `--db-cluster-identifier` – Wählen Sie einen aussagekräftigen Namen für Ihren Klon. Sie geben dem Klon einen Namen, wenn Sie den Befehl [restore-db-cluster-to- point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI verwenden.
+ `--restore-type` – Verwenden Sie `copy-on-write`, um einen Klon des Quell-DB-Clusters zu erstellen. Ohne diesen Parameter `restore-db-cluster-to-point-in-time` stellt der den Amazon DocumentDB-Cluster wieder her, anstatt einen Klon zu erstellen. Die Standardeinstellung für `restore-type` ist`full-copy`.
+ `--source-db-cluster-identifier`— Verwenden Sie den Namen des Amazon DocumentDB DocumentDB-Quellclusters, den Sie klonen möchten.
+ `--use-latest-restorable-time` – Dieser Wert verweist auf die neuesten wiederherstellbaren Volume-Daten für den Klon. Dieser Parameter ist erforderlich für`restore-type copy-on-write`, Sie können den jedoch nicht `restore-to-time parameter` zusammen verwenden.
Im folgenden Beispiel wird ein Klon namens `my-clone` aus einem Cluster namens `my-source-cluster` erstellt.
Für Linux, macOS oder Unix:
```
aws docdb restore-db-cluster-to-point-in-time \
--source-db-cluster-identifier my-source-cluster \
--db-cluster-identifier my-clone \
--restore-type copy-on-write \
--use-latest-restorable-time
```
Für Windows:
```
aws docdb restore-db-cluster-to-point-in-time ^
--source-db-cluster-identifier my-source-cluster ^
--db-cluster-identifier my-clone ^
--restore-type copy-on-write ^
--use-latest-restorable-time
```
Der Befehl gibt das JSON-Objekt zurück, das Details des Klons enthält. Stellen Sie sicher, dass Ihr geklonter DB-Cluster verfügbar ist, bevor Sie versuchen, die DB-Instance für Ihren Klon zu erstellen. Weitere Informationen finden Sie weiter unten unter Status überprüfen und Details zum Klonen abrufen:
**Status überprüfen und Details zum Klonen abrufen**
Mit dem folgenden Befehl können Sie den Status Ihres neu erstellten leeren DB-Clusters überprüfen.
```
$ aws docdb describe-db-clusters --db-cluster-identifier my-clone --query '*[].[Status]' --output text
```
Oder Sie können den Status und die anderen Werte, die Sie zum Erstellen der DB-Instance für Ihren Clone benötigen, mithilfe der folgenden AWS CLI Abfrage abrufen:
Für Linux, macOS oder Unix:
```
aws docdb describe-db-clusters --db-cluster-identifier my-clone \
--query '*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}'
```
Für Windows:
```
aws docdb describe-db-clusters --db-cluster-identifier my-clone ^
--query "*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}"
```
Diese Abfrage gibt eine Ausgabe ähnlich der folgenden zurück.
```
[
{
"Status": "available",
"Engine": "docdb",
"EngineVersion": "4.0.0",
}
]
```
**Erstellen der Amazon DocumentDB DocumentDB-Instance für Ihren Clone**
Verwenden Sie den [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI-Befehl, um die DB-Instance für Ihren Clone zu erstellen.
Der `--db-instance-class` Parameter wird nur für bereitgestellte Amazon DocumentDB-Cluster verwendet.
Für Linux, macOS oder Unix:
```
aws docdb create-db-instance \
--db-instance-identifier my-new-db \
--db-cluster-identifier my-clone \
--db-instance-class db.r5.4xlarge \
--engine docdb
```
Für Windows:
```
aws docdb create-db-instance ^
--db-instance-identifier my-new-db ^
--db-cluster-identifier my-clone ^
--db-instance-class db.r5.4xlarge ^
--engine docdb
```
**Parameter, die für das Klonen verwendet werden sollen**
In der folgenden Tabelle sind die verschiedenen Parameter zusammengefasst, die zum Klonen von Amazon DocumentDB-Clustern verwendet werden. `restore-db-cluster-to-point-in-time`
| Parameter | Description |
| --- | --- |
| --source-db-cluster-identifier | Verwenden Sie den Namen des Amazon DocumentDB DocumentDB-Quellclusters, den Sie klonen möchten. |
| --db-cluster-identifier | Wählen Sie einen aussagekräftigen Namen für Ihren Klon. Sie benennen Ihren Klon mit dem ` restore-db-cluster-to-point-in-time`-Befehl. Dann übergeben Sie diesen Namen an den `create-db-instance`-Befehl. |
| --restore-type | Geben Sie `copy-on-write` als an`--restore-type`, um einen Klon des Quell-DB-Clusters zu erstellen, anstatt den Amazon DocumentDB DocumentDB-Quellcluster wiederherzustellen. |
| --use-latest-restorable-time | ieser Wert verweist auf die neuesten wiederherstellbaren Volume-Daten für den Klon. |
------
# Grundlegendes zur Amazon DocumentDB-Cluster-Fehlertoleranz
Amazon DocumentDB-Cluster sind von Natur aus fehlertolerant. Das Volume jedes Clusters erstreckt sich über mehrere Availability Zones in einem einzigen AWS-Region, und jede Availability Zone enthält eine Kopie der Volume-Daten des Clusters. Diese Funktionalität bedeutet, dass Ihr Cluster einen Ausfall der Availability Zone ohne Datenverlust und nur eine kurze Unterbrechung des Services tolerieren kann.
Wenn die primäre Instance in einem Cluster ausfällt, führt Amazon DocumentDB auf zwei Arten automatisch einen Failover zu einer neuen primären Instance durch:
+ Indem Sie ein vorhandenes Amazon DocumentDB DocumentDB-Replikat auf die neue primäre Instance heraufstufen, die auf der Grundlage der Promotion-Kontingent-Einstellung für jedes Replikat ausgewählt wurde, und dann einen Ersatz für die frühere primäre Instance erstellen. Ein Failover zur Replikat-Instance dauert in der Regel weniger als 30 Sekunden. Während dieses Zeitraums kann es bei Lese- und Schreibvorgängen zu kurzen Unterbrechungen kommen. Um die Verfügbarkeit Ihres Clusters zu erhöhen, empfehlen wir Ihnen, mindestens ein oder mehrere Amazon DocumentDB DocumentDB-Replikate in zwei oder mehr verschiedenen Availability Zones zu erstellen.
+ Über das Anlegen einer neuen primären Instance. Dies passiert nur, wenn Sie keine Replikatinstanz in Ihrem Cluster haben und es kann einige Minuten dauern, bis der Vorgang abgeschlossen ist.
Wenn der Cluster über ein oder mehrere Amazon DocumentDB DocumentDB-Replikate verfügt, wird ein Amazon DocumentDB DocumentDB-Replikat bei einem Ausfall zur primären Instance heraufgestuft. Ein Fehlerereignis hat eine kurze Unterbrechung zufolge, während die Lese- und Schreibvorgänge mit einer Ausnahme fehlschlagen. Jedoch wird der Service im Normalfall in weniger als 120 Sekunden und oft sogar schon nach 60 Sekunden wiederhergestellt. Um die Verfügbarkeit Ihres Clusters zu erhöhen, empfehlen wir Ihnen, mindestens ein oder mehrere Amazon DocumentDB DocumentDB-Replikate in zwei oder mehr verschiedenen Availability Zones zu erstellen.
Sie können die Reihenfolge anpassen, in der Ihre Amazon DocumentDB DocumentDB-Replikate nach einem Ausfall zur primären Instance heraufgestuft werden, indem Sie jedem Replikat eine Priorität zuweisen. Prioritäten liegen im Bereich zwischen 0 als höchste Priorität und 15 als niedrigste Priorität. Wenn die primäre Instance ausfällt, wird das Amazon DocumentDB DocumentDB-Replikat mit der höchsten Priorität zur neuen primären Instance heraufgestuft. Sie können die Priorität eines Amazon DocumentDB DocumentDB-Replikats jederzeit ändern. Das Ändern der Priorität löst kein Failover aus. Sie können die `modify-db-instance`-Operation mit dem `--promotion-tier`-Parameter verwenden. Weitere Informationen zum Anpassen der Failover-Priorität einer Instance finden Sie unter [Amazon DocumentDB-Failover](failover.md).
Mehr als ein Amazon DocumentDB DocumentDB-Replikat kann dieselbe Priorität haben, was zu Aktionsstufen führt. Wenn zwei oder mehr Amazon DocumentDB DocumentDB-Replikate dieselbe Priorität haben, wird das Replikat mit der größten Größe zum primären Replikat heraufgestuft. Wenn zwei oder mehr Amazon DocumentDB DocumentDB-Replikate dieselbe Priorität und Größe haben, wird ein beliebiges Replikat in derselben Promotion-Stufe heraufgestuft.
Wenn der Cluster keine Amazon DocumentDB DocumentDB-Replikate enthält, wird die primäre Instance bei einem Ausfall neu erstellt. Ein Fehlerereignis hat eine Unterbrechung zufolge, während die Lese- und Schreibvorgänge mit einer Ausnahme fehlschlagen. Der Service wird wiederhergestellt, wenn die primäre Instance erstellt wird. Dies dauert im Normalfall weniger als 10 Minuten. Das Heraufstufen eines Amazon DocumentDB-Replikats zur primären Instance ist viel schneller als das Erstellen einer neuen primären Instance.