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.
# 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).
------