Localizar o endpoint de uma instância - Amazon DocumentDB

Localizar o endpoint de uma instância

É possível encontrar o endpoint de uma instância de banco de dados usando o console do Amazon DocumentDB ou a AWS CLI.

Using the AWS Management Console
Para localizar o endpoint de uma instância usando o console

  1. Faça login no AWS Management Console e abra o console do Amazon DocumentDB em https://console.aws.amazon.com/docdb.

  2. No painel de navegação, escolha Clusters.

    dica

    Caso não visualize o painel de navegação à esquerda da tela, selecione o ícone do menu (Hamburger menu icon with three horizontal lines.) no canto superior esquerdo da página.

  3. Na caixa de navegação Clusters, você verá a coluna Identificador do Cluster. Suas instâncias estão listadas em clusters, semelhante ao snapshot abaixo.

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

  4. Marque a caixa à esquerda da instância na qual você está interessado.

  5. Role para baixo até a seção Detalhes, em seguida, localize o endpoint da instância.

    Captura de tela do console mostrando a página de detalhes com o endpoint da instância destacado.

  6. Para se conectar a essa instância, role até a seção Conectar. Localize a string de conexão para o shell mongo e uma string de conexão que pode ser usada no código do aplicativo para se conectar à instância.

    Captura de tela do console mostrando a seção de conexão com as strings de conexão do shell do Mongo e do aplicativo destacadas.
Using the AWS CLI

Para localizar o endpoint da instância usando a AWS CLI, execute o seguinte comando com esses argumentos.

Argumentos

  • --db-instance-identifier—Opcional. Especifica a instância para a qual retornar o endpoint. Se omitido, retorna o endpoint para até 100 das suas instâncias.

  • --query—Opcional. Especifica os campos a serem exibidos. Isso é útil ao reduzir a quantidade de dados que você precisa visualizar para localizar os endpoints. Se omitido, todas as informações em uma instância serão retornadas. O campo Endpoint tem três membros, portanto, listá-lo na consulta, como no exemplo a seguir, retorna todos os três membros. Se você quiser apenas alguns dos membros Endpoint, substitua Endpoint na consulta pelos membros desejados, como no segundo exemplo.

  • --region—Opcional. Use o parâmetro --region para especificar a região à qual deseja aplicar o comando. Se omitido, sua região padrão será usada.

Para Linux, macOS ou 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]'

A saída dessa operação é semelhante ao seguinte (formato JSON).

[
    [
        "sample-cluster-instance",
        {
            "Port": 27017,
            "Address": "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com",
            "HostedZoneId": "Z2R2ITUGPM61AM"
        }
    ]
]

Ao reduzir a saída para eliminar o HostedZoneIddo endpoint, é possível modificar sua consulta especificando Endpoint.Port e Endpoint.Address.

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

Para Windows:

aws docdb describe-db-instances ^
    --region us-east-1 ^
    --db-instance-identifier sample-cluster-instance ^
    --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'

A saída dessa operação é semelhante ao seguinte (formato JSON).

[
    [
        "sample-cluster-instance",
        27017,
        "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com"
    ]
]

Agora que você tem o endpoint de instância, é possível se conectar à instância usando o mongo ou o mongodb. Para obter mais informações, consulte Conectar-se a endpoints.