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 os endpoints de um cluster
<a name="db-cluster-endpoints-find"></a>

É possível localizar o endpoint do cluster e o endpoint do leitor usando o console ou a Amazon DocumentDB do AWS CLI.

------
#### [ Using the Console de gerenciamento da AWS ]

**Para localizar os endpoints de um cluster 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**.

1. Na lista de clusters, escolha o nome do cluster desejado.

1. Na página de detalhes do cluster, selecione a guia **Configuração**. Na seção **Configurações e status**, você encontrará o **Endpoint do cluster** e o **Endpoint do leitor**.  
![\[Seção Configurações e status mostrando os endpoints do cluster e do leitor.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/db-cluster-endpoints.png)

1. Para se conectar a esse cluster, selecione a guia **Conectividade e segurança**. Localize a string de conexão para o shell do `mongo` e a string de conexão que pode ser usada no código da aplicação para se conectar ao cluster.  
![\[Seção Conectar, mostrando uma string para se conectar à instância com o shell do mongo e uma string para se conectar ao cluster com uma aplicação.\]](http://docs.aws.amazon.com/pt_br/documentdb/latest/developerguide/images/cluster-connection-strings.png)

------
#### [ Using the AWS CLI ]

Para localizar os endpoints do cluster e do leitor para seu cluster usando a AWS CLI, execute o seguinte comando `describe-db-clusters` com esses parâmetros.

**Parâmetros**
+ **--db-cluster-identifier**—Opcional. Especifica o cluster para o qual retornar os endpoints. Se omitido, retorna endpoints para até 100 dos seus clusters.
+ **--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 sobre um cluster serão retornadas.
+ **--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**  
O exemplo a seguir retorna o `DBClusterIdentifier`, o endpoint (endpoint de cluster) e o `ReaderEndpoint` para o `sample-cluster`.  
Para Linux, macOS ou Unix:  

```
aws docdb describe-db-clusters \
   --region us-east-1 \
   --db-cluster-identifier sample-cluster \
   --query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'
```
Para Windows:  

```
aws docdb describe-db-clusters ^
   --region us-east-1 ^
   --db-cluster-identifier sample-cluster ^
   --query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'
```
A saída dessa operação é semelhante ao seguinte (formato JSON).  

```
[
  [
     "sample-cluster",
     27017,
     "sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com",
     "sample-cluster.cluster-ro-corlsfccjozr.us-east-1.docdb.amazonaws.com"
  ]
]
```

Agora que você tem o endpoint de cluster, é possível se conectar ao cluster usando o `mongo` ou o `mongodb`. Para obter mais informações, consulte [Conectar-se a endpoints](endpoints-connecting.md).

------