查找实例的端点 - Amazon DocumentDB

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

查找实例的端点

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

Using the AWS Management Console
要使用控制台查找实例的端点

  1. 登录 AWS Management Console，然后在 /docdb 上打开亚马逊文档数据库控制台。https://console.aws.amazon.com

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

    提示

    如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (Hamburger menu icon with three horizontal lines.)。

  3. 在集群导航框中，您将看到“集群标识符”列。您的实例列于集群下，类似于以下屏幕截图。

    集群表显示了集群标识符列下的集群列表，其中实例嵌套在集群内。

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

  5. 向下滚动至 Details (详细信息) 部分，然后找到实例终端节点。

    控制台屏幕截图显示了突出显示实例端点的详情页面。

  6. 要连接到这个实例，请向上滚动到连接部分。定位 mongo Shell 的连接字符串和一个可在应用程序代码中用来连接到您实例的连接字符串。

    控制台屏幕截图显示了 Connect 部分，其中突出显示了 mongo shell 和应用程序连接字符串。
Using the AWS CLI

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

参数

  • --db-instance-identifier—可选。指定要返回端点的实例。如果省略， 将返回多达 100 个实例的端点。

  • --query—可选。指定要显示的字段。因减少您为查找端点所需查看的数据量而有益。如果省略，则返回有关实例的所有信息。Endpoint 字段有三个成员，因此在查询中列出它则返回所有三个成员，如下例所示。如果您只对部分 Endpoint 成员感兴趣，请将查询中的 Endpoint 替换为您感兴趣的成员，如第二个示例中所示。

  • --region—可选。使用 --region 参数指定要将命令应用到的区域。如果省略，则使用默认区域。

对于 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 连接到实例。有关更多信息，请参阅 连接到端点。