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

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

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

Using the AWS マネジメントコンソール
コンソールを使用してクラスターのエンドポイントを見つけるには:

  1. AWS マネジメントコンソール にサインインして、Amazon DocumentDB コンソール https://console.aws.amazon.com/docdb を開いてください。

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

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

  4. クラスターの詳細ページで、[Configuration] (構成) タブを選択します。設定およびステータス セクションには、クラスターエンドポイント と リーダーエンドポイント があります。

    クラスターとリーダーエンドポイントを示す設定およびステータスセクション。

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

    mongo シェルを使用してインスタンスに接続する文字列と、アプリケーションを使用してクラスターに接続する文字列を示す接続セクション。
Using the AWS CLI

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

パラメータ

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

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

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

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

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 を使用してクラスターに接続できます。詳細については、「エンドポイントへの接続」を参照してください。