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á.
# Noções básicas sobre endpoints do Amazon DocumentDB
É possível usar endpoints do Amazon DocumentDB (compatível com MongoDB) para se conectar a um cluster ou instância. O Amazon DocumentDB tem três tipos diferentes de endpoints, cada um com sua própria finalidade.
**Topics**
+ [Localizar os endpoints de um cluster](db-cluster-endpoints-find.md)
+ [Localizar o endpoint de uma instância](db-instance-endpoint-find.md)
+ [Conectar-se a endpoints](endpoints-connecting.md)
**Endpoint do cluster**
Um endpoint de cluster é um endpoint para um cluster do Amazon DocumentDB que se conecta à instância principal atual do cluster. Cada cluster do Amazon DocumentDB tem um único endpoint de cluster e uma instância principal. No caso de um failover, o endpoint do cluster é remapeado para a nova instância principal.
**Endpoint de leitor**
Um endpoint de leitor é o endpoint de um cluster do Amazon DocumentDB que se conecta a uma das réplicas disponíveis para esse cluster. Cada cluster do Amazon DocumentDB tem um endpoint de leitor. Se houver mais de uma réplica, o endpoint de leitor direcionará cada solicitação de conexão para uma das réplicas do Amazon DocumentDB.
**Endpoint da instância**
Um endpoint de instância é um endpoint que se conecta a uma instância específica. Cada instância em um cluster, independentemente de ser uma instância principal ou de réplica, tem seu próprio endpoint de instância exclusivo. É melhor não usar endpoints de instância na sua aplicação. Isso ocorre porque eles podem alterar funções no caso de um failover, exigindo alterações de código em sua aplicação.
# Localizar os endpoints de um cluster
É 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).
------
# 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 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).
------
# Conectar-se a endpoints
Quando você tiver o endpoint, seja de cluster ou instância, você pode se conectar a ele usando o shell `mongo` ou uma string de conexão.
## Conectar-se usando o shell mongo
Use a seguinte estrutura para construir a string que você precisa para se conectar ao cluster ou à instância usando o shell `mongo`:
```
mongo \
--ssl \
--host Endpoint:Port \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
**`mongo`Exemplos de shell**
Conecte-se a um cluster:
```
mongo \
--ssl \
--host sample-cluster.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
Conecte-se a uma instância:
```
mongo \
--ssl \
--host sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
--sslCAFile global-bundle.pem \
--username UserName \
--password Password
```
## Conectar-se usando uma string de conexão
Use a seguinte estrutura para construir a string de conexão que você precisa para se conectar ao cluster ou à instância.
```
mongodb://UserName:Password@endpoint:port?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```
**Exemplos de string de conexão**
Conecte-se a um cluster:
```
mongodb://UserName:Password@sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```
Conecte-se a uma instância:
```
mongodb://UserName:Password@sample-cluster-instance.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem
```