As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Localizar o endpoint de uma instância
<a name="db-instance-endpoint-find"></a>

É 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 Console de gerenciamento da AWS ]

**Para localizar o endpoint de uma instância usando o console**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon DocumentDB em [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).

1. 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.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/docdb-menu-icon.png)) no canto superior esquerdo da página.

1. 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.  
![\[Tabela de clusters mostrando a lista de clusters na coluna Identificador de cluster, com instâncias aninhadas dentro de clusters.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/choose-clusters.png)

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

1. 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.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-instance-endpoint.png)

1. 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 da aplicação para se conectar à instância.  
![\[Captura de tela do console, mostrando a seção Conectar com as strings de conexão do shell do mongo e da aplicação destacadas.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/instance-connection-strings.png)

------
#### [ 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.

**Example**  
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 `HostedZoneId`do 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](endpoints-connecting.md).

------