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.
# Lebenszyklus einer Amazon DocumentDB DocumentDB-Instanz
Der Lebenszyklus einer Amazon DocumentDB DocumentDB-Instance umfasst das Erstellen, Ändern, Warten und Aktualisieren, das Durchführen von Backups und Wiederherstellungen, das Neustarten und Löschen der Instance. Dieser Abschnitt enthält Informationen darüber, wie Sie diese Prozesse abschließen können.
**Topics**
+ [Eine Instanz hinzufügen](db-instance-add.md)
+ [Beschreiben von Instanzen](db-instance-view-details.md)
+ [Eine Instance ändern](db-instance-modify.md)
+ [Eine Instance neu starten](db-instance-reboot.md)
+ [Eine Instance löschen](db-instance-delete.md)
Sie können eine neue Amazon DocumentDB DocumentDB-Instance mit dem AWS-Managementkonsole oder dem AWS CLI erstellen. Um eine Instance zu einem Cluster hinzuzufügen, muss sich der Cluster im Zustand *available* befinden. Zu einem angehaltenen Cluster können keine Instances hinzugefügt werden. Wenn der Cluster angehalten ist, starten Sie zuerst den Cluster, warten Sie, bis der Cluster *verfügbar* wird, und fügen Sie dann eine Instance hinzu. Weitere Informationen finden Sie unter [Einen Amazon DocumentDB-Cluster stoppen und starten](db-cluster-stop-start.md).
**Anmerkung**
Wenn Sie mit der Konsole einen Amazon DocumentDB-Cluster erstellen, wird gleichzeitig automatisch eine Instance für Sie erstellt. Wenn Sie zusätzliche Instances erstellen möchten, verwenden Sie eines der folgenden Verfahren.
# Hinzufügen einer Amazon DocumentDB DocumentDB-Instance zu einem Cluster
------
#### [ Using the AWS-Managementkonsole ]
Gehen Sie wie folgt vor, um mithilfe der Amazon DocumentDB DocumentDB-Konsole eine Instance für Ihren Cluster zu erstellen.
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. Um den Cluster zu wählen, dem Sie eine Instance hinzufügen möchten, wählen Sie die Schaltfläche links vom Namen des Clusters aus.
1. Wählen Sie **Actions (Aktionen)** und dann **Add instances (Instances hinzufügen)** aus.
1. Wiederholen Sie die folgenden Schritte für jede Instance, die Sie dem Cluster hinzufügen möchten, auf der Seite **Add instance to: (Instance hinzufügen zu:)**. Sie können bis zu 15 haben.
1. **Instance-ID** — Sie können entweder eine eindeutige Kennung für diese Instance eingeben oder Amazon DocumentDB erlauben, die Instance-ID auf der Grundlage der Cluster-ID bereitzustellen.
Einschränkungen für Instance-Benennungen:
+ 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 Instances in Amazon RDS, Neptune und Amazon DocumentDB pro AWS-Konto Region eindeutig sein.
1. **Instance-Klasse** — Wählen Sie aus der Drop-down-Liste den Instance-Typ aus, den Sie für diese Instance benötigen.
1. **Promotion-Stufe** — Wählen Sie aus der Drop-down-Liste die Promotion-Stufe für Ihre Instance oder wählen Sie *Keine Präferenz*, damit Amazon DocumentDB die Promotion-Stufe für Ihre Instance festlegen kann. Niedrigere Nummern bedeuten eine höhere Priorität. Weitere Informationen finden Sie unter [Steuerung des Failover-Ziels](failover.md#failover-target_control).
1. Zum Hinzufügen weiterer Instances wählen Sie die Option **Add additional instances (Weitere Instances hinzufügen)** und wiederholen Sie die Schritte a, b und c.
1. Schließen Sie den Vorgang ab.
+ Wenn Sie die Instances zu Ihrem Cluster hinzufügen möchten, klicken Sie auf **Create (Erstellen)**.
+ Um die Operation abzubrechen, wählen Sie **Abbrechen** aus.
Es dauert einige Minuten, bis eine Instance erstellt ist. Sie können die Konsole verwenden oder AWS CLI den Status der Instance einsehen. Weitere Informationen finden Sie unter [Den Status einer Instance überwachen](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Verwenden Sie den `create-db-instance` AWS CLI Vorgang mit den folgenden Parametern, um die primäre Instance für Ihren Cluster zu erstellen.
+ **--db-instance-class** – Erforderlich. Die Rechen- und Speicherkapazität der Instance, beispielsweise `db.m4.large`. Nicht alle Instanzklassen sind in allen verfügbar AWS-Regionen.
+ **--db-instance-identifier** – Erforderlich. Eine -Zeichenfolge in Kleinbuchstaben, die die Instance bezeichnet.
Instance-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 Instances in Amazon RDS, Neptune und Amazon DocumentDB pro AWS-Konto Region eindeutig sein.
+ **--engine** – Erforderlich. Der Wert muss `docdb` sein.
+ **--availability-zone**— Fakultativ. Die Availability Zone, in der diese Instance erstellt werden soll. Verwenden Sie diesen Parameter, um Ihre Instances in verschiedenen Availability Zones zur Erhöhung der Fehlertoleranz zu finden. Weitere Informationen finden Sie unter [Amazon DocumentDB Hochverfügbarkeit und Replikation](replication.md).
+ **--promotion-tier**— Fakultativ. Die Failover-Prioritätsstufe für diese Instance. Muss zwischen 0 und 15 liegen, wobei niedrigere Nummern eine höhere Priorität bedeuten. Weitere Informationen finden Sie unter [Steuerung des Failover-Ziels](failover.md#failover-target_control).
1. **Bestimmen Sie zunächst, in welchen Availability Zones Sie Ihre Instance erstellen können. **
Wenn Sie die Availability Zone angeben möchten, bevor Sie Ihre Instance erstellen, führen Sie den folgenden Befehl aus, um zu ermitteln, welche Availability Zones für Ihren Amazon DocumentDB-Cluster verfügbar sind.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-clusters \
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
Für Windows:
```
aws docdb describe-db-clusters ^
--query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
[
[
"sample-cluster",
[
"us-east-1c",
"us-east-1b",
"us-east-1a"
]
]
]
```
1. **Bestimmen Sie dann, welche Instance-Klassen Sie in Ihrer Region erstellen können. **
Führen Sie den folgenden Befehl aus, um festzustellen, welche Instance-Klassen Ihnen in Ihrer Region zur Verfügung stehen. Wählen Sie aus der Ausgabe eine Instance-Klasse für die Instance aus, die Sie Ihrem Amazon DocumentDB-Cluster hinzufügen möchten.
Für Linux, macOS oder Unix:
```
aws docdb describe-orderable-db-instance-options \
--engine docdb \
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
Für Windows:
```
aws docdb describe-orderable-db-instance-options ^
--engine docdb ^
--query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
[
"db.r5.16xlarge",
"db.r5.2xlarge",
"db.r5.4xlarge",
"db.r5.8xlarge",
"db.r5.large",
"db.r5.xlarge"
]
```
1. **Fügen Sie abschließend eine Instance zu Ihrem Amazon DocumentDB-Cluster hinzu.**
Um Ihrem Amazon DocumentDB-Cluster eine Instance hinzuzufügen, führen Sie den folgenden Befehl aus.
Für Linux, macOS oder Unix:
```
aws docdb create-db-instance \
--db-cluster-identifier sample-cluster \
--db-instance-identifier sample-instance-2 \
--availability-zone us-east-1b \
--promotion-tier 2 \
--db-instance-class db.r5.xlarge \
--engine docdb
```
Für Windows:
```
aws docdb create-db-instance ^
--db-cluster-identifier sample-cluster ^
--db-instance-identifier sample-instance-2 ^
--availability-zone us-east-1b ^
--promotion-tier 2 ^
--db-instance-class db.r5.xlarge ^
--engine docdb
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.xlarge",
"Engine": "docdb",
"DBInstanceStatus": "creating",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1b",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-west-2b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:11:35-sun:12:05",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 2,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2"
}
}
```
Es dauert einige Minuten, bis die Instance erstellt ist. Sie können die Konsole verwenden oder AWS CLI den Status der Instance einsehen. Weitere Informationen finden Sie unter [Den Status einer Amazon DocumentDB DocumentDB-Instance überwachen](monitoring_docdb-instance_status.md).
------
# Beschreibung von Amazon DocumentDB DocumentDB-Instances
Sie können entweder die Amazon DocumentDB-Managementkonsole oder die verwenden, AWS CLI um Details wie Verbindungsendpunkte, Sicherheitsgruppen VPCs, Zertifizierungsstellen und Parametergruppen zu Ihren Amazon DocumentDB DocumentDB-Instances anzuzeigen.
------
#### [ Using the AWS-Managementkonsole ]
Gehen Sie folgendermaßen vor, um die Details Ihrer Instances mithilfe der AWS-Managementkonsole 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. **Im Cluster-Navigationsfeld sehen Sie die Spalte Cluster-ID.** Ihre Instances werden unter Clustern aufgeführt, ähnlich wie in der Abbildung unten.
![\[Cluster-Tabelle mit einer Liste von Clustern in der Spalte Cluster-ID, wobei die Instances innerhalb von Clustern verschachtelt sind.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/choose-clusters.png)
1. Wählen Sie in der Liste der Instances den Namen der Instanz aus, deren Details Sie sehen möchten. Die Informationen über die Instance sind in die folgenden Gruppierungen unterteilt:
+ **Zusammenfassung** — Allgemeine Informationen über die Instanz, einschließlich der Engine-Version, der Klasse, des Status und aller ausstehenden Wartungsarbeiten.
+ **Konnektivität und Sicherheit** — Der Abschnitt **Connect** listet die Verbindungsendpunkte auf, um mit der Mongo-Shell oder mit einer Anwendung eine Verbindung zu dieser Instanz herzustellen. Im Abschnitt **Sicherheitsgruppen** werden die Sicherheitsgruppen aufgeführt, die dieser Instance zugeordnet sind, sowie ihre VPC-ID und Beschreibungen.
+ **Konfiguration** — Der Abschnitt „**Details**“ listet die Konfigurationen und den Status der Instance auf, einschließlich des Amazon-Ressourcennamens (ARN), des Endpunkts, der Rolle, der Klasse und der Zertifizierungsstelle der Instance. Außerdem werden die Sicherheits- und Netzwerkeinstellungen der Instance sowie die Sicherungsinformationen aufgelistet. Im Abschnitt **Cluster-Details** werden die Details des Clusters aufgeführt, zu dem diese Instance gehört. Im Abschnitt **Cluster-Instances** werden alle Instances aufgeführt, die zu Ihrem Cluster gehören, mit dem Status der einzelnen Instance-Rollen und Cluster-Parametergruppen.
**Anmerkung**
Sie können den mit Ihrer Instance verknüpften Cluster **ändern**, indem Sie neben der Überschrift **Cluster-Details** auf Ändern klicken. Weitere Informationen finden Sie unter [Ändern eines Amazon DocumentDB-Clusters](db-cluster-modify.md).
+ **Überwachung** — Die CloudWatch Log-Metriken für diese Instance. Weitere Informationen finden Sie unter [Überwachen von Amazon DocumentDB mit CloudWatch](cloud_watch.md).
+ **Ereignisse und Tags** — Der Abschnitt **Aktuelle Ereignisse** listet die jüngsten Ereignisse für diese Instance auf. 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. Weitere Informationen finden Sie unter [Taggen von Amazon DocumentDB DocumentDB-Ressourcen](tagging.md).
------
#### [ Using the AWS CLI ]
Um die Details Ihrer Amazon DocumentDB DocumentDB-Instances 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_DescribeDBInstances.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBInstances.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.
1. **Listet alle Amazon DocumentDB DocumentDB-Instances auf.**
Der folgende AWS CLI Code listet die Details für alle Amazon DocumentDB DocumentDB-Instances in einer Region auf.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
Für Windows:
```
aws docdb describe-db-instances \
--filter Name=engine,Values=docdb
```
1. **Alle Details für eine angegebene Amazon DocumentDB DocumentDB-Instance auflisten**
Der folgende Code listet die Details für `sample-cluster-instance` auf. Das Einschließen des Parameters `--db-instance-identifier` mit dem Namen einer Instance beschränkt die Ausgabe auf Informationen zu dieser bestimmten Instance.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
Für Windows:
```
aws docdb describe-db-instances \
--db-instance-identifier sample-cluster-instance
```
Die Ausgabe dieser Operation sieht folgendermaßen aus.
```
{
"DBInstances": [
{
"DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM",
"DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"DBInstanceClass": "db.r5.large",
"DBInstanceStatus": "creating",
"AutoMinorVersionUpgrade": true,
"PreferredMaintenanceWindow": "fri:09:32-fri:10:02",
"BackupRetentionPeriod": 1,
"StorageEncrypted": true,
"DBClusterIdentifier": "sample-cluster",
"EngineVersion": "3.6.0",
"AvailabilityZone": "us-east-1a",
"Engine": "docdb",
"PromotionTier": 2,
"DBInstanceIdentifier": "sample-cluster-instance",
"PreferredBackupWindow": "00:00-00:30",
"PubliclyAccessible": false,
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"Subnets": [
{
"SubnetIdentifier": "subnet-4e26d263",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-afc329f4",
"SubnetAvailabilityZone": {
"Name": "us-east-1c"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-b3806e8f",
"SubnetAvailabilityZone": {
"Name": "us-east-1e"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-53ab3636",
"SubnetAvailabilityZone": {
"Name": "us-east-1d"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-991cb8d0",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-29ab1025",
"SubnetAvailabilityZone": {
"Name": "us-east-1f"
},
"SubnetStatus": "Active"
}
],
"VpcId": "vpc-91280df6",
"DBSubnetGroupDescription": "default",
"SubnetGroupStatus": "Complete"
},
"PendingModifiedValues": {},
"KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b"
}
]
}
```
------
# Ändern einer Amazon DocumentDB DocumentDB-Instance
Sie können Ihre Amazon DocumentDB DocumentDB-Instance entweder mit dem AWS-Managementkonsole oder dem AWS CLIändern. Nur Instances im Status *available* können geändert werden. Eine angehaltene Instance kann nicht geändert werden. Wenn der Cluster angehalten ist, starten Sie zuerst den Cluster, warten Sie, bis die Instance *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 eine bestimmte Amazon DocumentDB DocumentDB-Instance mithilfe der Konsole zu ändern.
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. **Im Cluster-Navigationsfeld sehen Sie die Spalte Cluster-ID.** Ihre Instances werden unter Clustern aufgeführt, ähnlich wie in der Abbildung unten.
![\[Cluster-Tabelle mit einer Liste von Clustern in der Spalte Cluster-ID, wobei die Instances innerhalb von Clustern verschachtelt sind.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/choose-clusters.png)
1. Markieren Sie das Kästchen links neben der Instanz, die Sie ändern möchten.
1. Wählen Sie **Actions (Aktionen)** und dann **Modify (Ändern)** aus.
1. Nehmen Sie im Bereich **Modify instance: (Instance ändern: )** die gewünschten Änderungen vor. Sie können die folgenden Änderungen ausführen:
+ **Instanzspezifikationen** — Die Instanz-ID und Klasse. Benennungseinschränkungen für Instance-IDs:
+ **Instanz-ID** — Geben Sie einen Namen ein, der für alle Instances, die Ihnen gehören, AWS-Konto in der aktuellen Region eindeutig ist. Die Instance-ID muss [1—63] alphanumerische Zeichen oder Bindestriche enthalten, einen Buchstaben als erstes Zeichen haben und darf nicht mit einem Bindestrich enden oder zwei aufeinanderfolgende Bindestriche enthalten.
+ **Instance-Klasse** — Wählen Sie im Drop-down-Menü eine Instance-Klasse für Ihre Amazon DocumentDB DocumentDB-Instance aus. Weitere Informationen finden Sie unter [Instanzklassen verwalten](db-instance-classes.md).
+ **Zertifizierungsstelle** — Serverzertifikat für diese Instance. Weitere Informationen finden Sie unter [Aktualisierung Ihrer Amazon DocumentDB-TLS-Zertifikate](ca_cert_rotation.md).
+ **Failover** — Während des Failovers wird die Instanz mit der höchsten Heraufstufungsstufe zur primären Instanz heraufgestuft. Weitere Informationen finden Sie unter [Amazon DocumentDB-Failover](failover.md).
+ **Wartung** — Das Wartungsfenster, in dem ausstehende Änderungen oder Patches auf Instanzen im Cluster angewendet werden.
1. Wenn Sie fertig sind, wählen Sie **Continue (Weiter)** aus, um eine Zusammenfassung Ihrer Änderungen anzuzeigen.
1. Nachdem Sie Ihre Änderungen überprüft haben, können Sie diese sofort oder während des nächsten Wartungsfensters unter **Scheduling of modifications (Planen von Änderungen)** anwenden. Klicken Sie auf **Modify instance (Instance ändern)**, um Ihre Änderungen zu speichern. Alternativ können Sie auf **Cancel (Abbrechen)** klicken, um Ihre Änderungen zu verwerfen.
Es dauert einige Minuten, bis Ihre Änderungen übernommen werden. Sie können die Instance nur verwenden, wenn ihr Status *available* ist. Sie können mit der Konsole oder der AWS CLI den Status der Instance überwachen. Weitere Informationen finden Sie unter [Den Status einer Amazon DocumentDB DocumentDB-Instance überwachen](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Um eine bestimmte Amazon DocumentDB DocumentDB-Instance mithilfe von zu ändern AWS CLI, verwenden Sie die `modify-db-instance` mit den folgenden Parametern. Weitere Informationen finden Sie unter [Ändern DBInstance](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBInstance.html). Der folgende Code ändert die Instance-Klasse für die Instance `sample-instance` in `db.r5.large`.
**Parameters**
+ **--db-instance-identifier** – Erforderlich. Die Kennung der zu ändernden Instance.
+ **--db-instance-class**— Fakultativ. Die neue Rechen- und Speicherkapazität der Instanz; zum Beispiel`db.r5.large`. Nicht alle Instanzklassen sind in allen verfügbar AWS-Regionen. Wenn Sie die Instanzklasse ändern, kommt es während der Änderung zu einem Ausfall. Die Änderung wird im nächsten Wartungsfenster übernommen, sofern sie `ApplyImmediately` für diese Anfrage nicht als wahr angegeben wurde.
+ **--apply-immediately**oder **--no-apply-immediately** — Optional. Gibt an, ob diese Änderung sofort angewandt oder bis zum nächsten Wartungszeitraum verschoben werden sollte. Wenn dieser Parameter weggelassen wird, wird die Änderung im nächsten Wartungszeitraum ausgeführt.
**Example**
Für Linux, macOS oder Unix:
```
aws docdb modify-db-instance \
--db-instance-identifier sample-instance \
--db-instance-class db.r5.large \
--apply-immediately
```
Für Windows:
```
aws docdb modify-db-instance ^
--db-instance-identifier sample-instance ^
--db-instance-class db.r5.large ^
--apply-immediately
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
{
"DBInstances": [
{
"DBInstanceIdentifier": "sample-instance-1",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "modifying",
"Endpoint": {
"Address": "sample-instance-1.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-01-10T22:18:55.921Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1a",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:10:57-sun:11:27",
"PendingModifiedValues": {
"DBInstanceClass": "db.r5.large"
},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:sample-instance-1",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
]
}
```
Es dauert einige Minuten, bis Ihre Änderungen angewendet werden. Sie können die Instance nur verwenden, wenn ihr Status *available* ist. Sie können den Status der Instanz mit dem AWS-Managementkonsole oder überwachen AWS CLI. Weitere Informationen finden Sie unter [Den Status einer Amazon DocumentDB DocumentDB-Instance überwachen](monitoring_docdb-instance_status.md).
------
# Eine Amazon DocumentDB DocumentDB-Instance neu starten
Gelegentlich müssen Sie Ihre Amazon DocumentDB DocumentDB-Instance möglicherweise neu starten, normalerweise aus Wartungsgründen. Wenn Sie bestimmte Änderungen vornehmen, z. B. die Clusterparametergruppe, die einem Cluster zugeordnet ist, müssen Sie die Instances im Cluster neu starten, damit die Änderungen wirksam werden. Sie können eine angegebene Instance mit dem AWS-Managementkonsole oder dem AWS CLI neu starten.
Durch den Neustart einer Instance wird der Datenbank-Engine-Service neu gestartet. Das Neustarten bewirkt einen vorübergehenden Nutzungsausfall, wobei der Status für die Instance währenddessen auf `rebooting` gesetzt wird. Ein Amazon DocumentDB DocumentDB-Ereignis wird erstellt, wenn der Neustart abgeschlossen ist.
Ein Neustart einer Instance führt nicht zu einem Failover. Verwenden Sie die Operation AWS-Managementkonsole oder, um ein Failover für einen Amazon DocumentDB-Cluster durchzuführen. AWS CLI `failover-db-cluster` Weitere Informationen finden Sie unter [Amazon DocumentDB-Failover](failover.md).
Sie können Ihre Instance nicht neu starten, wenn sie sich nicht im *verfügbaren* Zustand befindet. Ihre Datenbank kann aus mehreren Gründen nicht verfügbar sein, zum Beispiel aufgrund einer zuvor angeforderten Änderung oder einer Aktion im Wartungsfenster. Weitere Informationen zu Instance-Status finden Sie unter [Den Status einer Amazon DocumentDB DocumentDB-Instance überwachen](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS-Managementkonsole ]
Das folgende Verfahren startet eine Instance neu, die Sie unter Verwendung der Konsole angeben.
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. **Im Cluster-Navigationsfeld sehen Sie die Spalte Cluster-ID.** Ihre Instances werden unter Clustern aufgeführt, ähnlich wie in der Abbildung unten.
![\[Cluster-Tabelle mit einer Liste von Clustern in der Spalte Cluster-ID, wobei die Instances innerhalb von Clustern verschachtelt sind.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/choose-clusters.png)
1. Markieren Sie das Kästchen links neben der Instance, die Sie neu starten möchten.
1. Wählen Sie **Actions (Aktionen)**, **Reboot (Neustart)** und dann **Reboot (Neustart)**aus, um den Neustart zu bestätigen.
Es dauert einige Minuten, bis Ihre Instance neu gestartet wird. Sie können die Instance nur verwenden, wenn ihr Status *available* ist. Sie können mit der Konsole oder der AWS CLI den Status der Instance überwachen. Weitere Informationen finden Sie unter [Den Status einer Amazon DocumentDB DocumentDB-Instance überwachen](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Um eine Amazon DocumentDB DocumentDB-Instance neu zu starten, verwenden Sie den `reboot-db-instance` Vorgang mit dem `--db-instance-identifier` Parameter. Dieser Parameter gibt den Bezeichner für die Instance an, die neu gestartet werden soll.
Der folgende Code startet die Instance `sample-instance` neu.
**Example**
Für Linux, macOS oder Unix:
```
aws docdb reboot-db-instance \
--db-instance-identifier sample-instance
```
Für Windows:
```
aws docdb reboot-db-instance ^
--db-instance-identifier sample-instance
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "rebooting",
"Endpoint": {
"Address": "sample-instance.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-abcd0123",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
Es dauert einige Minuten, bis Ihre Instance neu gestartet wird. Sie können die Instance nur verwenden, wenn ihr Status *available* ist. Sie können mit der Konsole oder der AWS CLI den Status der Instance überwachen. Weitere Informationen finden Sie unter [Den Status einer Amazon DocumentDB DocumentDB-Instance überwachen](monitoring_docdb-instance_status.md).
------
# Löschen einer Amazon DocumentDB DocumentDB-Instance
Sie können Ihre Amazon DocumentDB DocumentDB-Instance entweder mit dem AWS-Managementkonsole oder dem AWS CLI löschen. Nur Instances im Status *available* können gelöscht werden. Eine angehaltene Instance kann nicht gelöscht werden. Wenn der Amazon DocumentDB-Cluster, der Ihre Instance enthält, gestoppt ist, starten Sie zuerst den Cluster, warten Sie, bis die Instance *verfügbar* ist, und löschen Sie dann die Instance. Weitere Informationen finden Sie unter [Einen Amazon DocumentDB-Cluster stoppen und starten](db-cluster-stop-start.md).
**Anmerkung**
Amazon DocumentDB speichert all Ihre Daten im Cluster-Volume. Die Daten bleiben in diesem Cluster-Volume erhalten. Dies gilt auch dann, wenn Sie alle Instances von Ihrem Cluster entfernen. Wenn Sie erneut auf die Daten zugreifen müssen, können Sie jederzeit dem Cluster eine Instance hinzufügen und da fortfahren, wo Sie aufgehört haben.
------
#### [ Using the AWS-Managementkonsole ]
Das folgende Verfahren löscht eine angegebene Amazon DocumentDB DocumentDB-Instance mithilfe der Konsole.
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. **Im Cluster-Navigationsfeld sehen Sie die Spalte Cluster-ID.** Ihre Instances werden unter Clustern aufgeführt, ähnlich wie in der Abbildung unten.
![\[Cluster-Tabelle mit einer Liste von Clustern in der Spalte Cluster-ID, wobei die Instances innerhalb von Clustern verschachtelt sind.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/choose-clusters.png)
1. Markieren Sie das Kästchen links neben der Instance, die Sie löschen möchten.
1. Wählen Sie **Actions (Aktionen)** und anschließend **Delete (Löschen)** aus.
1. Wenn Sie die letzte Instance in Ihrem Cluster löschen:
+ **Create final cluster snapshot? (Endgültigen Cluster-Snapshot erstellen?)** — Wählen Sie **Ja**, wenn Sie einen endgültigen Snapshot erstellen möchten, bevor der Cluster gelöscht wird. Wählen Sie andernfalls **No (Nein)** aus.
+ **Name des endgültigen Snapshots** — Wenn Sie einen endgültigen Snapshot erstellen möchten, geben Sie die Cluster-Snapshot-ID des neu erstellten Cluster-Snapshots ein.
+ **Delete instance? (Instance löschen?)** — Geben Sie den Ausdruck **Gesamten Cluster löschen** in das Feld ein, um das Löschen zu bestätigen.
1. Wenn Sie nicht die letzte Instance in Ihrem Cluster löschen:
+ **Delete instance? (Instance löschen?)** — Geben Sie den Ausdruck **delete me** in das Feld ein, um das Löschen zu bestätigen.
1. Wählen Sie **Delete (Löschen)**, um die Instance zu löschen.
Es dauert einige Minuten, bis die Instance gelöscht ist. Informationen zum Überwachen des Status einer Instance finden Sie unter [Den Status einer Amazon DocumentDB DocumentDB-Instance überwachen](monitoring_docdb-instance_status.md).
------
#### [ Using the AWS CLI ]
Das folgende Verfahren löscht eine Amazon DocumentDB DocumentDB-Instance mithilfe von. AWS CLI
1. **Ermitteln Sie zunächst, wie viele Instances sich in Ihrem Amazon DocumentDB-Cluster befinden:**
Führen Sie den `describe-db-clusters`-Befehl wie folgt aus, um festzustellen, wie viele Instances sich in Ihrem Cluster befinden.
```
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.
```
[
[
"sample-cluster",
[
"sample-instance-1",
"sample-instance-2"
]
]
]
```
1. **Wenn es mehr als eine Instance in Ihrem Amazon DocumentDB-Cluster gibt:**
Um eine angegebene Amazon DocumentDB DocumentDB-Instance zu löschen, verwenden Sie den `delete-db-instance` Befehl mit dem `--db-instance-identifier` Parameter, wie unten gezeigt. Es dauert einige Minuten, bis die Instance gelöscht ist. Informationen zum Überwachen des Status einer Instance finden Sie unter [Den Status einer Amazon DocumentDB DocumentDB-Instance überwachen](monitoring_docdb-instance_status.md).
```
aws docdb delete-db-instance \
--db-instance-identifier sample-instance-2
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
{
"DBInstance": {
"DBInstanceIdentifier": "sample-instance-2",
"DBInstanceClass": "db.r5.large",
"Engine": "docdb",
"DBInstanceStatus": "deleting",
"Endpoint": {
"Address": "sample-instance-2.node.us-east-1.docdb.amazonaws.com",
"Port": 27017,
"HostedZoneId": "ABCDEFGHIJKLM"
},
"InstanceCreateTime": "2020-03-27T08:05:56.314Z",
"PreferredBackupWindow": "02:00-02:30",
"BackupRetentionPeriod": 1,
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"AvailabilityZone": "us-east-1c",
"DBSubnetGroup": {
"DBSubnetGroupName": "default",
"DBSubnetGroupDescription": "default",
"VpcId": "vpc-6242c31a",
"SubnetGroupStatus": "Complete",
"Subnets": [
{
"SubnetIdentifier": "subnet-abcd0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1a"
},
"SubnetStatus": "Active"
},
{
"SubnetIdentifier": "subnet-wxyz0123",
"SubnetAvailabilityZone": {
"Name": "us-east-1b"
},
"SubnetStatus": "Active"
}
]
},
"PreferredMaintenanceWindow": "sun:06:53-sun:07:23",
"PendingModifiedValues": {},
"EngineVersion": "3.6.0",
"AutoMinorVersionUpgrade": true,
"PubliclyAccessible": false,
"DBClusterIdentifier": "sample-cluster",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 1,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2",
"EnabledCloudwatchLogsExports": [
"profiler"
]
}
}
```
1. **Wenn die Instance, die Sie löschen möchten, die letzte Instance in Ihrem Amazon DocumentDB-Cluster ist:**
Wenn Sie die letzte Instance in einem Amazon DocumentDB-Cluster löschen, löschen Sie auch diesen Cluster und die mit diesem Cluster verknüpften automatischen Snapshots und kontinuierlichen Backups.
Um die letzte Instance in Ihrem Cluster zu löschen, können Sie den Cluster löschen und optional einen endgültigen Snapshot erstellen. Weitere Informationen finden Sie unter [Löschen eines Amazon DocumentDB-Clusters](db-cluster-delete.md).
------
## Löschschutz
Wenn Sie die letzte Instanz eines Amazon DocumentDB-Clusters löschen, werden auch der Cluster sowie die mit diesem Cluster verknüpften automatischen Snapshots und kontinuierlichen Backups gelöscht. Amazon DocumentDB erzwingt den Löschschutz für einen Cluster, unabhängig davon, ob Sie den Löschvorgang mit AWS-Managementkonsole oder dem 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. Weitere Informationen finden Sie unter [Löschen eines Amazon DocumentDB-Clusters](db-cluster-delete.md).