描述 Amazon DocumentDB集群 - Amazon DocumentDB
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

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

描述 Amazon DocumentDB集群

您可以使用 Amazon DocumentDB 管理控制台或 AWS CLI 查看详细信息,例如与 Amazon DocumentDB 集群相关的连接终端节点、安全组、VPC 和参数组。

有关更多信息,请参阅下列内容:

使用 AWS 管理控制台

通过以下过程使用控制台查看指定 Amazon DocumentDB集群的详细信息。

  1. 通过以下网址登录 AWS 管理控制台并打开 Amazon DocumentDB 控制台:https://console.amazonaws.cn/docdb

  2. 在导航窗格中,选择 Clusters

    提示

    如果您在屏幕左侧没有看到导航窗格,请在页面左上角选择菜单图标 ()。

  3. 在集群列表中,选择要查看其详细信息的集群的名称。有关集群的信息分为以下几组:

    • Summary (摘要) — 有关集群的一般信息,包括引擎版本、集群状态、待定维护及其参数组的状态。

    • Connectivity & Security (连接和安全)Connect (连接) 部分列出要使用 mongo shell 或应用程序连接到该集群的连接终端节点。Security Groups (安全组) 部分列出与此集群关联的安全组及其 VPC ID 和描述。

    • Configuration (配置)Cluster details (集群详细信息) 部分列出有关集群的详细信息,包括集群的 Amazon 资源名称 (ARN)、终端节点和参数组。其中还列出集群的备份信息、维护详细信息以及安全和网络设置。Cluster instances (集群实例) 部分列出属于该集群的实例,其中包括每个实例的角色和集群参数组状态。

    • Monitoring (监控) — 该集群的 Amazon CloudWatch Logs 指标。有关更多信息,请参阅使用 Amazon DocumentDB 监控 CloudWatch

    • Events & tags (事件和标签)Recent events (最近事件) 部分列出此集群的最近事件。Amazon DocumentDB 保留与集群、实例、快照、安全组和集群参数组相关的事件记录。此信息包括与每个事件关联的日期、时间和消息。Tags (标签) 部分列出附加该集群的标签。

使用 AWS CLI

要使用 Amazon DocumentDB 查看 AWS CLI 集群的详细信息,请使用 describe-db-clusters 命令,如以下示例所示。有关更多信息,请参阅 DescribeDBClusters 资源管理 API 参考 Amazon DocumentDB 中的 。

注意

对于某些管理功能(如集群和实例周期管理),Amazon DocumentDB 利用与 Amazon RDS 共享的操作技术。filterName=engine,Values=docdb 筛选器参数仅返回 Amazon DocumentDB 集群。

示例 1:列出所有Amazon DocumentDB集群

以下 AWS 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 集群的所有详细信息

以下 AWS 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 集群的特定详细信息

要使用 AWS CLI 列出集群的部分详细信息,请添加 --query,以指定 describe-db-clusters 操作要列出哪个集群成员。--db-cluster-identifier 参数是要显示其详细信息的特定集群的标识符。有关查询的更多信息,请参阅 中的--query如何使用 选项筛选输出AWS 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 } ] ] ]