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.
# Grundlegendes zu Amazon DocumentDB DocumentDB-Endpunkten
Sie können Amazon DocumentDB DocumentDB-Endpunkte (mit MongoDB-Kompatibilität) verwenden, um eine Verbindung zu einem Cluster oder einer Instance herzustellen. Amazon DocumentDB hat drei verschiedene Arten von Endpunkten, von denen jeder seinen eigenen Zweck hat.
**Topics**
+ [Die Endpunkte eines Clusters finden](db-cluster-endpoints-find.md)
+ [Den Endpunkt einer Instanz finden](db-instance-endpoint-find.md)
+ [Verbindung zu Endpunkten herstellen](endpoints-connecting.md)
**Cluster-Endpunkt**
Ein Cluster-Endpunkt ist ein Endpunkt für einen Amazon DocumentDB-Cluster, der eine Verbindung zur aktuellen primären Instance für den Cluster herstellt. Jeder Amazon DocumentDB-Cluster hat einen einzelnen Cluster-Endpunkt und eine primäre Instance. Im Falle eines Failovers wird der Cluster-Endpunkt auf die neue primäre Instance umgeschaltet.
**Leser-Endpunkt**
Ein Reader-Endpunkt ist ein Endpunkt für einen Amazon DocumentDB-Cluster, der eine Verbindung zu einem der verfügbaren Replikate für diesen Cluster herstellt. Jeder Amazon DocumentDB-Cluster hat einen Leser-Endpunkt. Wenn es mehr als ein Replikat gibt, leitet der Leser-Endpunkt jede Verbindungsanfrage an eines der Amazon DocumentDB DocumentDB-Replikate weiter.
**Instance-Endpunkt**
Ein Instance-Endpunkt ist ein Endpunkt, der sich mit einer bestimmten Instance verbindet. Jede Instance in einem Cluster, unabhängig davon, ob es sich um eine primäre oder eine Replikat-Instance handelt, hat ihren eigenen eindeutigen Instance-Endpunkt. Sie sollten keine Instance-Endpunkte in Ihrer Anwendung verwenden. Denn diese können im Falle eines Failovers Rollen ändern, sodass Code-Änderungen in Ihrer Anwendung erforderlich sind.
# Die Endpunkte eines Clusters finden
Sie können den Cluster-Endpunkt und den Reader-Endpunkt eines Clusters mithilfe der Amazon DocumentDB DocumentDB-Konsole oder AWS CLI finden.
------
#### [ Using the AWS-Managementkonsole ]
**Um die Endpunkte eines Clusters mithilfe der Konsole zu finden:**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Klicken Sie im Navigationsbereich auf **Cluster**.
1. Wählen Sie aus der Liste der Cluster den Namen des Clusters, der Sie interessiert.
1. **Wählen Sie auf der Seite mit den Cluster-Details die Registerkarte Konfiguration aus.** Im Abschnitt **Konfigurationen und Status** finden Sie den **Cluster-Endpunkt** und den **Reader-Endpunkt**.
![\[Der Abschnitt Konfigurationen und Status zeigt die Cluster- und Reader-Endpunkte.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-cluster-endpoints.png)
1. Um eine Verbindung zu diesem Cluster herzustellen, wählen Sie die Registerkarte **Konnektivität und Sicherheit**. Suchen Sie die Verbindungszeichenfolge für die `mongo` Shell und die Verbindungszeichenfolge, die im Anwendungscode verwendet werden kann, um eine Verbindung zu Ihrem Cluster herzustellen.
![\[Verbindungsabschnitt mit einer Zeichenfolge für die Verbindung mit der Instanz mit der Mongo-Shell und einer Zeichenfolge für die Verbindung mit dem Cluster mit einer Anwendung.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/cluster-connection-strings.png)
------
#### [ Using the AWS CLI ]
Um die Cluster- und Reader-Endpunkte für Ihren Cluster mithilfe von zu finden AWS CLI, führen Sie den `describe-db-clusters` Befehl mit diesen Parametern aus.
**Parameter**
+ **--db-cluster-identifier**— Optional. Gibt den Cluster an, für den die Endpunkte zurückgegeben werden sollen. Wenn diese Option weggelassen wird, werden Endpunkte für bis zu 100 Ihrer Cluster zurückgegeben.
+ **--query**—Fakultativ. Gibt die anzuzeigenden Felder an. Dies ist hilfreich, da die Datenmenge, die Sie anzeigen müssen, um die Endpunkte zu finden, reduziert wird. Wenn diese Option weggelassen wird, werden alle Informationen über einen Cluster zurückgegeben.
+ **--region**—Fakultativ. Verwenden Sie den Parameter `--region`, um die Region anzugeben, für die Sie den Befehl anwenden möchten. Wenn diese Angabe weggelassen wird, wird Ihre Standardregion verwendet.
**Example**
Das folgende Beispiel liefert die Werte `DBClusterIdentifier`, Endpunkt (Cluster-Endpunkt) und `ReaderEndpoint` für `sample-cluster`.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-clusters \
--region us-east-1 \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'
```
Für Windows:
```
aws docdb describe-db-clusters ^
--region us-east-1 ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
[
[
"sample-cluster",
27017,
"sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com",
"sample-cluster.cluster-ro-corlsfccjozr.us-east-1.docdb.amazonaws.com"
]
]
```
Nachdem Sie nun den Cluster-Endpunkt haben, können Sie sich mit `mongo` oder `mongodb` mit dem Cluster verbinden. Weitere Informationen finden Sie unter [Verbindung zu Endpunkten herstellen](endpoints-connecting.md).
------
# Den Endpunkt einer Instanz finden
Sie können den Endpunkt für eine Instance mithilfe der Amazon DocumentDB DocumentDB-Konsole oder der AWS CLI finden.
------
#### [ Using the AWS-Managementkonsole ]
**So suchen Sie den Endpunkt einer Instance über die 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.
![\[Die 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, an der Sie interessiert sind.
1. Scrollen Sie nach unten zum Abschnitt **Details** und suchen Sie dann den Instance-Endpunkt.
![\[Konsolen-Screenshot mit der Detailseite mit hervorgehobenem Instance-Endpunkt.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/db-instance-endpoint.png)
1. Um eine Verbindung zu dieser Instance herzustellen, scrollen Sie nach oben zum Abschnitt **Connect (Verbinden)**. Suchen Sie die Verbindungszeichenfolge für die `mongo`-Shell und eine Verbindungszeichenfolge, die im Anwendungscode verwendet werden kann, um eine Verbindung zu Ihrer Instance herzustellen.
![\[Screenshot der Konsole, der den Connect-Abschnitt mit hervorgehobenen Verbindungszeichenfolgen für die Mongo-Shell und die Anwendung zeigt.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/instance-connection-strings.png)
------
#### [ Using the AWS CLI ]
Führen Sie den folgenden Befehl mit diesen Argumenten aus AWS CLI, um den Instanzendpunkt mithilfe von zu finden.
**Argumente**
+ **--db-instance-identifier**— Optional. Gibt die Instance an, für die der Endpunkt zurückgegeben werden soll. Wenn diese Option weggelassen wird, wird der Endpunkt für bis zu 100 Ihrer Instances zurückgegeben.
+ **--query**—Fakultativ. Gibt die anzuzeigenden Felder an. Dies ist hilfreich, da die Datenmenge, die Sie anzeigen müssen, um die Endpunkte zu finden, reduziert wird. Wenn diese Option weggelassen wird, werden alle Informationen zu einer Instance zurückgegeben. Das Feld `Endpoint` hat drei Mitglieder, sodass die Auflistung in der Abfrage wie im folgenden Beispiel alle drei Mitglieder zurückgibt. Wenn Sie nur an einigen der `Endpoint`-Mitglieder interessiert sind, ersetzen Sie `Endpoint` in der Abfrage durch die Mitglieder, die Sie interessieren, wie im zweiten Beispiel.
+ **--region**—Fakultativ. Verwenden Sie den Parameter `--region`, um die Region anzugeben, für die Sie den Befehl anwenden möchten. Wenn diese Angabe weggelassen wird, wird Ihre Standardregion verwendet.
**Example**
Für Linux, macOS oder Unix:
```
aws docdb describe-db-instances \
--region us-east-1 \
--db-instance-identifier sample-cluster-instance \
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
Für Windows:
```
aws docdb describe-db-instances ^
--region us-east-1 ^
--db-instance-identifier sample-cluster-instance ^
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
[
[
"sample-cluster-instance",
{
"Port": 27017,
"Address": "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com",
"HostedZoneId": "Z2R2ITUGPM61AM"
}
]
]
```
Wenn Sie die Ausgabe reduzieren, um die `HostedZoneId` des Endpunkts zu eliminieren, können Sie Ihre Abfrage ändern, indem Sie `Endpoint.Port` und `Endpoint.Address` festlegen.
Für Linux, macOS oder Unix:
```
aws docdb describe-db-instances \
--region us-east-1 \
--db-instance-identifier sample-cluster-instance \
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
Für Windows:
```
aws docdb describe-db-instances ^
--region us-east-1 ^
--db-instance-identifier sample-cluster-instance ^
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus (JSON-Format).
```
[
[
"sample-cluster-instance",
27017,
"sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com"
]
]
```
Nachdem Sie nun den Instance-Endpunkt haben, können Sie sich mit `mongo` oder `mongodb` mit der Instance verbinden. Weitere Informationen finden Sie unter [Verbindung zu Endpunkten herstellen](endpoints-connecting.md).
------
# Verbindung zu Endpunkten herstellen
Wenn Sie Ihren Endpunkt, entweder Cluster oder Instance, haben, können Sie sich über die `mongo`-Shell oder eine Verbindungszeichenfolge mit ihm verbinden.
## Verbindung über die Mongo-Shell herstellen
Verwenden Sie die folgende Struktur, um die Zeichenfolge zu erstellen, die Sie für die Verbindung zu Ihrem Cluster oder Ihrer Instance über die `mongo`-Shell benötigen:
```
mongo \
--ssl \
--host Endpoint:Port \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
**`mongo`-Shell-Beispiele**
Verbinden mit einem Cluster:
```
mongo \
--ssl \
--host sample-cluster.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
Verbindung zu einer Instance herstellen:
```
mongo \
--ssl \
--host sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
## Verbindung über eine Verbindungszeichenfolge herstellen
Verwenden Sie die folgende Struktur, um die Verbindungszeichenfolge zu erstellen, die Sie für die Verbindung zu Ihrem Cluster oder Ihrer Instance benötigen.
```
mongodb://UserName:Password@endpoint:port?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```
**Beispiele für Verbindungszeichenfolgen**
Verbinden mit einem Cluster:
```
mongodb://UserName:Password@sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```
Verbindung zu einer Instance herstellen:
```
mongodb://UserName:Password@sample-cluster-instance.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```