本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
描述 Amazon DocumentDB 集群
您可以使用 Amazon DocumentDB 管理主控台或查看與 Amazon DocumentDB 叢集相關的詳細資訊,例如連線端點VPCs、安全群組和參數群組。 AWS CLI
如需詳細資訊,請參閱下列內容:
- Using the AWS Management Console
-
請使用下列程序,使用主控台檢視指定 Amazon DocumentDB 叢集的詳細資料。
登入 AWS Management Console,然後在 https://console.aws.amazon.com/docdb 開啟 Amazon DocumentDB 主控台。
-
在導覽窗格中,選擇叢集。
提示
如果畫面左側沒有出現導覽窗格,請選擇頁面左上角的功能表圖示 (
)。
-
在叢集清單中,選擇想要檢視詳細資訊的叢集名稱。叢集的相關資訊分為下列群組:
-
摘要 — 叢集的一般資訊,包括引擎版本、叢集狀態、擱置維護,以及其參數群組的狀態。
-
連線與安全性 —「Connect 線」區段會列出使用 mongo Shell 或應用程式連線至此叢集的連線端點。「安全群組」段落會列出與此叢集關聯的安全群組及其 VPC ID 和說明。
-
組態 — 叢集詳細資料區段列出有關叢集的詳細資訊,包括叢集的 Amazon 資源名稱 (ARN)、端點和參數群組。它也會列出叢集的備份資訊、維護詳細資訊,以及安全性和網路設定。Cluster instances (叢集執行個體) 區段會列出屬於您此叢集的執行個體,當中每個執行個體的角色和叢集參數群組狀態。
-
監控 — 此叢集的 Amazon CloudWatch 日誌指標。如需詳細資訊,請參閱使用監控 Amazon DocumentDB CloudWatch。
-
事件與標籤 — [最近的事件] 區段會列出此叢集的最近事件。Amazon DocumentDB 會保留與叢集、執行個體、快照、安全群組和叢集參數群組相關的事件記錄。此資訊包括與每個事件相關聯的日期、時間和訊息。Tags (標籤) 區段會列出連接至此叢集的標籤。
-
- Using the AWS CLI
-
若要使用檢視 Amazon DocumentDB 叢集的詳細資料 AWS CLI,請使用下
describe-db-clusters
列範例所示的命令。如需詳細資訊,請參閱 Amazon 文件資料庫資源管理API參考資料DescribeDBClusters
中的。注意
對於某些管理功能,例如叢集和執行個體生命週期管理,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 文件資料庫叢集的所有詳細資料
下列 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": [ { "AllocatedStorage": 1, "AvailabilityZones": [ "us-east-1c", "us-east-1a", "us-east-1d" ], "BackupRetentionPeriod": 2, "DBClusterIdentifier": "sample-cluster", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", "EarliestRestorableTime": "2023-11-07T22:34:08.148000+00:00", "Endpoint": "sample-cluster.node.us-east-1.amazon.com", "ReaderEndpoint": "sample-cluster.node.us-east-1.amazon.com", "MultiAZ": false, "Engine": "docdb", "EngineVersion": "5.0.0", "LatestRestorableTime": "2023-11-10T07:21:16.772000+00:00", "Port": 27017, "MasterUsername": "chimeraAdmin", "PreferredBackupWindow": "22:22-22:52", "PreferredMaintenanceWindow": "sun:03:01-sun:03:31", "ReadReplicaIdentifiers": [], "DBClusterMembers": [ { "DBInstanceIdentifier": "sample-instance-1", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "sample-instance-2", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, ], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-9084c2ec", "Status": "active" } ], "HostedZoneId": "Z06853723JYKYBXTJ49RB", "StorageEncrypted": false, "DbClusterResourceId": "cluster-T4LGLANHVAPGQYYULWUDKLVQL4", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "AssociatedRoles": [], "IAMDatabaseAuthenticationEnabled": false, "ClusterCreateTime": "2023-11-06T18:05:41.568000+00:00", "EngineMode": "provisioned", "DeletionProtection": false, "HttpEndpointEnabled": false, "CopyTagsToSnapshot": false, "CrossAccountClone": false, "DomainMemberships": [], "TagList": [], "StorageType": "iopt1", "AutoMinorVersionUpgrade": false, "NetworkType": "IPV4", "IOOptimizedNextAllowedModificationTime": "2023-12-07T18:05:41.580000+00:00" } ] }
範例 3:列出 Amazon 文件資料庫叢集的特定詳細資料
若要使用列出叢集詳細資訊的子集 AWS CLI,請新增一個來指
--query
定要列出describe-db-clusters
作業的叢集成員。--db-cluster-identifier
參數是您想要顯示詳細資訊之特定叢集的識別碼。如需有關查詢的詳細資訊,請參閱《AWS Command Line Interface 使用指南》中的如何使用--query
選項篩選輸出。下列範例列出 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 } ] ] ]