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.

# Búsqueda del punto de conexión de una instancia
<a name="db-instance-endpoint-find"></a>

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).

------