Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Comprendre les points de terminaison Amazon DocumentDB
Vous pouvez utiliser les points de terminaison Amazon DocumentDB (compatibles avec MongoDB) pour vous connecter à un cluster ou à une instance. Amazon DocumentDB possède trois types de points de terminaison différents, chacun ayant son propre objectif.
**Topics**
+ [Trouver les points de terminaison d'un cluster](db-cluster-endpoints-find.md)
+ [Trouver le point de terminaison d'une instance](db-instance-endpoint-find.md)
+ [Connexion aux points de terminaison](endpoints-connecting.md)
**Point de terminaison de cluster**
Un point de terminaison de cluster est un point de terminaison d'un cluster Amazon DocumentDB qui se connecte à l'instance principale actuelle du cluster. Chaque cluster Amazon DocumentDB possède un point de terminaison de cluster unique et une instance principale. En cas de basculement, le point de terminaison du cluster est remappé vers la nouvelle instance principale.
**Point de terminaison du lecteur**
Un point de terminaison de lecteur est un point de terminaison d'un cluster Amazon DocumentDB qui se connecte à l'une des répliques disponibles pour ce cluster. Chaque cluster Amazon DocumentDB possède un point de terminaison lecteur. S'il existe plusieurs répliques, le point de terminaison du lecteur dirige chaque demande de connexion vers l'une des répliques Amazon DocumentDB.
**Point de terminaison d'instance**
Un point de terminaison d'une instance est un point de terminaison qui se connecte à cette instance spécifique. Chaque instance d'un cluster, qu'il s'agisse d'une instance principale ou d'une instance de réplica, a son propre point de terminaison d'instance unique. Il est préférable de ne pas utiliser les points de terminaison d'instance dans votre application. En effet, ils peuvent modifier les rôles en cas de basculement, ce qui oblige à modifier le code dans votre application.
# Trouver les points de terminaison d'un cluster
Vous pouvez trouver le point de terminaison du cluster et le point de terminaison du lecteur d'un cluster à l'aide de la console Amazon DocumentDB ou. AWS CLI
------
#### [ Using the AWS Management Console ]
**Pour rechercher les points de terminaison d'un cluster à l'aide de la console :**
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le panneau de navigation, choisissez **Clusters**.
1. Dans la liste des clusters, choisissez le nom du cluster qui vous intéresse.
1. Sur la page des détails du cluster, sélectionnez l'onglet **Configuration**. Dans la section **Configurations et état**, vous trouverez le **point de terminaison du cluster** et le point de **terminaison du lecteur**.
![\[Section des configurations et de l'état présentant les points de terminaison du cluster et du lecteur.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/db-cluster-endpoints.png)
1. Pour vous connecter à ce cluster, sélectionnez l'onglet **Connectivité et sécurité**. Recherchez la chaîne de connexion pour le `mongo` shell et la chaîne de connexion qui peut être utilisée dans le code de l'application pour vous connecter à votre cluster.
![\[Section Connect affichant une chaîne pour se connecter à l'instance avec le shell mongo et une chaîne pour se connecter au cluster avec une application.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/cluster-connection-strings.png)
------
#### [ Using the AWS CLI ]
Pour rechercher les points de terminaison du cluster et du lecteur de votre cluster à l'aide de AWS CLI, exécutez la `describe-db-clusters` commande avec ces paramètres.
**Paramètres**
+ **--db-cluster-identifier**—Facultatif. Spécifiez le cluster auquel renvoyer des points de terminaison. Si cet argument n'est pas spécifié, le nombre de points de terminaison renvoyés peut atteindre 100 de vos clusters.
+ **--query**—Facultatif. Spécifiez les champs à afficher. Utile en réduisant la quantité de données que vous devez afficher pour trouver les points de terminaison. Si cela est omis, toutes les informations sur un cluster sont renvoyées.
+ **--region**—Facultatif. Utilisez le paramètre `--region` pour spécifier la région à laquelle vous souhaitez appliquer la commande. S'il n'est pas spécifié, votre région par défaut est utilisée.
**Example**
L'exemple suivant renvoie le `DBClusterIdentifier`, le point de terminaison (point de terminaison du cluster) et le `ReaderEndpoint` pour `sample-cluster`.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-clusters \
--region us-east-1 \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'
```
Pour Windows :
```
aws docdb describe-db-clusters ^
--region us-east-1 ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'
```
La sortie de cette opération ressemble à ceci (format JSON).
```
[
[
"sample-cluster",
27017,
"sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com",
"sample-cluster.cluster-ro-corlsfccjozr.us-east-1.docdb.amazonaws.com"
]
]
```
Maintenant que vous disposez du point de terminaison du cluster, vous pouvez vous connecter au cluster à l'aide de `mongo` ou `mongodb`. Pour de plus amples informations, veuillez consulter [Connexion aux points de terminaison](endpoints-connecting.md).
------
# Trouver le point de terminaison d'une instance
Vous pouvez trouver le point de terminaison d'une instance à l'aide de la console Amazon DocumentDB ou du. AWS CLI
------
#### [ Using the AWS Management Console ]
**Recherche d'un point de terminaison d'une instance à l'aide de la console**
1. [Connectez-vous à la AWS Management Console console Amazon DocumentDB et ouvrez-la à https://console.aws.amazon.com l'adresse /docdb.](https://console.aws.amazon.com/docdb)
1. Dans le panneau de navigation, choisissez **Clusters**.
**Astuce**
Si vous ne voyez pas le volet de navigation sur le côté gauche de votre écran, choisissez l'icône de menu (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/docdb-menu-icon.png)) dans le coin supérieur gauche de la page.
1. Dans la boîte de navigation Clusters, vous verrez la colonne **Cluster Identifier**. Vos instances sont répertoriées sous des clusters, comme dans la capture d'écran ci-dessous.
![\[Tableau des clusters présentant la liste des clusters sous la colonne Identifiant du cluster, avec les instances imbriquées dans les clusters.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/choose-clusters.png)
1. Cochez la case située à gauche de l'instance qui vous intéresse.
1. Faites défiler jusqu'à la rubrique **Détails**, puis localisez le point de terminaison de l'instance.
![\[Capture d'écran de la console affichant la page des détails avec le point de terminaison de l'instance en surbrillance.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/db-instance-endpoint.png)
1. Pour vous connecter à cette instance, faites défiler jusqu'à la rubrique **Connecter**. Localisez la chaîne de connexion pour le shell `mongo` et une chaîne de connexion qui peuvent être utilisées dans votre code d'application pour vous connecter à votre instance.
![\[Capture d'écran de la console montrant la section Connect avec le shell mongo et les chaînes de connexion à l'application surlignées.\]](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/instance-connection-strings.png)
------
#### [ Using the AWS CLI ]
Pour rechercher le point de terminaison de l'instance à l'aide de AWS CLI, exécutez la commande suivante avec ces arguments.
**Arguments**
+ **--db-instance-identifier**—Facultatif. Spécifie l'instance à laquelle renvoyer le point de terminaison. Si cet argument n'est pas spécifié, le nombre de points de terminaison renvoyé peut atteindre 100 de vos instances.
+ **--query**—Facultatif. Spécifiez les champs à afficher. Utile en réduisant la quantité de données que vous devez afficher pour trouver les points de terminaison. Si cela est omis, toutes les informations sur une instance sont renvoyées. Le champ `Endpoint` possède trois membres, son inclusion dans la requête comme dans l'exemple suivant renvoie donc les trois membres. Si vous êtes intéressé uniquement par certains des membres `Endpoint`, remplacez `Endpoint` dans la requête par les membres qui vous intéressent, comme dans le deuxième exemple.
+ **--region**—Facultatif. Utilisez le paramètre `--region` pour spécifier la région à laquelle vous souhaitez appliquer la commande. S'il n'est pas spécifié, votre région par défaut est utilisée.
**Example**
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-instances \
--region us-east-1 \
--db-instance-identifier sample-cluster-instance \
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
Pour Windows :
```
aws docdb describe-db-instances ^
--region us-east-1 ^
--db-instance-identifier sample-cluster-instance ^
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
La sortie de cette opération ressemble à ceci (format JSON).
```
[
[
"sample-cluster-instance",
{
"Port": 27017,
"Address": "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com",
"HostedZoneId": "Z2R2ITUGPM61AM"
}
]
]
```
En réduisant les résultats pour éliminer la `HostedZoneId` du point de terminaison, vous pouvez modifier votre requête en spécifiant `Endpoint.Port` et `Endpoint.Address`.
Pour Linux, macOS ou Unix :
```
aws docdb describe-db-instances \
--region us-east-1 \
--db-instance-identifier sample-cluster-instance \
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
Pour Windows :
```
aws docdb describe-db-instances ^
--region us-east-1 ^
--db-instance-identifier sample-cluster-instance ^
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
La sortie de cette opération ressemble à ceci (format JSON).
```
[
[
"sample-cluster-instance",
27017,
"sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com"
]
]
```
Maintenant que vous disposez du point de terminaison de l'instance, vous pouvez vous connecter à l'instance à l'aide de `mongo` ou `mongodb`. Pour de plus amples informations, veuillez consulter [Connexion aux points de terminaison](endpoints-connecting.md).
------
# Connexion aux points de terminaison
Lorsque vous avez votre point de terminaison, cluster ou instance, vous pouvez vous y connecter à l'aide du shell `mongo` ou d'une chaîne de connexion.
## Connexion à l'aide de la coque Mongo
Utilisez la structure suivante pour construire la chaîne dont vous avez besoin pour vous connecter à votre cluster ou instance à l'aide du shell `mongo` :
```
mongo \
--ssl \
--host Endpoint:Port \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
**Exemples de shell `mongo`**
Connexion à un cluster :
```
mongo \
--ssl \
--host sample-cluster.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
Connexion à une instance :
```
mongo \
--ssl \
--host sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
## Connexion à l'aide d'une chaîne de connexion
Utilisez la structure suivante pour construire la chaîne de connexion dont vous avez besoin pour vous connecter à votre cluster ou instance.
```
mongodb://UserName:Password@endpoint:port?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```
**Exemples de chaînes de connexion**
Connexion à un cluster :
```
mongodb://UserName:Password@sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```
Connexion à une instance :
```
mongodb://UserName:Password@sample-cluster-instance.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```