Amazon DocumentDB クラスター の説明
Amazon DocumentDB マネジメントコンソールまたは AWS CLI を使用して、Amazon DocumentDB クラスターに関連する接続エンドポイント、セキュリティグループ、VPC、パラメータグループなどの詳細を確認できます。
詳細については、次を参照してください:
- Using the AWS Management Console
-
次の手順を使用して、コンソールを使用して指定された Amazon DocumentDB クラスターの詳細を表示します。
AWS Management Console にサインインし、Amazon DocumentDB コンソールを次の場所で開きます。https://console.aws.amazon.com/docdb
。 -
ナビゲーションペインで [クラスター] を選択します。
ヒント
画面の左側にナビゲーションペインが表示されない場合は、ページの左上隅にあるメニューアイコン (
) を選択します。 -
クラスターの一覧で、詳細を表示するクラスターの名前を選択します。クラスターに関する情報は、次のグループで分けられます。
-
[概要] - エンジンバージョン、クラスターのステータス、保留中のメンテナンス、パラメータグループのステータスなど、クラスターに関する一般情報。
-
[接続とセキュリティ] - [接続] セクションには、mongo シェルやアプリケーションを使用してこのクラスターに接続するための接続エンドポイントが一覧表示されます。[セキュリティグループ] セクションには、このクラスターに関連付けられているセキュリティグループと、その VPC ID や説明が一覧表示されます。
-
[設定] - [クラスターの詳細] セクションには、クラスターの Amazon リソースネーム (ARN)、エンドポイント、パラメータグループなど、クラスターに関する詳細が一覧表示されます。また、クラスターのバックアップ情報、メンテナンスの詳細、セキュリティとネットワークの設定も一覧表示されます。[クラスターのインスタンス] セクションには、このクラスターに属するすべてのインスタンスが一覧表示されます。各インスタンスのロールとクラスターパラメータグループのステータスも一緒に表示されます。
-
[モニタリング] — このクラスターの Amazon CloudWatch Logs メトリクス。詳細については、「Amazon DocumentDB と CloudWatch のモニタリング」を参照してください。
-
[イベントとタグ] — [最近のイベント] セクションには、このクラスターの最近のイベントの一覧が表示されます。Amazon DocumentDB は、クラスター、インスタンス、スナップショット、セキュリティグループ、およびクラスターパラメータグループに関連するイベントのレコードを保持します。この情報には、各イベントに関連する日付、時刻、およびメッセージが含まれます。[タグ] セクションには、このクラスターにアタッチされているタグが一覧表示されます。
-
- Using the AWS CLI
-
Amazon DocumentDB を使用して AWS CLI クラスターの詳細を表示するには、次の例に示すように
describe-db-clustersコマンドを使用します。詳細については、「Amazon DocumentDB リソース管理 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 DocumentDB クラスターのすべての詳細を一覧表示する
次の AWS CLI コードは、クラスター
sample-clusterの詳細をリストします。Linux、macOS、Unix の場合:
aws docdb describe-db-clusters \ --filter Name=engine,Values=docdb \ --db-cluster-identifier sample-clusterWindows の場合:
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 DocumentDB クラスターの特定の詳細をリストする
AWS CLI を使用してクラスターの詳細のサブセットを表示するには、
describe-db-clustersオペレーションでリストするクラスターメンバーを指定する--queryを追加します。--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 } ] ] ]
