Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Verwaltung von Amazon DocumentDB DocumentDB-Instances
Die folgenden Themen enthalten Informationen, die Ihnen bei der Verwaltung Ihrer Amazon DocumentDB DocumentDB-Instances helfen sollen. Sie umfassen Details über Instance-Klassen und Statusarten und das Erstellen, Löschen und Ändern einer Instance.
**Topics**
+ [Den Status einer Instance ermitteln](#db-instance-status)
+ [Instance-Lebenszyklus](db-instance-life-cycle.md)
+ [Instanzklassen verwalten](db-instance-classes.md)
+ [NVMe-gestützte Instances](db-instance-nvme.md)
## Den Status einer Instance ermitteln
Mehr zu den gültigen Instance-Zuständen, ihre Bedeutung und die Bestimmung des Status Ihrer Instances finden Sie unter [Den Status einer Amazon DocumentDB DocumentDB-Instance überwachen](monitoring_docdb-instance_status.md).
# 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).
# Instanzklassen verwalten
Die Instance-Klasse bestimmt die Rechenleistung und Speicherkapazität einer Amazon DocumentDB DocumentDB-Instance (mit MongoDB-Kompatibilität). Welche Instance-Klasse Sie benötigen, hängt von der benötigten Rechenleistung und dem Speicherbedarf ab.
Amazon DocumentDB unterstützt die Instance-Klassen R4, R5, R6G, R8G, T3 und T4G. Diese Klassen sind Instance-Klassen der aktuellen Generation, die für speicherintensive Anwendungen optimiert sind. Die Spezifikationen dieser Klassen finden Sie unter [Spezifikationen der Instanzklasse](#db-instance-class-specs).
**Topics**
+ [Bestimmung einer Instance-Klasse](#db-instance-class-determining)
+ [Die Klasse einer Instance ändern](#db-instance-class-changing)
+ [Unterstützte Instance-Klassen nach Region](#db-instance-classes-by-region)
+ [Spezifikationen der Instanzklasse](#db-instance-class-specs)
## Bestimmung einer Instance-Klasse
Um die Klasse einer Instanz zu ermitteln, können Sie die `describe-db-instances` AWS CLI Operation AWS-Managementkonsole oder verwenden.
------
#### [ Using the AWS-Managementkonsole ]
Führen Sie die folgenden Schritte in der Konsole aus, um die Instanzklasse für die Instances Ihres Clusters zu ermitteln.
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. Wählen Sie im Navigationsbereich **Clusters** aus, um die Instance zu finden, an der Sie interessiert sind.
**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 Navigationsfeld „Cluster“ sehen Sie die Spalte **Cluster-ID**. Ihre Instances werden unter Clustern aufgeführt, ähnlich wie in der Abbildung unten.
![\[Die Cluster-Tabelle zeigt, wie eine Instance unter einem Cluster verschachtelt ist.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/choose-clusters.png)
1. Erweitern Sie in der Liste der Instances den Cluster, um die Instances zu finden, an denen Sie interessiert sind. Suchen Sie die gewünschte Instanz. Sehen Sie sich dann in der Spalte **Größe** der Zeile der Instanz die Instanzklasse an.
In der folgenden Abbildung ist die Instance-Klasse für die Instance `robo3t` `db.r5.4xlarge`.
![\[Liste der Instances in der Cluster-Tabelle, wobei in der Spalte Größe der Instance-Typ angezeigt wird.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/instance-class.png)
------
#### [ Using the AWS CLI ]
Verwenden Sie die `describe-db-instances` Operation mit den folgenden Parametern AWS CLI, um die Klasse einer Instance mithilfe von zu ermitteln.
+ **--db-instance-identifier**— Fakultativ. Gibt die Instance an, für die Sie die Instance-Klasse suchen möchten. Wenn dieser Parameter ausgelassen wird, gibt `describe-db-instances` eine Beschreibung für bis zu 100 Ihrer Instances zurück.
+ **--query**— Fakultativ. Gibt die Mitglieder der Instance an, die in die Ergebnisse einbezogen werden sollen. Wenn dieser Parameter ausgelassen wird, werden alle Instance-Mitglieder zurückgegeben.
**Example**
Im folgenden Beispiel werden der Instanzname und die Klasse für die Instanz ermittelt`sample-instance-1`.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
--db-instance-identifier sample-instance-1
```
Für Windows:
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
--db-instance-identifier sample-instance-1
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
[
[
"sample-instance-1",
"db.r5.large"
]
```
**Example**
Das folgende Beispiel ermittelt den Instanznamen und die Klasse für bis zu 100 Amazon DocumentDB DocumentDB-Instances.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-instances \
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' \
--filter Name=engine,Values=docdb
```
Für Windows:
```
aws docdb describe-db-instances ^
--query 'DBInstances[*].[DBInstanceIdentifier,DBInstanceClass]' ^
--filter Name=engine,Values=docdb
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
```
[
[
"sample-instance-1",
"db.r5.large"
],
[
"sample-instance-2",
"db.r5.large"
],
[
"sample-instance-3",
"db.r5.4xlarge"
],
[
"sample-instance-4",
"db.r5.4xlarge"
]
]
```
Weitere Informationen finden Sie unter [Beschreibung von Amazon DocumentDB DocumentDB-Instances](db-instance-view-details.md).
------
## Die Klasse einer Instance ändern
Sie können die Instanzklasse Ihrer Instanz mit dem AWS-Managementkonsole oder dem ändern AWS CLI. Weitere Informationen finden Sie unter [Ändern einer Amazon DocumentDB DocumentDB-Instance](db-instance-modify.md).
## Unterstützte Instance-Klassen nach Region
Amazon DocumentDB unterstützt die folgenden Instance-Klassen:
+ `R8G`—Speicheroptimierte Instances der neuesten Generation mit ARM-basierten AWS Graviton4-Prozessoren, die im Vergleich zu R6G-Instances eine um bis zu 30% bessere Leistung bieten.
+ `R6G`—Speicheroptimierte Instances mit ARM-basierten AWS Graviton2-Prozessoren, die eine um bis zu 30% bessere Leistung als R5-Instances bei 5% geringeren Kosten bieten.
+ `R6GD`— Speicheroptimierte R6G-Instances mit lokalem Solid-State-Drive-Speicher (SSD) auf Basis von nichtflüchtigem Memory Express () für kurzlebige Daten. NVMe
+ `R5`— Speicheroptimierte Instances, die bei gleichen Instance-Kosten eine bis zu 100% bessere Leistung als R4-Instances bieten.
+ `R4`— Frühere Generation speicheroptimierter Instances.
+ `T4G`—Kostengünstiger Allzweck-Instance-Typ der neuesten Generation, der auf ARM-basierten AWS Graviton2-Prozessoren basiert und eine grundlegende CPU-Leistung bietet, ein um bis zu 35% besseres Preis-Leistungs-Verhältnis als T3-Instances bietet und sich ideal für die Ausführung von Anwendungen mit moderater CPU-Auslastung eignet, bei denen es zu vorübergehenden Auslastungsspitzen kommt.
+ `T3`— Kostengünstiger Burstable-Instance-Typ für allgemeine Zwecke, der eine grundlegende CPU-Leistung bietet und die Möglichkeit bietet, die CPU-Auslastung jederzeit und so lange wie nötig zu erhöhen.
Detaillierte Angaben zu den Instance-Klassen finden Sie unter [Spezifikationen der Instanzklasse](#db-instance-class-specs).
**Anmerkung**
I/O-optimierter Speicher ist nur in den Engine-Versionen 5.0 und 8.0 (instanzbasierte Cluster) verfügbar.
Eine bestimmte Instanzklasse kann in einer bestimmten Region unterstützt werden oder auch nicht. Die folgende Tabelle gibt an, welche Instance-Klassen von Amazon DocumentDB in jeder Region unterstützt werden.
**Unterstützte Instance-Klassen nach Region**
| | Instance-Klassen | Region | R8G | R6GD | R6G | R5 | R4 | T4 G | T3 | Serverless |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| USA Ost (Ohio) | Unterstützt | Unterstützt | Unterstützt | Unterstützt | Unterstützt | Unterstützt | Unterstützt | Unterstützt |
| USA Ost (Nord-Virginia) | Unterstützt | Unterstützt | Unterstützt | Unterstützt | Unterstützt | Unterstützt | Unterstützt | Unterstützt |
| USA West (Oregon) | Unterstützt | Unterstützt | Unterstützt | Unterstützt | Unterstützt | Unterstützt | Unterstützt | Unterstützt |
| Afrika (Kapstadt) | | | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| Südamerika (São Paulo) | | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| Asien-Pazifik (Hongkong) | | | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| Asien-Pazifik (Hyderabad) | | | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| Asien-Pazifik (Malaysia) | | | Unterstützt | | | Unterstützt | Unterstützt | |
| Asien-Pazifik (Mumbai) | Unterstützt | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| Asien-Pazifik (Osaka) | | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | |
| Asien-Pazifik (Seoul) | Unterstützt | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| Asien-Pazifik (Sydney) | Unterstützt | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| Asien-Pazifik (Jakarta) | Unterstützt | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | |
| Asien-Pazifik (Melbourne) | | | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | |
| Asien-Pazifik (Singapur) | Unterstützt | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| Asien-Pazifik (Thailand) | | | Unterstützt | | | Unterstützt | Unterstützt | |
| Asien-Pazifik (Tokio) | Unterstützt | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| Kanada (Zentral) | | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| Europa (Frankfurt) | Unterstützt | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| Europa (Zürich) | | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | |
| Europa (Irland) | Unterstützt | Unterstützt | Unterstützt | Unterstützt | Unterstützt | Unterstützt | Unterstützt | Unterstützt |
| Europa (London) | | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| Europa (Milan) | | | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| Europa (Paris) | | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| Europa (Spain) | Unterstützt | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| Europa (Stockholm) | Unterstützt | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | |
| Mexiko (Zentral) | | | Unterstützt | | | Unterstützt | Unterstützt | |
| Naher Osten (VAE) | | | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| China (Peking) | | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| China (Ningxia) | | | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| Israel (Tel Aviv) | | | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| AWS GovCloud (US-West) | Unterstützt | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
| AWS GovCloud (US-Ost) | | Unterstützt | Unterstützt | Unterstützt | | Unterstützt | Unterstützt | Unterstützt |
## Spezifikationen der Instanzklasse
Die folgende Tabelle enthält Einzelheiten zu den Amazon DocumentDB DocumentDB-Instance-Klassen, einschließlich der Instance-Typen, die in den einzelnen Klassen unterstützt werden. Erläuterungen zu den einzelnen Tabellenspalten finden Sie unterhalb der Tabelle.
| Instance-Klasse | vCPU1 | Speicher (GiB) 2 | NVMe Mehrstufiger SSD-Cache (GiB) 3 | Max. Speichertemperatur (GiB) 4 | Basis-/Burst-Bandbreite (Gbit/s) 5 | Unterstützende Engines 6 |
| --- | --- | --- | --- | --- | --- | --- |
| R8G — Speicheroptimierte Instance-Klasse der aktuellen Generation, die auf Graviton4 basiert R8G ist die neueste Instance-Familie (Graviton4), die nur in den Engine-Versionen 5.0 und 8.0 verfügbar ist. Die Größen db.r8g.24xlarge und db.r8g.48xlarge sind noch nicht verfügbar. |
| db.r8g.large | 2 | 16 | - | 30 | 0,937 / 12,5 | 5.0.0 und 8.0.0 |
| db.r8g.xlarge | 4 | 32 | - | 60 | 1,875 / 12,5 | 5.0.0 und 8.0.0 |
| db.r8g.2xlarge | 8 | 64 | - | 121 | 3,75 / 15,0 | 5.0.0 und 8.0.0 |
| db.r8g.4xlarge | 16 | 128 | - | 243 | 7,5 / 15,0 | 5.0.0 und 8.0.0 |
| db.r8g.8xlarge | 32 | 256 | - | 488 | 15 | 5.0.0 und 8.0.0 |
| db.r8g.12xlarge | 48 | 384 | - | 732 | 22 | 5.0.0 und 8.0.0 |
| db.r8g.16xlarge | 64 | 512 | - | 987 | 30 | 5.0.0 und 8.0.0 |
| R6G — Speicheroptimierte Instance-Klasse der aktuellen Generation, die auf Graviton2 basiert |
| db.r6g.large | 2 | 16 | - | 32 | 0,75/10 | 4.0.0, 5.0.0 und 8.0.0 |
| db.r6g.xlarge | 4 | 32 | - | 63 | 1,25/10 | 4.0.0, 5.0.0 und 8.0.0 |
| db.r6g.2xlarge | 8 | 64 | - | 126 | 2.5/10 | 4.0.0, 5.0.0 und 8.0.0 |
| db.r6g.4xlarge | 16 | 128 | - | 252 | 5.0/10 | 4.0.0, 5.0.0 und 8.0.0 |
| db.r6g.8xlarge | 32 | 256 | - | 504 | 12 | 4.0.0, 5.0.0 und 8.0.0 |
| db.r6g.12xlarge | 48 | 384 | - | 756 | 20 | 4.0.0, 5.0.0 und 8.0.0 |
| db.r6g.16xlarge | 64 | 512 | - | 1008 | 25 | 4.0.0, 5.0.0 und 8.0.0 |
| R6GD — Von der aktuellen Generation NVMe unterstützte Instance-Klasse, die auf Graviton2 basiert |
| db.r6gd.xlarge | 4 | 32 | 173 | 64 | 1,25/10 | 5.0.0 und 8.0.0 |
| db.r6gd.2xlarge | 8 | 64 | 346 | 128 | 2,5/10 | 5.0.0 und 8.0.0 |
| db.r6gd.4xlarge | 16 | 128 | 694 | 256 | 5,0/10 | 5.0.0 und 8.0.0 |
| db.r6gd.8xlarge | 32 | 256 | 1388 | 512 | 12 | 5.0.0 und 8.0.0 |
| db.r6gd.12xlarge | 48 | 384 | 2082 | 768 | 20 | 5.0.0 und 8.0.0 |
| db.r6gd.16xlarge | 64 | 512 | 2776 | 1024 | 25 | 5.0.0 und 8.0.0 |
| R5 — Speicheroptimierte Instance-Klasse der vorherigen Generation |
| db.r5.large | 2 | 16 | - | 31 | 0,75/10 | 3.6.0, 4.0.0, 5.0.0 und 8.0.0 |
| db.r5.xlarge | 4 | 32 | - | 62 | 1,25/10 | 3.6.0, 4.0.0, 5.0.0 und 8.0.0 |
| db.r5.2xlarge | 8 | 64 | - | 124 | 2,5/10 | 3.6.0, 4.0.0, 5.0.0 und 8.0.0 |
| db.r5.4xlarge | 16 | 128 | - | 249 | 5.0/10 | 3.6.0, 4.0.0, 5.0.0 und 8.0.0 |
| db.r5.8xlarge | 32 | 256 | - | 504 | 10 | 3.6.0, 4.0.0, 5.0.0 und 8.0.0 |
| db.r5.12xlarge | 48 | 384 | - | 748 | 12 | 3.6.0, 4.0.0, 5.0.0 und 8.0.0 |
| db.r5.16xlarge | 64 | 512 | - | 1008 | 20 | 3.6.0, 4.0.0, 5.0.0 und 8.0.0 |
| db.r5.24xlarge | 96 | 768 | - | 1500 | 25 | 3.6.0, 4.0.0, 5.0.0 und 8.0.0 |
| R4 — Speicheroptimierte Instance-Klasse der vorherigen Generation R4-Instances werden nur in der Engine-Version 3.6 unterstützt. Beachten Sie, dass der Standardsupport für Amazon DocumentDB 3.6 am 30. März 2026 endet. Extended Support (kostenpflichtig) ist bis März 2029 verfügbar. |
| db.r4.large | 2 | 15,25 | - | 30 | 0,75/10 | nur 3.6.0 |
| db.r4.xlarge | 4 | 30,5 | - | 60 | 1,25/10 | nur 3.6.0 |
| db.r4.2xlarge | 8 | 61 | - | 120 | 2,5/10 | nur 3.6.0 |
| db.r4.4xlarge | 16 | 122 | - | 240 | 5,0 /10 | nur 3.6.0 |
| db.r4.8xlarge | 32 | 244 | - | 480 | 10 | nur 3.6.0 |
| db.r4.16xlarge | 64 | 488 | - | 960 | 25 | nur 3.6.0 |
| T4G — Instance-Klassen mit Burstable Performance der neuesten Generation, die auf Graviton2 basieren Instances der T-Serie werden im Burst-Modus „Unlimited CPU“ ausgeführt. Eine Burst-Nutzung, die über den Basiswert hinausgeht, wird zusätzlich in Rechnung gestellt. Wird für globale Cluster nicht unterstützt. |
| db.t4g.medium | 2 | 4 | - | 8.13 | 0,256/5 | 4.0.0, 5.0.0 und 8.0.0 |
| T3 — Instance-Klassen mit Burstable Performance der vorherigen Generation |
| db.t3.medium | 2 | 4 | - | 7,5 | 0,256/5 | 3.6.0, 4.0.0, 5.0.0 und 8.0.0 |
| [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/db-instance-classes.html) |
# NVMe-gestützte Instances
NVMe-gestützte Instances bieten eine bis zu 7-mal schnellere Abfrageleistung für Anwendungen mit großen Datensätzen, die den Arbeitsspeicher einer regulären Instanz überschreiten. Diese Instances nutzen den lokalen Solid-State-Drive-Speicher (SSDNVMe) auf der Basis von Non-Volatile Memory Express (), der auf r6gd-Instances verfügbar ist, um kurzlebige Daten zu speichern, den netzwerkbasierten Speicherzugriff zu reduzieren und die Leselatenz und den Durchsatz zu verbessern.
Der lokale SSD-Speicherplatz ist in zwei Abschnitte unterteilt:
+ **Mehrstufiger Cache** — Ungefähr 73% der lokalen SSD sind als Datenbank-Cache zugewiesen, sodass das System bis zu fünfmal mehr Datenbankseiten speichern kann als der Hauptspeicher allein. Die lokale SSD fungiert als Cache der zweiten Ebene, während der vorhandene In-Memory-Buffer-Cache der Cache der ersten Ebene bleibt. Die Abfrage greift nur dann auf externen Speicher zu, wenn sowohl im Puffer-Cache als auch im SSD-Cache ein Fehler auftritt.
+ **Temporärer Speicher** — Die restlichen 27% sind für nicht persistenten temporären Dateispeicher reserviert, der für komplexe Abfragen mit Sortieroperationen oder ressourcenintensiven Vorgängen wie Indexerstellungen verwendet wird. Bei regulären Instances befindet sich der temporäre Speicherplatz auf einem Amazon Elastic Block Store (EBS) -Volume. Der lokal gehostete temporäre Speicher auf der SSD reduziert die Abfragelatenz bei Sortierungen um das bis zu Zweifache und beschleunigt ressourcenintensive Operationen wie Indexerstellungen.
Einzelheiten zum Typ der NVMe unterstützten Instanzen und zu deren Spezifikationen finden Sie unter. [Spezifikationen der Instanzklasse](db-instance-classes.md#db-instance-class-specs)
**Topics**
+ [Empfohlene Anwendungsfälle für NVMe -gestützte Instances](#nvme-use-cases)
+ [Verwenden von NVMe -gestützten Instances mit Amazon DocumentDB](#using-nvme)
+ [Instances, die von der Überwachung unterstützt werden NVMe](#monitoring-nvme)
## Empfohlene Anwendungsfälle für NVMe -gestützte Instances
Wir empfehlen Ihnen, in den folgenden Szenarien Instances mit NVMe -backed zu verwenden:
+ **Leseintensive Workloads** — Wenn Ihre Arbeitslast leseintensiv ist und Ihr Datensatz größer als der Puffer-Cache ist, was durch niedrige `BufferCacheHitRatio` und hohe `ReadIOPS` Messwerte gekennzeichnet ist, können NVMe -Instances Leistungsvorteile bieten.
+ **Aktualisierungsintensive Workloads — Wenn Ihre Arbeitslast aktualisierungsintensiv ist und die Garbage-Collection** aufgrund der Leselatenz im Netzwerkspeicher nicht Schritt halten kann, können Instances, die auf dem Netzwerkspeicher basieren, helfen, das Problem zu beheben. NVMe
NVMe-gestützte Instances können für verschiedene Anwendungsfälle von Vorteil sein, darunter:
+ Anwendungen auf **Internetebene — Anwendungen** wie Zahlungsabwicklung, Rechnungsstellung und E-Commerce, für die strenge Service Level Agreements (SLAs) gelten, können die Leistungsvorteile von NVMe Instances nutzen, die auf dem System basieren.
+ Dashboards für **Berichte in Echtzeit — Dashboards**, die Hunderte von Abfragen zur Erfassung von Metriken und Daten ausführen, können von der geringen Latenz und dem hohen Durchsatz unterstützter Instanzen profitieren. NVMe
+ **Generative KI-Anwendungen — Anwendungen**, die die Vektorsuche verwenden, um anhand von Millionen von Vektor-Einbettungen exakte oder nächstgelegene Nachbarn zu finden, können die hohe Leistung von -gestützten Instances nutzen. NVMe
## Verwenden von NVMe -gestützten Instances mit Amazon DocumentDB
Um Instanzen von Amazon NVMe DocumentDB zu verwenden, gehen Sie wie folgt vor:
+ Erstellen Sie einen Amazon DocumentDB-Cluster und fügen Sie eine der NVMe -gestützten Instance-Klassen hinzu. Weitere Informationen finden Sie unter [Einen Amazon DocumentDB-Cluster erstellen](db-cluster-create.md).
+ Sie können auch einen vorhandenen Amazon DocumentDB-Cluster so ändern, dass er eine der Instance-Klassen mit NVMe -backed verwendet. Weitere Informationen finden Sie unter [Ändern eines Amazon DocumentDB-Clusters](db-cluster-modify.md).
Informationen zur Überprüfung der Verfügbarkeit von Instances mit NVMe -Unterstützung in verschiedenen AWS Regionen finden Sie unter. [Unterstützte Instance-Klassen nach Region](db-instance-classes.md#db-instance-classes-by-region)
Wenn Sie von einer NVMe -gestützten Instance zu einer regulären Instance zurückkehren möchten, ändern Sie die Datenbank-Instance-Klasse Ihrer Amazon DocumentDB DocumentDB-Instance in eine ähnliche Instance-Klasse ohne Speicher. NVMe Wenn Ihre aktuelle Instance-Klasse beispielsweise 'db.r6gd.4xlarge' ist, wählen Sie 'db.r6g.4xlarge', um zurückzuschalten. Weitere Informationen finden Sie unter [Ändern eines Amazon DocumentDB-Clusters](db-cluster-modify.md).
## Instances, die von der Überwachung unterstützt werden NVMe
Zusätzlich zu den regulären Instance-Metriken, die bei Amazon verfügbar sind CloudWatch, geben NVMe -gestützte Instances zusätzliche Metriken aus, die sich NVMe auf SSD-basierten Speicher, IOPS und Durchsatz beziehen.
```
NVMeStorageCacheHitRatio
FreeNVMeStorage
ReadIOPSNVMeStorage
ReadLatencyNVMeStorage
ReadThroughputNVMeStorage
WriteIOPSNVMeStorage
WriteLatencyNVMeStorage
WriteThroughputNVMeStorage
```
Weitere Informationen zu diesen Metriken finden Sie unter [NVMe-gestützte Instance-Metriken](cloud_watch.md#nvme-metrics)