クラスターのエンドポイントの検索

Amazon DocumentDB コンソールまたは AWS CLI を使用して、クラスターのクラスターエンドポイントと読み込みエンドポイントを見つけることができます。

Using the AWS Management Console

コンソールを使用してクラスターのエンドポイントを見つけるには

1. AWS Management Console にサインインし、https://console.aws.amazon.com/docdb にある Amazon DocumentDB コンソールを開きます。

2. ナビゲーションペインで [Clusters (クラスター)] を選択します。

3. クラスターの一覧で、関心のあるクラスターの名前を選択します。

4. [詳細] セクションまで下にスクロールし、クラスターエンドポイントと読み込みエンドポイントを見つけます。

   

5. このクラスターに接続するには、[接続] セクションまで上にスクロールします。mongo シェルの接続文字列と、アプリケーションコードで使用してクラスターに接続できる接続文字列を見つけます。

   

Using the AWS CLI

AWS CLI を使用してクラスターと読み込みエンドポイントを見つけるには、以下のパラメータを指定して describe-db-clusters コマンドを実行します。

パラメータ

• --db-cluster-identifier - オプションです。エンドポイントを返すクラスターを指定します。省略した場合、最大 100 個のクラスターのエンドポイントを返します。

• --query - オプションです。表示するフィールドを指定します。エンドポイントを見つけるために表示する必要があるデータの量を減らすと役立ちます。省略した場合、すべてのクラスターについての情報が返されます。

• --region - オプションです。--region パラメータを使用して、コマンドを適用するリージョンを指定します。省略すると、デフォルトのリージョンが使用されます。

次の例では、DBClusterIdentifier、エンドポイント (クラスターエンドポイント)、および sample-cluster の ReaderEndpoint を返します。

Linux、macOS、Unix の場合:

aws docdb describe-db-clusters \
   --region us-east-1 \
   --db-cluster-identifier sample-cluster \
   --query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'

Windows の場合:

aws docdb describe-db-clusters ^
   --region us-east-1 ^
   --db-cluster-identifier sample-cluster ^
   --query 'DBClusters[*].[DBClusterIdentifier,Port,Endpoint,ReaderEndpoint]'

このオペレーションによる出力は、次のようになります (JSON 形式)。

[
  [
     "sample-cluster",
     27017,
     "sample-cluster.cluster-corlsfccjozr.us-east-1.docdb.amazonaws.com",
     "sample-cluster.cluster-ro-corlsfccjozr.us-east-1.docdb.amazonaws.com"
  ]
]

これでクラスターエンドポイントが作成したので、mongo または mongodb を使用してクラスターに接続できます。詳細については、「エンドポイントへの接続」を参照してください。