本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 了解 Amazon DocumentDB 端点
<a name="endpoints"></a>

您可以使用 Amazon DocumentDB（与 MongoDB 兼容）端点连接到集群或实例。Amazon DocumentDB 有三种不同类型的端点，各自具有自身用途。

**Topics**
+ [查找集群的端点](db-cluster-endpoints-find.md)
+ [查找实例的端点](db-instance-endpoint-find.md)
+ [连接到端点](endpoints-connecting.md)

**集群端点**  
集群端点是用于 Amazon DocumentDB 集群的端点，连接到该集群的当前主实例。每个 Amazon DocumentDB 集群都具有单个集群端点和一个主实例。在失效转移情况下，集群端点重新映射到新的主实例。

**读取器端点**  
读取器端点是 Amazon DocumentDB 集群的一个端点，连接到该集群的可用副本之一。每个 Amazon DocumentDB 集群都具有一个读取器端点。如果有多个副本，则读取器端点会将每个连接请求定向到 Amazon DocumentDB 副本之一。

**实例端点**  
实例终端节点是连接到特定实例的终端节点。集群中的每个实例（不论其是主实例还是副本实例）都有各自唯一的实例终端节点。最好不要使用应用程序中的实例端点。这是因为它们在发生失效转移时会更改角色，从而需要在应用程序中更改代码。

# 查找集群的端点
<a name="db-cluster-endpoints-find"></a>

您可以使用 Amazon DocumentDB 控制台或 AWS CLI 查找集群的集群端点和读取器端点。

------
#### [ Using the AWS 管理控制台 ]

**要使用控制台查找集群的端点：**

1. 登录到 AWS 管理控制台 并打开 Amazon DocumentDB 控制台，网址：[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)。

1. 在导航窗格中，选择**集群**。

1. 从集群列表中，选择感兴趣的集群的名称。

1. 在集群详细信息页面上，选择**配置**选项卡。您将在**配置和状态**部分中找到**集群端点**和**读取器端点**。  
![\[“配置和状态”部分显示了集群和读取器端点。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/db-cluster-endpoints.png)

1. 要连接到此集群，请选择**连接和安全**选项卡。查找 `mongo` Shell 的连接字符串以及可在应用程序代码中用于连接到集群的连接字符串。  
![\[“连接”部分显示了一个用于通过 mongo Shell 连接到实例的字符串以及一个用于通过应用程序连接到集群的字符串。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/cluster-connection-strings.png)

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

要使用 AWS CLI 查找集群的集群和读取器终端节点，请运行具有以下参数的 `describe-db-clusters` 命令。

**参数**
+ **--db-cluster-identifier**—可选。指定要返回端点的集群。如果省略，则返回多达 100 个集群的端点。
+ **--query**—可选。指定要显示的字段。因减少您为查找端点所需查看的数据量而有益。如果省略，则返回有关集群的全部信息。
+ **--region**—可选。使用 `--region` 参数指定要将命令应用到的区域。如果省略，则使用默认区域。

**Example**  
以下示例将返回 `DBClusterIdentifier` 的 `ReaderEndpoint`、终端节点（集群终端节点）和 `sample-cluster`。  
对于 Linux、macOS 或 Unix：  

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

```
aws docdb describe-db-clusters ^
   --region us-east-1 ^
   --db-cluster-identifier sample-cluster ^
   --query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'
```
此操作的输出将类似于下文（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"
  ]
]
```

现在您已拥有集群端点，可以使用 `mongo` 或 `mongodb` 连接到集群。有关更多信息，请参阅 [连接到端点](endpoints-connecting.md)。

------

# 查找实例的端点
<a name="db-instance-endpoint-find"></a>

您可使用 Amazon DocumentDB 控制台或 AWS CLI 查找实例的端点。

------
#### [ Using the AWS 管理控制台 ]

**要使用控制台查找实例的端点**

1. 登录到 AWS 管理控制台 并打开 Amazon DocumentDB 控制台，网址：[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)。

1. 在导航窗格中，选择**集群**。
**提示**  
如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/docdb-menu-icon.png))。

1. 在集群导航框中，您将看到“**集群标识符**”列。您的实例列于集群下，类似于以下屏幕截图。  
![\[“集群”表显示了“集群标识符”列下的集群列表，其中实例嵌套在集群内。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/choose-clusters.png)

1. 选中您感兴趣的实例左侧的框。

1. 向下滚动至 **Details (详细信息)** 部分，然后找到实例终端节点。  
![\[控制台屏幕截图显示了突出显示实例端点的详情页面。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/db-instance-endpoint.png)

1. 要连接到这个实例，请向上滚动到**连接**部分。定位 `mongo` Shell 的连接字符串和一个可在应用程序代码中用来连接到您实例的连接字符串。  
![\[控制台屏幕截图显示了突出显示 mongo Shell 和应用程序连接字符串的“连接”部分。\]](http://docs.aws.amazon.com/zh_cn/documentdb/latest/developerguide/images/instance-connection-strings.png)

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

要使用 AWS CLI 查找实例终端节点，请运行带有以下参数的命令。

**参数**
+ **--db-instance-identifier**—可选。指定要返回端点的实例。如果省略， 将返回多达 100 个实例的端点。
+ **--query**—可选。指定要显示的字段。因减少您为查找端点所需查看的数据量而有益。如果省略，则返回有关实例的所有信息。`Endpoint` 字段有三个成员，因此在查询中列出它则返回所有三个成员，如下例所示。如果您只对部分 `Endpoint` 成员感兴趣，请将查询中的 `Endpoint` 替换为您感兴趣的成员，如第二个示例中所示。
+ **--region**—可选。使用 `--region` 参数指定要将命令应用到的区域。如果省略，则使用默认区域。

**Example**  
对于 Linux、macOS 或 Unix：  

```
aws docdb describe-db-instances \
    --region us-east-1 \
    --db-instance-identifier sample-cluster-instance \
    --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
