Buscar el punto final 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 AWS Management Console

Búsqueda del punto de conexión de una instancia mediante la consola

1. Inicie sesión en la consola AWS Management Console de Amazon DocumentDB y ábrala en https://console.aws.amazon.com/docdb.

2. 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ú () en la esquina superior izquierda de la página.

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

   

4. Marque la casilla de verificación situada a la izquierda de la instancia de su interés.

5. Desplácese hacia abajo hasta la sección Details (Detalles) y localice el punto de conexión de la instancia.

   

6. Para conectarse a esta instancia, desplácese hacia abajo hasta la sección Connect (Conexión). Localice la cadena de conexión del intérprete de comandos de mongo y una cadena de conexión que pueda utilizar en el código de su aplicación para conectarse a su instancia.

   

Using the AWS CLI

Para encontrar el punto final de la instancia mediante el 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.

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]'

El resultado de esta operación tiene un aspecto parecido al siguiente (JSONformato).

[
    [
        "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]'

El resultado de esta operación tiene un aspecto parecido al siguiente (JSONformato).

[
    [
        "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 finales.