描述 Amazon DocumentDB实例

您可以使用 Amazon DocumentDB 管理控制台或 AWS CLI 查看详细信息，例如连接终端节点、安全组 VPC、证书颁发机构以及与您的 Amazon DocumentDB 实例相关的参数组。

使用 AWS 管理控制台

要使用 AWS 管理控制台 查看实例的详细信息，请执行以下步骤。

  1. 通过以下网址登录 AWS 管理控制台并打开 Amazon DocumentDB 控制台：https://console.aws.amazon.com/docdb。

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

    提示

    如果您在屏幕左侧没有看到导航窗格，请在页面左上角选择菜单图标 (描述 实例 - 图1)。

  3. 在“Clusters （集群）”导航窗格中，您将看到 Cluster Identifier （集群标识符） 列。您的实例将在集群下列出，与以下屏幕截图类似。

    描述 实例 - 图2

  4. 在实例列表中，选择要查看其详细信息的实例的名称。有关实例的信息分为以下几组：

    • Summary (摘要)—有关实例的一般信息，包括引擎版本、类、状态和所有待处理维护。

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

    • 配置Details （详细信息）— 部分列出实例的配置和状态，包括实例的 Amazon 资源名称 （ARN）、终端节点、角色、类和证书颁发机构。其中还列出实例的安全性和网络设置以及备份信息。Cluster details （集群详细信息） 部分列出此实例所属的集群的详细信息。Cluster instances （集群实例） 部分列出属于集群的所有实例，包括每个实例的角色和集群参数组状态。

      注意

      您可以通过选择 Cluster details （集群详细信息） 标头旁边的 Modify （修改） 来修改与实例关联的集群。有关更多信息，请参阅 修改 Amazon DocumentDB集群.

    • 监控—此实例的 CloudWatch Logs 指标。有关更多信息，请参阅 使用 Amazon DocumentDB 监控 CloudWatch.

    • Events & tags (事件和标签) —Recent events (最近事件) 部分列出此实例的最近事件。Amazon DocumentDB 保留与集群、实例、快照、安全组和集群参数组相关的事件记录。此信息包括与每个事件关联的日期、时间和消息。这些区域有： 部分列出附加到此集群的标签。有关更多信息，请参阅 为 Amazon DocumentDB 资源添加标签.

使用 AWS CLI

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

注意

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

  1. 列出所有 Amazon DocumentDB 实例。

    以下 AWS CLI 代码列出区域中所有 Amazon DocumentDB 实例的详细信息。

    对于 Linux、macOS 或 Unix:

    1. aws docdb describe-db-instances \
    2.     --filter Name=engine,Values=docdb

    对于 Windows:

    1. aws docdb describe-db-instances \
    2.     --filter Name=engine,Values=docdb

  2. 列出指定 Amazon DocumentDB 实例的所有详细信息

    以下代码列出了 的详细信息。sample-cluster-instance. 将 --db-instance-identifier 参数包含在实例名称中，会将输出限制为该特定实例的信息。

    对于 Linux、macOS 或 Unix:

    1. aws docdb describe-db-instances \
    2.     --db-instance-identifier sample-cluster-instance

    对于 Windows:

    1. aws docdb describe-db-instances \
    2.     --db-instance-identifier sample-cluster-instance

    此操作的输出将类似于以下内容：

    1. {
    2.     "DBInstances": [
    3.         {
    4.             "DbiResourceId": "db-BJKKB54PIDV5QFKGVRX5T3S6GM",
    5.             "DBInstanceArn": "arn:aws:rds:us-east-1:012345678901:db:sample-cluster-instance-00",
    6.             "VpcSecurityGroups": [
    7.                 {
    8.                     "VpcSecurityGroupId": "sg-77186e0d",
    9.                     "Status": "active"
    10.                 }
    11.             ],
    12.             "DBInstanceClass": "db.r5.large",
    13.             "DBInstanceStatus": "creating",
    14.             "AutoMinorVersionUpgrade": true,
    15.             "PreferredMaintenanceWindow": "fri:09:32-fri:10:02",
    16.             "BackupRetentionPeriod": 1,
    17.             "StorageEncrypted": true,
    18.             "DBClusterIdentifier": "sample-cluster",
    19.             "EngineVersion": "3.6.0",
    20.             "AvailabilityZone": "us-east-1a",
    21.             "Engine": "docdb",
    22.             "PromotionTier": 2,
    23.             "DBInstanceIdentifier": "sample-cluster-instance",
    24.             "PreferredBackupWindow": "00:00-00:30",
    25.             "PubliclyAccessible": false,
    26.             "DBSubnetGroup": {
    27.                 "DBSubnetGroupName": "default",
    28.                 "Subnets": [
    29.                     {
    30.                         "SubnetIdentifier": "subnet-4e26d263",
    31.                         "SubnetAvailabilityZone": {
    32.                             "Name": "us-east-1a"
    33.                         },
    34.                         "SubnetStatus": "Active"
    35.                     },
    36.                     {
    37.                         "SubnetIdentifier": "subnet-afc329f4",
    38.                         "SubnetAvailabilityZone": {
    39.                             "Name": "us-east-1c"
    40.                         },
    41.                         "SubnetStatus": "Active"
    42.                     },
    43.                     {
    44.                         "SubnetIdentifier": "subnet-b3806e8f",
    45.                         "SubnetAvailabilityZone": {
    46.                             "Name": "us-east-1e"
    47.                         },
    48.                         "SubnetStatus": "Active"
    49.                     },
    50.                     {
    51.                         "SubnetIdentifier": "subnet-53ab3636",
    52.                         "SubnetAvailabilityZone": {
    53.                             "Name": "us-east-1d"
    54.                         },
    55.                         "SubnetStatus": "Active"
    56.                     },
    57.                     {
    58.                         "SubnetIdentifier": "subnet-991cb8d0",
    59.                         "SubnetAvailabilityZone": {
    60.                             "Name": "us-east-1b"
    61.                         },
    62.                         "SubnetStatus": "Active"
    63.                     },
    64.                     {
    65.                         "SubnetIdentifier": "subnet-29ab1025",
    66.                         "SubnetAvailabilityZone": {
    67.                             "Name": "us-east-1f"
    68.                         },
    69.                         "SubnetStatus": "Active"
    70.                     }
    71.                 ],
    72.                 "VpcId": "vpc-91280df6",
    73.                 "DBSubnetGroupDescription": "default",
    74.                 "SubnetGroupStatus": "Complete"
    75.             },
    76.             "PendingModifiedValues": {},
    77.             "KmsKeyId": "arn:aws:kms:us-east-1:012345678901:key/0961325d-a50b-44d4-b6a0-a177d5ff730b"
    78.         }
    79.     ]
    80. }
    81.