Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Descripción de los puntos de conexión de Amazon DocumentDB
Puede usar los puntos de conexión de Amazon DocumentDB (con compatibilidad con MongoDB) para conectarse a un clúster o a una instancia. Amazon DocumentDB tiene tres tipos diferentes de puntos de conexión, cada uno con su propia finalidad.
**Topics**
+ [Búsqueda de puntos de conexión de un clúster](db-cluster-endpoints-find.md)
+ [Búsqueda del punto de conexión de una instancia](db-instance-endpoint-find.md)
+ [Conexión a puntos de conexión](endpoints-connecting.md)
**Punto de conexión de clúster**
Un punto de conexión de clúster es un punto de conexión de un clúster de Amazon DocumentDB que se conecta a la instancia principal actual del clúster. Cada clúster de Amazon DocumentDB tiene un solo punto de conexión de clúster y una sola instancia principal. En caso de que se produzca una conmutación por error, el punto de conexión del clúster se reasigna a la nueva instancia principal.
**Punto de conexión del lector**
Un punto de conexión del lector es un punto de conexión de un clúster de Amazon DocumentDB que se conecta a una de las réplicas disponibles de ese clúster. Cada clúster de base de datos de Amazon DocumentDB tiene un punto de conexión del lector. Si hay más de una réplica, el punto de conexión del lector dirige cada solicitud de conexión a una de las réplicas de Amazon DocumentDB.
**Punto de conexión de instancia**
Un punto de conexión de una instancia es aquel que se conecta a una instancia específica. Cada instancia de un clúster, independientemente de si es una instancia principal o de réplica, tiene su propio punto de conexión de instancia único. Es mejor no usar puntos de conexión de instancias en las aplicaciones. Esto se debe a que pueden cambiar los roles en caso de una conmutación por error, lo que obligaría a realizar modificaciones en el código de la aplicación.
# Búsqueda de puntos de conexión de un clúster
Puede buscar el punto de conexión de clúster de un clúster y el punto de conexión del lector mediante la consola de Amazon DocumentDB o la AWS CLI.
------
#### [ Using the Consola de administración de AWS ]
**Cómo encontrar los puntos de conexión de un clúster mediante la consola:**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon DocumentDB en [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. En el panel de navegación, seleccione **Clusters (Clústeres)**.
1. En la lista de clústeres, seleccione el nombre del clúster de su interés.
1. En la página de detalles del clúster, elija la pestaña **Configuración**. En la sección **Configuraciones y estado**, encontrará el **Punto de conexión del clúster** y el **Punto de conexión del lector**.
![\[La sección Configuraciones y estado muestra los puntos de conexión del clúster y del lector.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-cluster-endpoints.png)
1. Para conectarse a este clúster, seleccione la pestaña **Conectividad y seguridad**. Localice la cadena de conexión del shell de `mongo` y una cadena de conexión que pueda utilizar en el código de la aplicación para conectarse a su clúster.
![\[La sección Conectar muestra una cadena para conectarse a la instancia con el shell de mongo y una cadena para conectarse al clúster con una aplicación.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/cluster-connection-strings.png)
------
#### [ Using the AWS CLI ]
Para buscar los puntos de conexión del clúster y del lector para su clúster con la AWS CLI, ejecute el comando `describe-db-clusters` con estos parámetros.
**Parámetros**
+ **--db-cluster-identifier**: opcional. Especifica el clúster para el que se van a devolver puntos de conexión. Si se omite, devuelve los puntos de conexión de hasta 100 clústeres.
+ **--query**: opcional. Especifica los campos para mostrar. Sirve para reducir la cantidad de datos que se necesitan consultar para encontrar los puntos de conexión. Si se omite, se devuelve toda la información de un clúster.
+ **--region**: opcional. Utilice el parámetro `--region` para especificar la región a la que desea aplicar el comando. Si se omite, se utiliza la región predeterminada.
**Example**
En el siguiente ejemplo, se devuelve el punto de conexión `DBClusterIdentifier` (punto de conexión del clúster) y `ReaderEndpoint` para `sample-cluster`.
Para Linux, macOS o Unix:
```
aws docdb describe-db-clusters \
--region us-east-1 \
--db-cluster-identifier sample-cluster \
--query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'
```
Para Windows:
```
aws docdb describe-db-clusters ^
--region us-east-1 ^
--db-cluster-identifier sample-cluster ^
--query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'
```
La salida de esta operación será similar a lo que se indica a continuación (formato 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"
]
]
```
Ahora que tiene el punto de conexión del clúster, puede conectarse al clúster mediante `mongo` o `mongodb`. Para obtener más información, consulte [Conexión a puntos de conexión](endpoints-connecting.md).
------
# Búsqueda del punto de conexión de una instancia
Puede encontrar los puntos de conexión para una instancia de base de datos mediante la consola de Amazon DocumentDB o la AWS CLI.
------
#### [ Using the Consola de administración de AWS ]
**Búsqueda del punto de conexión de una instancia mediante la consola**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon DocumentDB en [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. En el panel de navegación, seleccione **Clusters (Clústeres)**.
**sugerencia**
Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/docdb-menu-icon.png)) en la esquina superior izquierda de la página.
1. En el cuadro de navegación de clústeres, verá la columna **Identificador del clúster**. Las instancias se muestran en clústeres, de forma similar a la siguiente captura de pantalla.
![\[Tabla de clústeres que muestra la lista de clústeres en la columna de identificador de clúster, con instancias anidadas dentro de los clústeres.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/choose-clusters.png)
1. Marque la casilla de verificación situada a la izquierda de la instancia de su interés.
1. Desplácese hacia abajo hasta la sección **Details (Detalles)** y localice el punto de conexión de la instancia.
![\[Captura de pantalla de la consola que muestra la página de detalles con el punto de conexión de la instancia resaltado.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/db-instance-endpoint.png)
1. Para conectarse a esta instancia, desplácese hacia abajo hasta la sección **Connect (Conexión)**. Localice la cadena de conexión del shell de `mongo` y una cadena de conexión que pueda utilizar en el código de su aplicación para conectarse a su instancia.
![\[Captura de pantalla de la consola que muestra la sección Conexión del shell de mongo y cadenas de conexión de la aplicación resaltadas.\]](http://docs.aws.amazon.com/es_es/documentdb/latest/developerguide/images/instance-connection-strings.png)
------
#### [ Using the AWS CLI ]
Para buscar el punto de conexión de la instancia mediante la AWS CLI, ejecute el siguiente comando con estos argumentos.
**Argumentos**
+ **--db-instance-identifier**: opcional. Especifica la instancia para la que se va a devolver el punto de conexión. Si se omite, se devuelve el punto de conexión de hasta 100 instancias.
+ **--query**: opcional. Especifica los campos para mostrar. Sirve para reducir la cantidad de datos que se necesitan consultar para encontrar los puntos de conexión. Si se omite, se devuelve toda la información de la instancia. El campo `Endpoint` tiene tres miembros, por lo que la consulta del siguiente ejemplo devuelve los tres miembros. Si solo está interesado en algunos de los miembros de `Endpoint` sustituya `Endpoint` en la consulta por los miembros de su interés, tal y como se muestra en el segundo ejemplo.
+ **--region**: opcional. Utilice el parámetro `--region` para especificar la región a la que desea aplicar el comando. Si se omite, se utiliza la región predeterminada.
**Example**
Para Linux, macOS o Unix:
```
aws docdb describe-db-instances \
--region us-east-1 \
--db-instance-identifier sample-cluster-instance \
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
Para Windows:
```
aws docdb describe-db-instances ^
--region us-east-1 ^
--db-instance-identifier sample-cluster-instance ^
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
La salida de esta operación será similar a lo que se indica a continuación (formato JSON).
```
[
[
"sample-cluster-instance",
{
"Port": 27017,
"Address": "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com",
"HostedZoneId": "Z2R2ITUGPM61AM"
}
]
]
```
Reduciendo el resultado para eliminar el `HostedZoneId` del punto de conexión, puede modificar su consulta especificando `Endpoint.Port` y `Endpoint.Address`.
Para Linux, macOS o Unix:
```
aws docdb describe-db-instances \
--region us-east-1 \
--db-instance-identifier sample-cluster-instance \
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
Para Windows:
```
aws docdb describe-db-instances ^
--region us-east-1 ^
--db-instance-identifier sample-cluster-instance ^
--query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
La salida de esta operación será similar a lo que se indica a continuación (formato JSON).
```
[
[
"sample-cluster-instance",
27017,
"sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com"
]
]
```
Ahora que tiene el punto de conexión de la instancia, puede conectarse a la instancia mediante `mongo` o `mongodb`. Para obtener más información, consulte [Conexión a puntos de conexión](endpoints-connecting.md).
------
# Conexión a puntos de conexión
Cuando tenga su punto de conexión, ya sea del clúster o de la instancia, puede conectarse a él utilizando el shell de `mongo` o una cadena de conexión.
## Conexión mediante el shell de mongo
Utilice la siguiente estructura para crear la cadena que necesita para conectarse a su clúster o instancia mediante el shell de `mongo`:
```
mongo \
--ssl \
--host Endpoint:Port \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
**Ejemplos del shell de `mongo`**
Conectarse a un clúster:
```
mongo \
--ssl \
--host sample-cluster.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
Conectarse a una instancia:
```
mongo \
--ssl \
--host sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
## Conexión mediante una cadena de conexión
Utilice la siguiente estructura para crear la cadena de conexión que necesita para conectarse a su clúster o instancia.
```
mongodb://UserName:Password@endpoint:port?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```
**Ejemplos de cadenas de conexión**
Conectarse a un clúster:
```
mongodb://UserName:Password@sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```
Conectarse a una instancia:
```
mongodb://UserName:Password@sample-cluster-instance.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```