本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
描述 Amazon DocumentDB
您可以使用 Amazon DocumentDB 管理控制台或Amazon CLI查看与您的 Amazon DocumentDB 集群相关的连接终端节点、安全组、VPC 和参数组等详细信息。
有关更多信息，请参阅下列内容：
使用 Amazon Web Services Management Console
使用控制台，通过下列程序查看指定 Amazon DocumentDB 集群的详细信息。
登录。Amazon Web Services Management Console，然后打开Amazon DocumentDB B 控制台https://console.aws.amazon.com/docdb
. -
在导航窗格中，选择 Clusters。
提示
如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (
)。 -
在集群列表中，选择要查看其详细信息的集群的名称。有关集群的信息分为以下几组：
-
摘要— 有关集群的一般信息，包括引擎版本、集群状态、待维护及其参数组的状态。
-
连接与安全—连接部分列出了使用 mongo shell 或应用程序连接到此集群的连接端点。Security Groups (安全组) 部分列出与此集群关联的安全组及其 VPC ID 和描述。
-
配置— 这个集群详细信息部分列出了有关该集群的详细信息，包括该集群的 Amazon Resource Name (ARN)、终端节点和参数组。其中还列出集群的备份信息、维护详细信息以及安全和网络设置。Cluster instances (集群实例) 部分列出属于该集群的实例，其中包括每个实例的角色和集群参数组状态。
-
监控— 亚马逊 CloudWatch 记录此集群的指标。有关更多信息，请参阅 使用 CloudWatch 监控 Amazon DocumentDB。
-
活动和标签— 这个近期事件部分列出了该集群的最新事件。Amazon DocumentDB 将记录与您的集群、实例、快照、安全组和集群参数组相关的事件。此信息包括与每个事件关联的日期、时间和消息。Tags (标签) 部分列出附加该集群的标签。
-
使用 Amazon CLI
要查看您的Amazon DocumentDB B 集群的详细信息，请使用Amazon CLI，使用describe-db-clusters命令如以下示例所示。有关更多信息，请参阅DescribeDBClusters在Amazon DocumentDB B 资源管理 API 参考.
注意
对于某些管理功能，例如集群和实例生命周期管理，Amazon DocumentDB 利用了与 Amazon RDS 共享的操作技术。这些区域有：filterName=engine,Values=docdb筛选参数仅返回Amazon DocumentDB B 集群。
示例 1：列出所有Amazon DocumentDB B 集群
以下Amazon CLI代码列出了某个区域内所有 Amazon DocumentDB 集群的详细信息。
aws docdb describe-db-clusters --filter Name=engine,Values=docdb
此操作的输出将类似于下文。
{
"DBClusters": [
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-1",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-2",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-3",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
}
]
}
示例 2：列出指定 Amazon DocumentDB 集群的所有详细信息
以下 Amazon CLI 代码列出集群 sample-cluster 的详细信息。
对于 Linux、macOS 或 Unix：
aws docdb describe-db-clusters \ --filter Name=engine,Values=docdb \ --db-cluster-identifier sample-cluster
对于 Windows：
aws docdb describe-db-clusters ^ --filter Name=engine,Values=docdb ^ --db-cluster-identifier sample-cluster
此操作的输出将类似于下文。
{
"DBClusters": [
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
"EarliestRestorableTime": "2020-03-09T00:04:26.844Z",
"Endpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com",
"ReaderEndpoint": "sample-cluster.node.us-east-1.docdb.amazonaws.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "4.0.0",
"LatestRestorableTime": "2020-03-10T20:38:17.456Z",
"Port": 27017,
"MasterUsername": "<user-name>",
"PreferredBackupWindow": "00:00-00:30",
"PreferredMaintenanceWindow": "tue:09:50-tue:10:20",
"DBClusterMembers": [
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": false,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abcd0123",
"Status": "active"
}
],
"HostedZoneId": "ABCDEFGHIJKLMN",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
"DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
"AssociatedRoles": [],
"ClusterCreateTime": "2020-01-10T22:13:38.261Z",
"EnabledCloudwatchLogsExports": [
"profiler"
],
"DeletionProtection": true
}
]
}
示例 3：列出 Amazon DocumentDB 集群的具体详细信息
要使用 Amazon CLI 列出集群的部分详细信息，请添加 --query，以指定 describe-db-clusters 操作要列出哪个集群成员。--db-cluster-identifier 参数是要显示其详细信息的特定集群的标识符。有关查询的更多信息，请参阅如何使用过滤输出--query选项在Amazon Command Line Interface用户指南.
以下示例列出了 Amazon DocumentDB 集群中的实例。
对于 Linux、macOS 或 Unix：
aws docdb describe-db-clusters \ --filter Name=engine,Values=docdb \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterMembers]'
对于 Windows：
aws docdb describe-db-clusters ^ --filter Name=engine,Values=docdb ^ --db-cluster-identifier sample-cluster ^ --query 'DBClusters[*].[DBClusterMembers]'
此操作的输出将类似于下文。
[
[
[
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-instance-2",
"IsClusterWriter": false,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
]
]
]