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 elastischer Amazon DocumentDB-Cluster
Um einen elastischen 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 es Ihnen, Cluster zu erstellen, zu ändern und zu löschen. Die Amazon Document DBFull Access-Richtlinie bietet alle erforderlichen Berechtigungen für die Verwaltung eines elastischen Amazon DocumentDB-Clusters.
Die folgenden Themen zeigen, wie Sie verschiedene Aufgaben bei der Arbeit mit elastischen Amazon DocumentDB-Clustern ausführen.
**Topics**
+ [Modifizieren von Elastic Cluster-Konfigurationen](#elastic-modify)
+ [Überwachen eines elastischen Clusters](#elastic-monitor)
+ [Löschen eines elastischen Clusters](#elastic-delete)
+ [Verwaltung von Elastic Cluster-Snapshots](elastic-manage-snapshots.md)
+ [Stoppen und Starten eines elastischen Amazon DocumentDB-Clusters](elastic-cluster-stop-start.md)
+ [Wartung elastischer Amazon DocumentDB-Cluster](elastic-cluster-maintenance.md)
## Modifizieren von Elastic Cluster-Konfigurationen
In diesem Abschnitt wird anhand der folgenden Anweisungen erklärt, wie Elastic Cluster entweder AWS CLI mit AWS-Managementkonsole oder geändert werden.
Die Änderung des Clusters wird hauptsächlich zur Skalierung von Shards verwendet, indem die Shard-Rechenkapazität erhöht oder verringert wird. and/or
------
#### [ Using the AWS-Managementkonsole ]
Um eine elastische Cluster-Konfiguration zu ändern, verwenden Sie: AWS-Managementkonsole
1. Melden Sie sich bei der Amazon DocumentDB DocumentDB-Konsole an [AWS-Managementkonsole](https://console.aws.amazon.com/docdb/home?region=us-east-1)und öffnen Sie sie.
1. Klicken Sie im Navigationsbereich auf **Cluster**.
**Tipp**
Wenn Sie den Navigationsbereich nicht auf der linken Seite Ihres Bildschirms sehen, wählen Sie das Menüsymbol in der oberen linken Ecke des Navigationsbereichs.
1. Wählen Sie in der Spalte **Cluster-ID den Namen des Clusters** aus, den Sie ändern möchten.
1. Wählen Sie **Ändern** aus.
1. Bearbeiten Sie die Felder, die Sie ändern möchten, und wählen Sie dann **Cluster ändern** aus.
![\[Formular mit Optionen für Konfiguration, Wartung, Authentifizierung und Netzwerkeinstellungen, die geändert werden können, mit der Schaltfläche Cluster ändern in der unteren rechten Ecke.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/cluster-shard-modify-3.png)
**Anmerkung**
**Alternativ können Sie auf das Dialogfeld „**Cluster ändern**“ zugreifen, indem Sie auf der Seite „**Cluster**“ das Kästchen neben Ihrem Cluster aktivieren und **Aktionen** und dann Ändern auswählen.**
------
#### [ Using the AWS CLI ]
Um eine elastische Cluster-Konfiguration mithilfe von zu ändern AWS CLI, verwenden Sie den `update-cluster` Vorgang mit den folgenden Parametern:
+ **--cluster-arn**—Erforderlich. Die ARN-ID des Clusters, den Sie ändern möchten.
+ **--shard-capacity**— Fakultativ. Die Anzahl von v, die jedem Shard CPUs zugewiesen sind. Das Maximum ist 64. Zulässige Werte sind 2, 4, 8, 16, 32, 64.
+ **--shard-count**— Fakultativ. Die Anzahl der dem Cluster zugewiesenen Shards. Das Maximum ist 32.
+ **--shard-instance**-Anzahl — optional. Die Anzahl der Replikatinstanzen, die für alle Shards in diesem Cluster gelten. Das Maximum ist 16.
+ **--auth-type**— Fakultativ. Der Authentifizierungstyp, der verwendet wird, um zu bestimmen, wo das für den Zugriff auf den Elastic Cluster verwendete Passwort abgerufen werden soll. Gültige Typen sind `PLAIN_TEXT` oder`SECRET_ARN`.
+ **--admin-user-password**— Fakultativ. Das dem Admin-Benutzer zugeordnete Passwort.
+ **--vpc-security-group-ids**— Fakultativ. Konfigurieren Sie eine Liste von Amazon EC2- und Amazon Virtual Private Cloud (VPC) -Sicherheitsgruppen, die diesem Cluster zugeordnet werden sollen.
+ **--preferred-maintenance-window**— Optional. Konfigurieren Sie den wöchentlichen Zeitraum, in dem die Systemwartung erfolgen kann, in UTC (Universal Coordinated Time)
Das Format ist:`ddd:hh24:mi-ddd:hh24:mi`. Gültige Tage (ddd): Mo, Di, Mi, Do, Fr, Sa, So
Die Standardeinstellung ist ein 30-minütiges Fenster, das nach dem Zufallsprinzip aus einem 8-Stunden-Zeitblock für jede Amazon Web Services Services-Region ausgewählt wird und an einem zufälligen Wochentag stattfindet.
Zeitfenster von mindestens 30 Minuten.
+ **--subnet-ids**— Fakultativ. Konfigurieren Sie Netzwerk-Subnetz-IDs.
Ersetzen Sie im folgenden Beispiel jede *user input placeholder* durch Ihre eigenen Informationen.
Für Linux, macOS oder Unix:
```
aws docdb-elastic update-cluster \
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
--shard-capacity 8 \
--shard-count 4 \
--shard-instance-count 3 \
--admin-user-password testPassword \
--vpc-security-group-ids ec-65f40350 \
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
Für Windows:
```
aws docdb-elastic update-cluster ^
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
--shard-capacity 8 ^
--shard-count 4 ^
--shard-instance-count 3 ^
--admin-user-password testPassword ^
--vpc-security-group-ids ec-65f40350 ^
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
------
Informationen zur Überwachung des Status des Elastic Clusters nach Ihrer Änderung finden Sie unter Elastic Cluster überwachen.
## Überwachen eines elastischen Clusters
In diesem Abschnitt wird anhand der folgenden Anweisungen erklärt, wie Sie Ihren Elastic Cluster entweder AWS CLI mithilfe der AWS-Managementkonsole oder überwachen können.
------
#### [ Using the AWS-Managementkonsole ]
Um eine elastische Cluster-Konfiguration zu überwachen, verwenden Sie AWS-Managementkonsole:
1. Melden Sie sich bei der Amazon DocumentDB DocumentDB-Konsole an [AWS-Managementkonsole](https://console.aws.amazon.com/docdb/home?region=us-east-1)und öffnen Sie sie.
1. Klicken Sie im Navigationsbereich auf **Cluster**.
**Tipp**
Wenn Sie den Navigationsbereich nicht auf der linken Seite Ihres Bildschirms sehen, wählen Sie das Menüsymbol in der oberen linken Ecke des Navigationsbereichs.
1. Wählen Sie in der Spalte **Cluster-ID den Namen des Clusters** aus, den Sie überwachen möchten.
1. Wählen Sie die Registerkarte **Überwachung**.
![\[Die zusammenfassenden Informationen zum Elastic Cluster werden auf der Registerkarte „Überwachung“ angezeigt.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/cluster-shard-monitor-2.png)
Für die folgenden Überwachungskategorien CloudWatch werden eine Reihe von Diagrammen von Amazon angezeigt:
+ Nutzung der Ressourcen
+ Durchsatz
+ Operationen
+ System (System)
Sie können auch CloudWatch über Amazon zugreifen AWS-Managementkonsole , um Ihre eigene Überwachungsumgebung für Ihre elastischen Cluster einzurichten.
------
#### [ Using the AWS CLI ]
Um eine bestimmte Elastic Cluster-Konfiguration mithilfe von zu überwachen AWS CLI, verwenden Sie den `get-cluster` Vorgang mit den folgenden Parametern:
+ **--cluster-arn**—Erforderlich. Die ARN-ID des Clusters, für den Sie Informationen benötigen.
Ersetzen Sie im folgenden Beispiel jede *user input placeholder* durch Ihre eigenen Informationen.
Für Linux, macOS oder Unix:
```
aws docdb-elastic get-cluster \
--cluster-arn arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9
```
Für Windows:
```
aws docdb-elastic get-cluster ^
--cluster-arn arn:aws:docdb:-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9
```
Die Ausgabe dieses Vorgangs sieht etwa wie folgt aus:
```
"cluster": {
...
"clusterArn": "arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9",
"clusterEndpoint": "stretch-11-477568257630.us-east-1.docdb-elastic.amazonaws.com",
"readerEndpoint": "stretch-11-477568257630-ro.us-east-1.docdb-elastic.amazonaws.com",
"clusterName": "stretch-11",
"shardCapacity": 2,
"shardCount": 3,
"shardInstanceCount: 5,
"status": "ACTIVE",
...
}
```
Weitere Informationen finden Sie `DescribeClusterSnapshot` in der Amazon DocumentDB Resource Management API-Referenz.
Verwenden Sie den `list-clusters` Vorgang mit den folgenden Parametern AWS CLI, um die Details aller Elastic Cluster anzuzeigen, die den verwenden:
+ **--next-token**— Optional. Wenn die Anzahl der ausgegebenen Elemente (`--max-results`) geringer als die Gesamtanzahl der Elemente ist, die von den zugrunde liegenden API-Aufrufen zurückgeliefert werden, enthält die Ausgabe ein `NextToken`. Dieses können Sie in einem anschließenden Befehl zum Abrufen der nächsten Gruppe von Elementen übergeben.
+ **--max-results**—Fakultativ. Die Gesamtzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Wenn mehr Ergebnisse als der angegebene `max-results` Wert vorhanden sind, ist ein Paginierungstoken (`next-token`) in der Antwort enthalten, sodass die verbleibenden Ergebnisse abgerufen werden können.
+ Standard: 100
+ Mindestens 20, maximal 100
Ersetzen Sie im folgenden Beispiel jede *user input placeholder* durch Ihre eigenen Informationen.
Für Linux, macOS oder Unix:
```
aws docdb-elastic list-clusters \
--next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== \
--max-results 2
```
Für Windows:
```
aws docdb-elastic list-clusters ^
--next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== ^
--max-results 2
```
Die Ausgabe dieses Vorgangs sieht etwa wie folgt aus:
```
{
"Clusters": [
{
"ClusterIdentifier":"mycluster-1",
"ClusterArn":"arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster"
"Status":"available",
"ClusterEndpoint":"sample-cluster.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
}
{
"ClusterIdentifier":"mycluster-2",
"ClusterArn":"arn:aws:docdb:us-west-2:987654321098:sharded-cluster:sample-cluster"
"Status":"available",
"ClusterEndpoint":"sample-cluster2.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com"
}
]
}
```
------
## Löschen eines elastischen Clusters
In diesem Abschnitt erklären wir, wie Sie einen elastischen Cluster löschen, indem Sie entweder die AWS-Managementkonsole oder AWS CLI verwenden und die folgenden Anweisungen verwenden.
------
#### [ Using the AWS-Managementkonsole ]
Um eine elastische Cluster-Konfiguration zu löschen, verwenden Sie AWS-Managementkonsole:
1. Melden Sie sich bei der Amazon DocumentDB DocumentDB-Konsole an [AWS-Managementkonsole](https://console.aws.amazon.com/docdb/home?region=us-east-1)und öffnen Sie sie.
1. Klicken Sie im Navigationsbereich auf **Cluster**.
**Tipp**
Wenn Sie den Navigationsbereich nicht auf der linken Seite Ihres Bildschirms sehen, wählen Sie das Menüsymbol in der oberen linken Ecke des Navigationsbereichs.
1. **Aktivieren Sie in der Cluster-Listentabelle das Kontrollkästchen links neben dem Clusternamen, den Sie löschen möchten, und wählen Sie dann Aktionen aus.** Wählen Sie im Dropdown-Menü **Löschen** aus.
1. Im **elastischen Cluster „Clustername“ löschen**? **Wählen Sie im Dialogfeld Löschen aus.**
![\[Dialogfeld löschen, mit der Schaltfläche Löschen in der unteren rechten Ecke.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/cluster-delete-dialog.png)
Es dauert einige Minuten, bis der Cluster gelöscht ist. Informationen zur Überwachung des Clusterstatus finden Sie unter [Überwachen des Status eines Amazon DocumentDB-Clusters](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).
------
#### [ Using the AWS CLI ]
Um einen Elastic Cluster mit dem zu löschen AWS CLI, verwenden Sie den `delete-cluster` Vorgang mit den folgenden Parametern:
+ **--cluster-arn**—Erforderlich. Die ARN-ID des Clusters, den Sie löschen möchten.
+ **--no-skip-final-backup**— Fakultativ. Wenn Sie eine endgültige Sicherung wünschen, müssen Sie diesen Parameter zusammen mit einem Namen für die endgültige Sicherung angeben. Sie müssen entweder `--final-backup-identifier` oder `--skip-final-backup` angeben.
+ **--skip-final-backup**— Optional. Verwenden Sie diesen Parameter nur, wenn Sie vor dem Löschen Ihres Clusters kein letztes Backup erstellen möchten. Standardmäßig wird ein letzter Snapshot erstellt.
In den folgenden AWS CLI Codebeispielen wird ein Cluster mit dem ARN arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster mit einer endgültigen Sicherung gelöscht.
*user input placeholder*Ersetzen Sie im folgenden Beispiel jede durch Ihre eigenen Informationen..
Für Linux, macOS oder Unix:
```
aws docdb-elastic delete-cluster \
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
--no-skip-final-backup \
--final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
Für Windows:
```
aws docdb-elastic delete-cluster ^
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
--no-skip-final-backup ^
--final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
In den folgenden AWS CLI Codebeispielen wird ein Cluster mit dem ARN arn:aws:docdb:us-west- 2:123456789012:sharded-cluster:sample-cluster gelöscht, ohne eine endgültige Sicherung zu erstellen.
*user input placeholder*Ersetzen Sie im folgenden Beispiel jedes durch Ihre eigenen Informationen.
Für Linux, macOS oder Unix:
```
aws docdb-elastic delete-cluster \
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \
--skip-final-backup \
```
Für Windows:
```
aws docdb-elastic delete-cluster ^
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^
--skip-final-backup ^
```
Die Ausgabe des `delete-cluster` Vorgangs ist eine Anzeige des Clusters, den Sie löschen.
Es dauert einige Minuten, bis der Cluster gelöscht ist. Informationen zur Überwachung des Clusterstatus finden Sie unter [Überwachen des Status eines Amazon DocumentDB-Clusters](https://docs.aws.amazon.com/documentdb/latest/developerguide/monitoring_docdb-cluster_status.html).
------
# Verwaltung von Elastic Cluster-Snapshots
Manuelle Snapshots können erstellt werden, nachdem ein elastischer Cluster erstellt wurde. Automatisierte Backups werden in dem Moment erstellt, in dem der Elastic Cluster-Snapshot erstellt wird.
**Anmerkung**
Ihr Elastic Cluster muss sich in dem `Available` Zustand befinden, in dem ein manueller Snapshot erstellt werden kann.
In diesem Abschnitt wird erklärt, wie Sie Elastic Cluster-Snapshots erstellen, anzeigen, wiederherstellen und löschen können.
Die folgenden Themen zeigen, wie Sie verschiedene Aufgaben bei der Arbeit mit Amazon DocumentDB Elastic Cluster-Snapshots ausführen.
**Topics**
+ [Einen manuellen Elastic Cluster-Snapshot erstellen](#elastic-create-snapshot)
+ [Einen Elastic Cluster-Snapshot anzeigen](#elastic-view-snapshot)
+ [Wiederherstellen eines Elastic Clusters aus einem Snapshot](#elastic-restore-snapshot)
+ [Einen Elastic Cluster-Snapshot wird kopiert](#elastic-copy-snapshot)
+ [Löschen eines Elastic Cluster-Snapshots](#elastic-delete-snapshot)
+ [Verwaltung eines automatischen Backups eines Elastic Cluster-Snapshots](#elastic-auto-snapshot)
## Einen manuellen Elastic Cluster-Snapshot erstellen
In diesem Abschnitt wird anhand der folgenden Anweisungen erklärt, wie Sie einen manuellen Elastic Cluster-Snapshot erstellen. AWS-Managementkonsole AWS CLI
------
#### [ Using the AWS-Managementkonsole ]
Um einen manuellen Elastic Cluster-Snapshot zu erstellen, verwenden Sie AWS-Managementkonsole:
1. Melden Sie sich bei der Amazon DocumentDB DocumentDB-Konsole an [AWS-Managementkonsole](https://console.aws.amazon.com/docdb/home?region=us-east-1)und öffnen Sie sie.
1. Wählen Sie im Navigationsbereich die Option **Snapshots**.
**Tipp**
Wenn Sie den Navigationsbereich nicht auf der linken Seite Ihres Bildschirms sehen, wählen Sie das Menüsymbol in der oberen linken Ecke des Navigationsbereichs.
1. Wählen Sie auf der Seite **Snapshots** die Option **Create (Erstellen)** aus.
1. Wählen Sie auf der Seite **Cluster-Snapshot erstellen** im Feld **Cluster-ID** Ihren Elastic Cluster aus der Dropdownliste aus.
Geben Sie im Feld **Snapshot-Identifier** eine eindeutige Kennung für Ihren Elastic Cluster ein.
Wählen Sie **Erstellen** aus.
![\[Diagramm: Elastic Cluster, Snapshot erstellen\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/elastic-create-snapshot.png)
**Anmerkung**
Alternativ können Sie auf das Dialogfeld **Cluster-Snapshot erstellen** zugreifen, indem Sie auf der Seite **Cluster** das Kästchen neben Ihrem Cluster markieren und dann **Aktionen** und dann **Snapshot erstellen** auswählen.
Ihr Elastic Cluster-Snapshot wird jetzt bereitgestellt. Es kann bis zu ein paar Minuten dauern, bis dieser Vorgang abgeschlossen ist. Sie können Ihren Snapshot ansehen und aus diesem wiederherstellen, wenn der Status wie `Available` in der **Snapshot-Liste** angezeigt wird.
------
#### [ Using the AWS CLI ]
Um einen manuellen Elastic Cluster-Snapshot mit dem zu erstellen AWS CLI, verwenden Sie den `create-cluster-snapshot` Vorgang mit den folgenden Parametern:
+ **--snapshot-name**—Erforderlich. Der Name des Cluster-Snapshots, den Sie erstellen möchten.
+ **--cluster-arn**—Erforderlich. Die ARN-ID des Clusters, von dem Sie einen Snapshot erstellen möchten.
Ersetzen Sie im folgenden Beispiel jede *user input placeholder* durch Ihre eigenen Informationen.
Für Linux, macOS oder Unix:
```
aws docdb-elastic create-cluster-snapshot \
--snapshot-name sample-snapshot-1 \
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
Für Windows:
```
aws docdb-elastic create-cluster-snapshot ^
--snapshot-name sample-snapshot-1 ^
--cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster
```
------
## Einen Elastic Cluster-Snapshot anzeigen
In diesem Abschnitt wird anhand der folgenden Anweisungen erklärt, wie Sie Elastic Cluster-Snapshot-Informationen anzeigen können. AWS-Managementkonsole AWS CLI
------
#### [ Using the AWS-Managementkonsole ]
Um Informationen zu einem bestimmten Elastic Cluster-Snapshot anzuzeigen, verwenden Sie AWS-Managementkonsole:
1. Melden Sie sich bei der Amazon DocumentDB DocumentDB-Konsole an [AWS-Managementkonsole](https://console.aws.amazon.com/docdb/home?region=us-east-1)und öffnen Sie sie.
1. Wählen Sie im Navigationsbereich die Option **Snapshots**.
**Tipp**
Wenn Sie den Navigationsbereich nicht auf der linken Seite Ihres Bildschirms sehen, wählen Sie das Menüsymbol in der oberen linken Ecke des Navigationsbereichs.
1. Wählen Sie auf der Seite **Snapshots** Ihren Snapshot aus der Liste aus, indem Sie in der Spalte **Snapshot-ID** auf den Namen klicken.
1. Sehen Sie sich die Informationen zu Ihrem Snapshot unter **Details** an.
![\[Diagramm: Snapshot mit Elastic-Cluster-Ansicht\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/elastic-snapshot-view.png)
------
#### [ Using the AWS CLI ]
Verwenden Sie den `get-cluster-snapshot` Vorgang mit den folgenden Parametern AWS CLI, um Informationen zu einem bestimmten Elastic Cluster-Snapshot mithilfe von anzuzeigen:
+ **--snapshot-arn**—Erforderlich. Die ARN-ID des Snapshots, für den Sie Informationen benötigen.
Ersetzen Sie im folgenden Beispiel jede *user input placeholder* durch Ihre eigenen Informationen.
Für Linux, macOS oder Unix:
```
aws docdb-elastic get-cluster-snapshot \
--snapshot-arn sampleResourceName
```
Für Windows:
```
aws docdb-elastic get-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
Verwenden Sie den `get-cluster-snapshot` Vorgang mit den folgenden Parametern AWS CLI, um Informationen zu einem bestimmten Elastic Cluster-Snapshot mithilfe von anzuzeigen:
+ **--snapshot-arn**—Erforderlich. Die ARN-ID des Snapshots, für den Sie Informationen benötigen.
Ersetzen Sie im folgenden Beispiel jede *user input placeholder* durch Ihre eigenen Informationen.
Für Linux, macOS oder Unix:
```
aws docdb-elastic get-cluster-snapshot \
--snapshot-arn sampleResourceName
```
Für Windows:
```
aws docdb-elastic get-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
Verwenden Sie den `list-cluster-snapshots` Vorgang mit den folgenden Parametern, um Informationen zu allen Elastic Cluster-Snapshots anzuzeigen AWS CLI, die den verwenden:
+ **--snapshot-type**— Optional. Der Typ der Cluster-Snapshots, die zurückgegeben werden sollen. Sie können einen der folgenden Werte angeben:
+ `automated`- Gibt alle Cluster-Snapshots zurück, die Amazon DocumentDB automatisch für Ihr AWS Konto erstellt hat.
+ `manual`- Gibt alle Cluster-Snapshots zurück, die Sie manuell für Ihr Konto erstellt haben. AWS
+ `shared`- Gibt alle manuellen Cluster-Snapshots zurück, die für Ihr AWS Konto freigegeben wurden.
+ `public`- Gibt alle Cluster-Snapshots zurück, die als öffentlich markiert wurden.
+ **--next-token**— Fakultativ. Ein optionales Paginierungstoken, das von einer vorherigen Anforderung bereitgestellt wird. Wenn dieser Parameter angegeben ist, umfasst die Antwort nur Datensätze, die über dieses Token hinausgehen, bis zu dem von `max-results` angegebenen Wert.
+ **--max-results**— Fakultativ. Die maximale Anzahl von Ergebnissen, die in die Antwort aufgenommen werden sollen. Wenn mehr Ergebnisse als der angegebene `max-results` Wert vorhanden sind, ist ein Paginierungstoken (`next-token`) in der Antwort enthalten, sodass die verbleibenden Ergebnisse abgerufen werden können.
+ Standard: 100
+ Mindestens 20, maximal 100
Ersetzen Sie im folgenden Beispiel jede *user input placeholder* durch Ihre eigenen Informationen.
Für Linux, macOS oder Unix:
```
aws docdb-elastic list-cluster-snapshots \
--snapshot-type value \
--next-token value \
--max-results 50
```
Für Windows:
```
aws docdb-elastic list-cluster-snapshots ^
--snapshot-type value ^
--next-token value ^
--max-results 50
```
------
## Wiederherstellen eines Elastic Clusters aus einem Snapshot
In diesem Abschnitt wird anhand der folgenden Anweisungen erklärt, wie Sie einen Elastic Cluster aus einem Snapshot wiederherstellen, indem Sie entweder die AWS-Managementkonsole oder AWS CLI verwenden.
------
#### [ Using the AWS-Managementkonsole ]
Um einen Elastic Cluster aus einem Snapshot wiederherzustellen, verwenden Sie AWS-Managementkonsole:
1. Melden Sie sich bei der Amazon DocumentDB DocumentDB-Konsole an [AWS-Managementkonsole](https://console.aws.amazon.com/docdb/home?region=us-east-1)und öffnen Sie sie.
1. Wählen Sie im Navigationsbereich die Option **Snapshots**.
**Tipp**
Wenn Sie den Navigationsbereich nicht auf der linken Seite Ihres Bildschirms sehen, wählen Sie das Menüsymbol in der oberen linken Ecke des Navigationsbereichs.
1. Wählen Sie in der Spalte **Snapshot-ID die Schaltfläche links neben dem Snapshot**, den Sie zum Wiederherstellen eines Clusters verwenden möchten.
1. Wählen Sie **Aktionen** und dann **Wiederherstellen** aus.
![\[Diagramm: Elastische Cluster-Wiederherstellung aus einem Snapshot\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/elastic-restore-snapshot.png)
1. Geben Sie auf der Seite „**Snapshot wiederherstellen**“ einen Namen für den neuen Cluster in das Feld **Cluster-ID** ein.
**Anmerkung**
Für jede manuelle Snapshot-Wiederherstellung müssen Sie einen neuen Cluster erstellen.
1. Wählen Sie im Feld **Virtual Private Cloud (VPC)** eine VPC aus der Drop-down-Liste aus.
1. Für **Subnetze** und **VPC-Sicherheitsgruppen** können Sie die Standardeinstellungen verwenden oder drei Subnetze Ihrer Wahl und bis zu drei VPC-Sicherheitsgruppen (mindestens eine) auswählen.
1. Wenn Sie mit der Cluster-Konfiguration zufrieden sind, wählen Sie **Restore cluster (Cluster wiederherstellen)** aus und warten Sie, bis Ihr Cluster wiederhergestellt ist.
------
#### [ Using the AWS CLI ]
Verwenden Sie den Vorgang mit den folgenden Parametern, um einen Elastic Cluster aus einem Snapshot mithilfe von wiederherzustellen: AWS CLI`restore-cluster-from-snapshot`
+ **--cluster-name**—Erforderlich. Der aktuelle Name des elastischen Clusters, wie er bei der Erstellung eingegeben oder zuletzt geändert wurde.
+ **--snapshot-arn**—Erforderlich. Die ARN-ID des Snapshots, der zur Wiederherstellung des Clusters verwendet wird.
+ **--vpc-security-group-ids**— Optional. Eine oder mehrere Amazon EC2- und Amazon Virtual Private Cloud (VPC) -Sicherheitsgruppen, die dem Cluster zugeordnet werden sollen.
+ **--kms-key-id**— Optional. Konfigurieren Sie die KMS-Schlüssel-ID für einen verschlüsselten Cluster.
Die KMS-Schlüssel-ID ist der Amazon-Ressourcenname (ARN) für den AWS KMS Verschlüsselungsschlüssel. Wenn Sie einen Cluster mit demselben Amazon Web Services Services-Konto erstellen, dem der KMS-Verschlüsselungsschlüssel gehört, der zur Verschlüsselung des neuen Clusters verwendet wird, können Sie den KMS-Schlüsselalias anstelle des ARN für den KMS-Verschlüsselungsschlüssel verwenden.
Wenn in kein Verschlüsselungsschlüssel angegeben ist KmsKeyId und der `StorageEncrypted` Parameter wahr ist, verwendet Amazon DocumentDB Ihren Standard-Verschlüsselungsschlüssel.
+ **--subnet-ids**— Optional. Netzwerk-Subnetz-IDs.
Ersetzen Sie im folgenden Beispiel jede *user input placeholder* durch Ihre eigenen Informationen.
Für Linux, macOS oder Unix:
```
aws docdb-elastic restore-cluster-from-snapshot \
--cluster-name elastic-sample-cluster \
--snapshot-arn sampleResourceName \
--vpc-security-group-ids value ec-65f40350 \
--kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
Für Windows:
```
aws docdb-elastic restore-cluster-from-snapshot ^
--cluster-name elastic-sample-cluster ^
--snapshot-arn sampleResourceName ^
--vpc-security-group-ids value ec-65f40350 ^
--kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^
--subnet-ids subnet-9253c6a3, subnet-9f1b5af9
```
------
## Einen Elastic Cluster-Snapshot wird kopiert
In Amazon DocumentDB können Sie manuelle und automatische Elastic Cluster-Snapshots innerhalb derselben Region und innerhalb desselben Kontos kopieren. In diesem Abschnitt wird erklärt, wie Sie einen Elastic Cluster-Snapshot kopieren, indem Sie entweder das AWS-Managementkonsole oder verwenden. AWS CLI
------
#### [ Using the AWS-Managementkonsole ]
Um einen Elastic Cluster-Snapshot zu kopieren, verwenden Sie AWS-Managementkonsole:
1. Melden Sie sich bei der Amazon DocumentDB DocumentDB-Konsole an [AWS-Managementkonsole](https://console.aws.amazon.com/docdb/home?region=us-east-1)und öffnen Sie sie.
1. Wählen Sie im Navigationsbereich die Option **Snapshots**.
**Tipp**
Wenn Sie den Navigationsbereich nicht auf der linken Seite Ihres Bildschirms sehen, wählen Sie das Menüsymbol in der oberen linken Ecke des Navigationsbereichs.
1. Wählen Sie in der Spalte **Snapshot-ID die Schaltfläche links neben dem Snapshot**, den Sie kopieren möchten.
1. Wählen Sie „**Aktionen**“ und dann „**Kopieren**“.
![\[Diagramm: Elastic Cluster Copy-Snapshot\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/ec-copy-snapshot.png)
1. Geben Sie **unter Neuer Snapshot-Identifier** den Namen des neuen Snapshots ein.
1. Aktivieren Sie für **Copy Tags** das Kontrollkästchen, wenn Sie alle Tags aus dem Elastic Cluster-Quell-Snapshot in den Elastic Cluster-Ziel-Snapshot kopieren möchten.
1. Wählen Sie für die **Verschlüsselung** entweder einen AWS Standard-KMS-Schlüssel oder einen KMS-Schlüssel Ihrer Wahl. Mit der zweiten Option können Sie einen vorhandenen KMS-Schlüssel auswählen, den Sie bereits erstellt haben, oder einen neuen erstellen.
1. Wählen Sie **Snapshot kopieren**, wenn Sie fertig sind.
------
#### [ Using the AWS CLI ]
Um einen Elastic Cluster-Snapshot mit dem zu kopieren AWS CLI, verwenden Sie den `copy-cluster-snapshot` Vorgang mit den folgenden Parametern:
+ **‐‐source-db-cluster-snapshot-identifier**—Erforderlich. Der Bezeichner des vorhandenen Elastic Cluster-Snapshots, der kopiert wird. Der Elastic Cluster-Snapshot muss vorhanden und verfügbar sein. Bei diesem Parameter wird nicht zwischen Groß- und Kleinschreibung unterschieden.
+ **‐‐target-db-cluster-snapshot-identifier**—Erforderlich. Die ID des neuen Elastic Cluster-Snapshots, der aus dem vorhandenen Cluster-Snapshot erstellt werden soll. Bei diesem Parameter wird nicht zwischen Groß- und Kleinschreibung unterschieden.
Einschränkungen beim Namen des Ziel-Snapshots:
+ Kann nicht der Namen eines vorhandenen Snapshots sein.
+ 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.
Ersetzen Sie im folgenden Beispiel jede durch Ihre *user input placeholder* eigenen Informationen.
Für Linux, macOS oder Unix:
```
aws docdb-elastic copy-cluster-snapshot \
‐‐source-cluster-snapshot-arn \
‐‐target-cluster-snapshot-name my-target-copied-snapshot
```
Für Windows:
```
aws docdb-elastic copy-cluster-snapshot ^
‐‐source-cluster-snapshot-arn ^
‐‐target-cluster-snapshot-name my-target-copied-snapshot
```
------
## Löschen eines Elastic Cluster-Snapshots
In diesem Abschnitt wird erklärt, wie Sie einen Elastic Cluster-Snapshot löschen, indem Sie entweder das AWS-Managementkonsole oder verwenden AWS CLI.
------
#### [ Using the AWS-Managementkonsole ]
Um einen Elastic Cluster aus einem Snapshot wiederherzustellen, verwenden Sie AWS-Managementkonsole:
1. Melden Sie sich bei der Amazon DocumentDB DocumentDB-Konsole an [AWS-Managementkonsole](https://console.aws.amazon.com/docdb/home?region=us-east-1)und öffnen Sie sie.
1. Wählen Sie im Navigationsbereich die Option **Snapshots**.
**Tipp**
Wenn Sie den Navigationsbereich nicht auf der linken Seite Ihres Bildschirms sehen, wählen Sie das Menüsymbol in der oberen linken Ecke des Navigationsbereichs.
1. Wählen Sie in der Spalte **Snapshot-ID die Schaltfläche links neben dem Snapshot**, den Sie zum Wiederherstellen eines Clusters verwenden möchten.
1. Wählen Sie **Aktionen** und dann **Löschen** aus.
![\[Diagramm: Elastic Cluster, Snapshot löschen\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/elastic-delete-snapshot.png)
1. **Wählen **Sie im Dialogfeld „Snapshot-Name“ -Snapshot löschen** die Option Löschen aus.**
------
#### [ Using the AWS CLI ]
Um einen Elastic Cluster-Snapshot mit dem zu löschen AWS CLI, verwenden Sie den `delete-cluster-snapshot` Vorgang mit den folgenden Parametern:
+ **--snapshot-arn**—Erforderlich. Die ARN-ID des Snapshots, der zur Wiederherstellung des Clusters verwendet wird.
Ersetzen Sie im folgenden Beispiel jede *user input placeholder* durch Ihre eigenen Informationen.
Für Linux, macOS oder Unix:
```
aws docdb-elastic delete-cluster-snapshot \
--snapshot-arn sampleResourceName
```
Für Windows:
```
aws docdb-elastic delete-cluster-snapshot ^
--snapshot-arn sampleResourceName
```
------
## Verwaltung eines automatischen Backups eines Elastic Cluster-Snapshots
Amazon DocumentDB erstellt täglich Schnappschüsse Ihrer elastischen Cluster. Sie können das bevorzugte Backup-Fenster und den Aufbewahrungszeitraum für Backups in einer neuen oder vorhandenen Elastic Cluster-Snapshot-Konfiguration angeben. In diesem Abschnitt wird erklärt, wie Sie automatische Backup-Parameter in einem Elastic Cluster-Snapshot festlegen, indem Sie entweder das AWS-Managementkonsole oder verwenden AWS CLI.
------
#### [ Using the AWS-Managementkonsole ]
Um ein automatisches Backup für einen neuen Elastic Cluster-Snapshot einzurichten, verwenden Sie AWS-Managementkonsole:
1. Melden Sie sich bei der Amazon DocumentDB DocumentDB-Konsole an [AWS-Managementkonsole](https://console.aws.amazon.com/docdb/home?region=us-east-1)und öffnen Sie sie.
1. Klicken Sie im Navigationsbereich auf **Cluster**.
**Tipp**
Wenn Sie den Navigationsbereich nicht auf der linken Seite Ihres Bildschirms sehen, wählen Sie das Menüsymbol in der oberen linken Ecke des Navigationsbereichs.
1. Wählen Sie in der Spalte **Cluster-ID** die Schaltfläche links neben dem Cluster, für den Sie die Backup-Einstellungen ändern möchten.
1. Wählen Sie „**Aktionen**“ und dann **„Ändern**“.
1. Bearbeiten Sie im Abschnitt **Backup** die Felder entsprechend Ihren Backup-Anforderungen.
![\[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/ec-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. **Wählen Sie Fenster auswählen**, wenn Sie die Uhrzeit und Dauer der Erstellung von Backups konfigurieren möchten.
**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.
**Dauer** — Wählen Sie in der Liste die Anzahl der Stunden aus, die für die Erstellung automatischer Backups reserviert werden sollen.
1. Wählen Sie **Keine Präferenz**, wenn Amazon DocumentDB den Zeitpunkt und die Dauer der Erstellung von Backups wählen soll.
1. Wählen Sie **Cluster modifizieren**, wenn der Vorgang abgeschlossen ist.
------
#### [ Using the AWS CLI ]
Um ein automatisches Backup für einen neuen Elastic Cluster-Snapshot mithilfe von einzurichten AWS CLI, verwenden Sie den `create-cluster-snapshot` Vorgang mit den folgenden Parametern:
+ **--preferred-backup-window**— Optional. Der bevorzugte tägliche Zeitraum, in dem automatische Backups erstellt werden. Die Standardeinstellung ist ein 30-minütiges Fenster, das nach dem Zufallsprinzip aus einem Zeitblock von jeweils AWS-Region 8 Stunden ausgewählt wird.
Einschränkungen:
+ Muss im Format `hh24:mi-hh24:mi` angegeben werden.
+ Muss in Universal Coordinated Time (UTC) angegeben werden.
+ Darf nicht mit dem bevorzugten Wartungsfenster in Konflikt treten.
+ Muss mindestens 30 Minuten betragen.
+ **--backup-retention-period**— Optional. Die Anzahl von Tagen, über die automatische Backups aufbewahrt werden. Der Standardwert ist 1.
Einschränkungen:
+ Es muss ein Mindestwert von 1 angegeben werden.
+ Der Bereich liegt zwischen 1 und 35.
**Anmerkung**
Automatisierte Backups werden nur erstellt, wenn sich der Cluster im Status „aktiv“ befindet.
**Anmerkung**
Sie können auch die `backup-retention-period` Parameter `preferred-backup-window` und eines vorhandenen Elastic Clusters mithilfe des `aws docdb-elastic update-cluster` Befehls ändern.
Ersetzen Sie im folgenden Beispiel jede Information *user input placeholder* durch Ihre eigenen Informationen.
Im folgenden `create-cluster` Beispiel wird der elastische Amazon DocumentDB-Cluster *sample-cluster* mit einer Aufbewahrungsdauer für automatische Backups von *7* Tagen und einem bevorzugten Backup-Fenster von *18:00-18:30 UTC* erstellt.
Für Linux, macOS oder Unix:
```
aws docdb-elastic create-cluster \
--cluster-name sample-cluster \
--shard-capacity 2 \
--shard-count 2 \
--admin-user-name SampleAdmin \
--auth-type PLAIN_TEXT \
--admin-user-password SamplePass123! \
--preferred-backup-window 18:00-18:30 \
--backup-retention-period 7
```
Für Windows:
```
aws docdb-elastic create-cluster ^
--cluster-name sample-cluster ^
--shard-capacity 2 ^
--shard-count 2 ^
--admin-user-name SampleAdmin ^
--auth-type PLAIN_TEXT ^
--admin-user-password SamplePass123! ^
--preferred-backup-window 18:00-18:30 ^
--backup-retention-period 7
```
------
# Stoppen und Starten eines elastischen Amazon DocumentDB-Clusters
Das Stoppen und Starten von Amazon DocumentDB Elastic Clusters kann Ihnen helfen, die Kosten für Entwicklungs- und Testumgebungen zu kontrollieren. Anstatt jedes Mal, wenn Sie Amazon DocumentDB verwenden, elastische Cluster zu erstellen und zu löschen, können Sie Ihren Cluster vorübergehend beenden, wenn er nicht benötigt wird. Sie können ihn dann erneut starten, wenn Sie Ihre Tests fortsetzen.
**Topics**
+ [Überblick über das Stoppen und Starten eines Elastic Clusters](#elastic-cluster-stop-start-overview)
+ [Operationen, die Sie auf einem gestoppten Elastic Cluster ausführen können](#elastic-cluster-stopped-operations)
## Überblick über das Stoppen und Starten eines Elastic Clusters
In Zeiten, in denen Sie keinen elastischen Amazon DocumentDB-Cluster benötigen, können Sie den Cluster beenden. Bei Bedarf können Sie den Cluster jederzeit erneut starten. Das Starten und Stoppen vereinfacht die Einrichtungs- und Abbauprozesse für elastische Cluster, die für Entwicklungs-, Test- oder ähnliche Aktivitäten verwendet werden, für die keine kontinuierliche Verfügbarkeit erforderlich ist. Sie können einen Elastic Cluster mithilfe von AWS-Managementkonsole oder AWS CLI mit einer einzigen Aktion beenden und starten.
Während Ihr Elastic Cluster gestoppt ist, bleibt das Cluster-Speichervolumen unverändert. Sie zahlen nur für Speicherung, manuelle Snapshots und automatischen Sicherungsspeicher innerhalb des angegebenen Aufbewahrungsfensters. Amazon DocumentDB startet Ihren Elastic Cluster automatisch nach sieben Tagen, sodass er nicht hinter den erforderlichen Wartungsupdates zurückbleibt. Wenn Ihr Cluster nach sieben Tagen startet, wird Ihnen die Nutzung des Elastic Clusters wieder in Rechnung gestellt. Solange Ihr Cluster gestoppt ist, können Sie Ihr Speichervolume nicht abfragen, da die Abfrage voraussetzt, dass sich der Cluster im verfügbaren Status befindet.
Wenn ein elastischer Amazon DocumentDB-Cluster gestoppt wird, kann der Cluster in keiner Weise geändert werden. Dies beinhaltet das Löschen des Clusters.
------
#### [ Using the AWS-Managementkonsole ]
Das folgende Verfahren zeigt Ihnen, wie Sie einen elastischen Cluster im verfügbaren Zustand beenden oder einen gestoppten elastischen Cluster starten.
**So beenden oder starten Sie einen elastischen 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.
![\[Ein Cluster aus der Clusterliste, bei dem das Kontrollkästchen links neben dem Clusternamen aktiviert ist.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/cluster-list-ec.png)
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.
![\[Die Dropdownliste „Aktionen“ mit der ausgewählten Option „Stopp“.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/ec-stop.png)
1. Bestätigen Sie im Bestätigungsdialogfeld, dass Sie den Elastic Cluster beenden möchten, indem Sie **Cluster beenden** wählen, oder klicken Sie auf **Abbrechen**, um den Cluster am Laufen zu halten.
![\[Bestätigungsdialogfeld für das Stoppen eines Clusters mit den Schaltflächen Abbrechen und Cluster beenden unten.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/ec-stop-confirm.png)
+ Wenn Sie einen gestoppten Cluster starten möchten, wählen Sie **Starten** aus.
![\[Die Dropdownliste „Aktionen“ mit der ausgewählten Startoption.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/ec-start.png)
1. Überwachen Sie den Status des Elastic Clusters. Wenn Sie den Cluster gestartet haben, können Sie den Cluster wieder verwenden, sobald der Cluster *verfügbar* ist. Weitere Informationen finden Sie unter [Den Status eines Clusters ermitteln](db-cluster-status.md).
![\[Die Statusspalte in der Cluster-Tabelle zeigt den Status „Verfügbar“ und „Startstatus“ an.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/ec-starting-status.png)
------
#### [ Using the AWS CLI ]
Die folgenden Codebeispiele zeigen Ihnen, wie Sie einen elastischen Cluster im aktiven oder verfügbaren Zustand beenden oder einen gestoppten elastischen Cluster starten.
Verwenden Sie die `stop-cluster` Operation AWS CLI, um einen elastischen Cluster mithilfe von zu beenden. Verwenden Sie die `start-cluster`-Operation, um einen gestoppten Cluster zu starten. Beide Operationen verwenden den `--cluster-arn`-Parameter.
**Parameter:**
+ **--cluster-arn**—Erforderlich. Der ARN-Bezeichner des Elastic Clusters, den Sie beenden oder starten möchten.
**Example — Um einen elastischen Cluster mit dem zu beenden AWS CLI**
Ersetzen Sie im folgenden Beispiel jede *user input placeholder* durch Ihre eigenen Informationen.
Der folgende Code stoppt den elastischen Cluster mit einem ARN von`arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2`.
Der elastische Cluster muss sich im aktiven oder verfügbaren Zustand befinden.
Für Linux, macOS oder Unix:
```
aws docdb-elastic stop-cluster \
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
Für Windows:
```
aws docdb-elastic stop-cluster ^
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
**Example — Um einen elastischen Cluster mit dem zu starten AWS CLI**
Ersetzen Sie im folgenden Beispiel jede *user input placeholder* durch Ihre eigenen Informationen.
Der folgende Code startet den Elastic Cluster mit einem ARN von`arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2`.
Der elastische Cluster muss derzeit gestoppt werden.
Für Linux, macOS oder Unix:
```
aws docdb-elastic start-cluster \
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
Für Windows:
```
aws docdb-elastic start-cluster ^
--cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2
```
------
## Operationen, die Sie auf einem gestoppten Elastic Cluster ausführen können
Sie können die Konfiguration eines elastischen Amazon DocumentDB-Clusters nicht ändern, solange der Cluster gestoppt ist. Vor solchen administrativen Aktionen müssen Sie den Cluster starten.
Amazon DocumentDB wendet alle geplanten Wartungsarbeiten auf Ihren gestoppten Elastic Cluster erst an, nachdem er erneut gestartet wurde. Nach sieben Tagen startet Amazon DocumentDB automatisch einen gestoppten Elastic Cluster, sodass er in seinem Wartungsstatus nicht zu weit zurückfällt. Wenn der Elastic Cluster neu gestartet wird, werden Ihnen die Shards im Cluster wieder in Rechnung gestellt.
Während ein elastischer Cluster gestoppt ist, führt Amazon DocumentDB keine automatisierten Backups durch und verlängert auch nicht den Aufbewahrungszeitraum für Backups.
# Wartung elastischer Amazon DocumentDB-Cluster
**Topics**
+ [Ausstehende Wartungsaktionen für elastische Cluster anzeigen](#view-elastic-cluster-maintenance)
+ [Aktualisierungen der Elastic Cluster Engine](#elastic-cluster-engine-updates)
+ [Betriebssystem-Updates für Elastic Cluster](#elastic-cluster-os-updates)
Amazon DocumentDB führt regelmäßig Wartungsarbeiten an den Elastic Cluster-Ressourcen von Amazon DocumentDB durch. Die Wartung umfasst in den meisten Fällen Aktualisierungen der Datenbank-Engine (Elastic Cluster-Wartung) oder des dem Elastic Cluster zugrunde liegenden Betriebssystems (Betriebssystem-Updates). Datenbank-Engine-Updates sind erforderliche Patches und beinhalten Sicherheitskorrekturen, Bugfixes und Verbesserungen der Datenbank-Engine. Die meisten Betriebssystem-Patches sind zwar optional, aber wenn Sie sie eine Zeit lang nicht anwenden, kann es sein, dass der Patch erforderlich ist und auto angewendet wird, um Ihren Sicherheitsstatus aufrechtzuerhalten. Wir empfehlen Ihnen daher, Betriebssystem-Updates auf Ihre elastischen Amazon DocumentDB-Cluster zu installieren, sobald sie verfügbar sind.
Datenbank-Engine-Patches erfordern, dass Sie Ihre elastischen Amazon DocumentDB-Cluster für kurze Zeit offline schalten. Sobald sie verfügbar sind, werden diese Patches automatisch so geplant, dass sie während eines bevorstehenden geplanten Wartungsfensters Ihres Amazon DocumentDB Elastic Clusters installiert werden.
Elastische Cluster haben ihre eigenen jeweiligen Wartungsfenster. Elastic Cluster-Änderungen, die Sie nicht sofort anwenden möchten, werden während des Wartungsfensters angewendet. Wenn Sie einen Elastic Cluster erstellen, weist Amazon DocumentDB standardmäßig ein Wartungsfenster für Ihren Elastic Cluster zu. Sie können das Wartungsfenster wählen, wenn Sie einen elastischen Cluster erstellen. Sie können die Wartungsfenster außerdem jederzeit an Ihre Geschäftspläne oder -praktiken anpassen. Es wird generell empfohlen, Wartungsfenster auszuwählen, die die Auswirkungen der Wartung auf Ihre Anwendung minimieren (z. B. an Abenden oder Wochenenden).
## Ausstehende Wartungsaktionen für elastische Cluster anzeigen
Mithilfe von können Sie überprüfen, ob ein Wartungsupdate für Ihren Elastic Cluster verfügbar ist AWS CLI.
Wenn ein Update verfügbar ist, können Sie eine der folgenden Aktionen durchführen:
+ Verschieben Sie eine Wartungsaktion, die derzeit für das nächste Wartungsfenster geplant ist (nur für Betriebssystem-Patches).
+ Wenden Sie die Wartungsaktionen sofort an.
+ Einplanen der Wartungsaktivitäten für das nächste Wartungsfenster.
+ Planen Sie die Wartungsaktionen so, dass sie während des ausgewählten Anwendungsfensters beginnen.
Das Wartungsfenster legt fest, wann die ausstehenden Operationen gestartet werden, gibt aber kein Abschlussdatum für diese Operationen vor; die Ausführungsdauer ist weder bekannt noch a priori beschränkt.
Verwenden Sie den folgenden AWS CLI Vorgang, um festzustellen, welche Wartungsaktionen noch ausstehen. Alle ausstehenden Wartungsaktionen auflisten:
```
aws docdb-elastic list-pending-maintenance-actions
```
Die Ausgabe dieses Vorgangs sieht etwa wie folgt aus (JSON-Format):
```
{
'ResourcePendingMaintenanceActions': [
{
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'ENGINE_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'string',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
},
],
'NextToken': 'string'
}
```
Ruft ausstehende Wartungsmaßnahmen (falls vorhanden) für ein bestimmtes Objekt ab`resourceArn`:
```
aws docdb-elastic get-pending-maintenance-action --resource-arn string-arn
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'ENGINE_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'string',
'CurrentApplyDate': 'string',
'Description': 'string'
}
]
}
}
```
Parameter:
+ `ResourceArn`— Der Amazon Resource Name (ARN) von Amazon DocumentDB der Ressource, für die die ausstehende Wartungsaktion gilt.
+ `Action`— Die ausstehende Wartungsaktion, die auf die Ressource angewendet wird.
Zulässige Werte:
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ `AutoAppliedAfterDate`— Erstes Wartungsfenster nach diesem Datum. `NEXT_MAINTENANCE OPT_IN`wird in diesem Fall ignoriert.
+ `ForcedApplyDate`— Wird unabhängig vom Wartungsfenster angewendet. `IMMEDIATE OPT_IN`wird in diesem Fall ignoriert.
+ `OptInStatus`— Ein Wert, der den Typ der Opt-in-Anfrage angibt oder eine Opt-in-Anfrage rückgängig macht. Eine Opt-in-Anfrage vom Typ `IMMEDIATE` kann nicht rückgängig gemacht werden.
Zulässige Werte:
+ `IMMEDIATE`— Wendet die Wartungsmaßnahme sofort an.
+ `NEXT_MAINTENANCE`— Wendet die Wartungsaktion im nächsten Wartungsfenster für die Ressource an.
+ `APPLY_ON`— Wendet die Wartungsaktion unabhängig vom nächsten Wartungsfenster für die Ressource am angegebenen Anwendungsdatum an.
+ `UNDO_OPT_IN`— Storniert alle bestehenden Anfragen `NEXT_MAINTENANCE` oder `APPLY_ON` Opt-In-Anfragen.
+ `CurrentApplyDate`— Wird angezeigt, falls ja opt-in-type. `APPLY_ON`
+ `Description`— Eine Beschreibung der Option für die Wartungsaktion.
## Aktualisierungen der Elastic Cluster Engine
Mit Amazon DocumentDB können Sie wählen, wann Wartungsarbeiten durchgeführt werden sollen. Mit dem können Sie entscheiden, wann Amazon DocumentDB Updates AWS CLI einführt.
Ausstehende Wartungsmaßnahmen anwenden:
```
aws docdb-elastic apply-pending-maintenance-action
--resource-arn string-arn
--apply-action string-enum
--opt-in-type string-enum
[--apply-on string-date-range]
```
Parameter:
+ **--resource-arn**— Der Amazon Resource Name (ARN) von Amazon DocumentDB der Ressource, für die die ausstehende Wartungsaktion gilt.
+ **--apply-action**— Die ausstehende Wartungsaktion, die auf diese Ressource angewendet werden soll.
Zulässige Werte:
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ **--opt-in-type**— Ein Wert, der den Typ der Opt-in-Anfrage angibt oder eine Opt-in-Anfrage rückgängig macht. Eine Opt-in-Anfrage vom Typ `IMMEDIATE` kann nicht rückgängig gemacht werden.
Zulässige Werte:
+ `IMMEDIATE`— Wendet die Wartungsmaßnahme sofort an.
+ `NEXT_MAINTENANCE`— Wendet die Wartungsaktion im nächsten Wartungsfenster für die Ressource an.
+ `APPLY_ON`— Wendet die Wartungsaktion unabhängig vom nächsten Wartungsfenster für die Ressource am angegebenen Anwendungsdatum an.
+ `UNDO_OPT_IN`— Storniert alle bestehenden Anfragen `NEXT_MAINTENANCE` oder `APPLY_ON` Opt-In-Anfragen.
+ **[--apply-on]**— Erforderlich, falls ja opt-in-type. `APPLY_ON` Format: `yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm` (Diese Option verwendet UTC-Zeit. Die Startzeit kann ein beliebiger Zeitpunkt in der future sein, zwischen mindestens 30 Minuten und maximal 14 Tagen, oder das force/apply Datum der ausstehenden Aktion, je nachdem, welcher Zeitpunkt früher liegt. Das Zeitfenster von Anfang bis Ende kann mindestens 30 Minuten bis maximal 8 Stunden lang sein.)
Die Ausgabe dieses Vorgangs sieht etwa wie folgt aus (JSON-Format):
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'SECURITY_UPDATE',
'AutoAppliedAfterDate': 'string',
'ForcedApplyDate': 'string',
'OptInStatus': 'IMMEDIATE',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
}
}
```
Parameter:
+ `ResourceArn`— Der Amazon Resource Name (ARN) von Amazon DocumentDB der Ressource, für die die ausstehende Wartungsaktion gilt.
+ `Action`— Die ausstehende Wartungsaktion, die auf die Ressource angewendet wird.
Zulässige Werte:
+ `ENGINE_UPDATE`
+ `ENGINE_UPGRADE`
+ `SECURITY_UPDATE`
+ `OS_UPDATE`
+ `MASTER_USER_PASSWORD_UPDATE`
+ `AutoAppliedAfterDate`— Erstes Wartungsfenster nach diesem Datum. `NEXT_MAINTENANCE OPT_IN`wird in diesem Fall ignoriert.
+ `ForcedApplyDate`— Wird unabhängig vom Wartungsfenster angewendet. `IMMEDIATE OPT_IN`wird in diesem Fall ignoriert.
+ `OptInStatus`— Ein Wert, der den Typ der Opt-in-Anfrage angibt oder eine Opt-in-Anfrage rückgängig macht. Eine Opt-in-Anfrage vom Typ `IMMEDIATE` kann nicht rückgängig gemacht werden.
Zulässige Werte:
+ `IMMEDIATE`— Wendet die Wartungsmaßnahme sofort an.
+ `NEXT_MAINTENANCE`— Wendet die Wartungsaktion im nächsten Wartungsfenster für die Ressource an.
+ `APPLY_ON`— Wendet die Wartungsaktion unabhängig vom nächsten Wartungsfenster für die Ressource am angegebenen Anwendungsdatum an.
+ `UNDO_OPT_IN`— Storniert alle bestehenden Anfragen `NEXT_MAINTENANCE` oder `APPLY_ON` Opt-In-Anfragen.
+ `CurrentApplyDate`— Wird angezeigt, falls ja opt-in-type. `APPLY_ON`
+ `Description`— Eine Beschreibung der Option für die Wartungsaktion.
### Termine anwenden
Jede Wartungsaktivität hat ein entsprechendes Anwendungsdatum, das Sie bei der Beschreibung der anstehenden Wartungsaktivität finden. Wenn Sie die Ausgabe der ausstehenden Wartungsmaßnahmen vom lesen AWS CLI, werden drei Daten aufgeführt:
+ `CurrentApplyDate`— Das Datum, an dem die Wartungsaktion entweder sofort oder während des nächsten Wartungsfensters ausgeführt wird. Wenn die Wartung optional ist, kann dieser Wert Null sein.
+ `ForcedApplyDate`— Das Datum, an dem die Wartung unabhängig von Ihrem Wartungsfenster automatisch angewendet wird.
+ `AutoAppliedAfterDate`— Das Datum, nach dem die Wartung während des Wartungsfensters des Clusters angewendet wird.
### Vom Benutzer erstellte Wartungsaktionen
Als Amazon DBelastic Document-Cluster-Benutzer können Sie Aktualisierungen Ihrer Cluster-Konfigurationen veranlassen.
**Das primäre Cluster-Passwort wird aktualisiert**
```
aws docdb-elastic update-cluster
--cluster-arn string-arn
[--admin-user-password string]
[--auth-type string-enum]
[--apply-method string-enum]
[--apply-on string-date-range]
#... other parameters of the API that follow here are not relevant for this configuration
```
Parameter:
+ **--cluster-arn**— Der Amazon Resource Name (ARN) von Amazon DocumentDB der Ressource, auf die die Wartungsmaßnahme angewendet wird.
+ **[--admin-user-password]**— Das dem Admin-Benutzer zugeordnete Passwort.
+ **[--auth-type]**— Der Authentifizierungstyp, der verwendet wird, um zu bestimmen, wo das für den Zugriff auf den Elastic Cluster verwendete Passwort abgerufen werden soll. Gültige Typen sind `PLAIN_TEXT` oder`SECRET_ARN`.
+ **[--apply-method]**— Ein Wert, der den Typ der Methode angibt, die angewendet wird. Zulässige Werte sind `IMMEDIATE` und `APPLY_ON`. Der Standardwert ist `IMMEDIATE`.
+ **[--apply-on]**— Erforderlich, wenn ja`apply-method`. `APPLY_ON` Format: `yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm` (Diese Option verwendet UTC-Zeit. Die Startzeit kann jederzeit in der future liegen und zwischen mindestens 30 Minuten und maximal 14 Tagen liegen. Das Zeitfenster von Anfang bis Ende kann mindestens 30 Minuten bis maximal 8 Stunden lang sein.)
Die Ausgabe dieses Vorgangs sieht etwa wie folgt aus (JSON-Format):
```
{
'ResourcePendingMaintenanceAction': {
'ResourceArn': 'string-arn',
'PendingMaintenanceActionDetails': [
{
'Action': 'MASTER_USER_PASSWORD_UPDATE',
'OptInStatus': 'APPLY_ON',
'CurrentApplyDate': 'string',
'Description': 'string'
},
]
}
}
```
### Ihre Amazon DocumentDB DocumentDB-Wartungsfenster ändern
Das Wartungsfenster sollte in den Zeitraum mit der geringsten Nutzung fallen und daher unter Umständen von Zeit zu Zeit geändert werden. Ihr Elastic Cluster ist während dieser Zeit nur dann nicht verfügbar, wenn Systemänderungen (z. B. eine Änderung des Speicherbetriebs) vorgenommen werden und ein Ausfall erforderlich ist. Er ist nur für den Mindestzeitraum nicht verfügbar, der erforderlich ist, um die erforderlichen Änderungen vorzunehmen.
Die Standardeinstellung ist ein 30-minütiges Fenster, das nach dem Zufallsprinzip aus einem 8-Stunden-Zeitblock für jede Amazon Web Services Services-Region ausgewählt wird und an einem zufälligen Wochentag stattfindet.
Informationen zum Ändern des Wartungsfensters finden Sie unter[Modifizieren von Elastic Cluster-Konfigurationen](elastic-managing.md#elastic-modify).
## Betriebssystem-Updates für Elastic Cluster
Elastische Amazon DocumentDB-Cluster erfordern gelegentlich Betriebssystemupdates. Amazon DocumentDB aktualisiert das Betriebssystem auf eine neuere Version, um die Datenbankleistung und die allgemeine Sicherheitslage der Kunden zu verbessern. Betriebssystemupdates ändern nicht die Cluster-Engine-Version eines elastischen Amazon DocumentDB-Clusters.
Die meisten Betriebssystemupdates für Amazon DocumentDB Elastic Clusters sind optional und haben kein festes Datum, an dem sie angewendet werden sollen. Wenn Sie diese Updates jedoch eine Zeit lang nicht installieren, werden sie möglicherweise irgendwann erforderlich und werden während des Wartungsfensters Ihres Clusters automatisch angewendet. Dies soll dazu beitragen, den Sicherheitsstatus Ihrer Datenbank aufrechtzuerhalten. Um unerwartete Ausfallzeiten zu vermeiden, empfehlen wir Ihnen, Betriebssystem-Updates auf Ihren Amazon DocumentDB Elastic Cluster zu installieren, sobald sie verfügbar sind, und Ihr Cluster-Wartungsfenster zu einem Zeitpunkt festzulegen, der Ihren Geschäftsanforderungen entspricht.