Búsqueda del punto de conexión de una instancia - Amazon DocumentDB

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 AWS Management Console
Búsqueda del punto de conexión de una instancia mediante la consola

  1. Inicie sesión en la AWS Management Console y abra la consola de Amazon DocumentDB 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ú (Hamburger menu icon with three horizontal lines.) 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.

    DocumentDB clusters list showing two clusters with their identifiers and roles.

  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.

    Captura de pantalla de la consola que muestra la página de detalles con el punto de conexión de la instancia resaltado.

  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.

    Captura de pantalla de la consola que muestra la sección de conexión del intérprete de comandos de mongo y cadenas de conexión de la aplicación resaltadas.
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.

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.