对于 Windows：  

```
aws docdb describe-db-instances ^
    --region us-east-1 ^
    --db-instance-identifier sample-cluster-instance ^
    --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'
```
此操作的输出将类似于下文（JSON 格式）。  

```
[
    [
        "sample-cluster-instance",
        {
            "Port": 27017,
            "Address": "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com",
            "HostedZoneId": "Z2R2ITUGPM61AM"
        }
    ]
]
```
减少输出以消除终端节点的 `HostedZoneId`，可通过指定 `Endpoint.Port` 和 `Endpoint.Address` 来修改查询。  
对于 Linux、macOS 或 Unix：  

```
aws docdb describe-db-instances \
    --region us-east-1 \
    --db-instance-identifier sample-cluster-instance \
    --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
对于 Windows：  

```
aws docdb describe-db-instances ^
    --region us-east-1 ^
    --db-instance-identifier sample-cluster-instance ^
    --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'
```
此操作的输出将类似于下文（JSON 格式）。  

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

现在您已拥有实例端点，可以使用 `mongo` 或 `mongodb` 连接到实例。有关更多信息，请参阅 [连接到端点](endpoints-connecting.md)。

------

# 连接到端点
<a name="endpoints-connecting"></a>

当您拥有自己的端点（集群或实例）时，可以使用 `mongo` Shell 或连接字符串连接到该端点。

## 使用 mongo Shell 连接
<a name="endpoints-connecting-mongo"></a>

使用以下结构来构造您需要使用 `mongo` Shell 连接到自身集群或实例的字符串：

```
mongo \
    --ssl \
    --host Endpoint:Port \
    --sslCAFile global-bundle.pem \
    --username UserName \
    --password Password
```

**`mongo` Shell 示例**  
连接到集群：

```
mongo \
    --ssl \
    --host sample-cluster.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
    --sslCAFile global-bundle.pem \
    --username UserName \
    --password Password
```

连接到实例：

```
mongo \
    --ssl \
    --host sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com:27017 \
    --sslCAFile global-bundle.pem \
    --username UserName \
    --password Password
```

## 使用连接字符串连接
<a name="endpoints-connecting-mongodb"></a>

使用以下结构来构造您需要连接到自身集群或实例的连接字符串：

```
mongodb://UserName:Password@endpoint:port?replicaSet=rs0&ssl_ca_certs=global-bundle.pem 
```

**连接字符串示例**  
连接到集群：

```
mongodb://UserName:Password@sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem 
```

连接到实例：

```
mongodb://UserName:Password@sample-cluster-instance.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com:27017?replicaSet=rs0&ssl_ca_certs=global-bundle.pem 
```