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

インスタンスのエンドポイントの検索

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

Using the AWS Management Console
コンソールを使用してインスタンスのエンドポイントを見つけるには

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

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

    ヒント

    画面の左側にナビゲーションペインが表示されない場合は、ページの左上隅にあるメニューアイコン (Hamburger menu icon with three horizontal lines.) を選択します。

  3. クラスターナビゲーションボックスに、[Cluster Identifier]の列が表示されます。インスタンスは、以下のスクリーンショットのように、クラスターの下に表示されます。

    DocumentDB clusters list showing two clusters with their identifiers and roles.

  4. 興味があるインスタンスの左側にあるチェックボックスをチェックします。

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

    インスタンスのエンドポイントが強調表示された詳細ページを示しているコンソールのスクリーンショット。

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

    mongo シェルとアプリケーションの接続文字列が強調表示された、接続セクションを表示しているコンソールのスクリーンショット。
Using the AWS CLI

AWS CLI を使用してインスタンスのエンドポイントを見つけるには、以下の引数を使用して以下のコマンドを実行します。

引数

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

  • --query - オプションです。表示するフィールドを指定します。エンドポイントを見つけるために表示する必要があるデータの量を減らすと役立ちます。省略した場合、インスタンスのすべての情報が返されます。この Endpoint フィールドには 3 つのメンバーがあるため、次の例に示すようにクエリでリストすると、3 つすべてのメンバーが返されます。一部の Endpoint メンバーのみに関心がある場合は、2 番目の例のように、クエリで Endpoint を関心のあるメンバーに置き換えます。

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

Linux、macOS、Unix の場合:

aws docdb describe-db-instances \
    --region us-east-1 \
    --db-instance-identifier sample-cluster-instance \
    --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'

Windows の場合:

aws docdb describe-db-instances ^
    --region us-east-1 ^
    --db-instance-identifier sample-cluster-instance ^
    --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint]'

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

[
    [
        "sample-cluster-instance",
        {
            "Port": 27017,
            "Address": "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com",
            "HostedZoneId": "Z2R2ITUGPM61AM"
        }
    ]
]

出力を減らしてエンドポイントの HostedZoneId を排除すると、Endpoint.Port と Endpoint.Address を使用してクエリを変更することができます。

Linux、macOS、Unix の場合:

aws docdb describe-db-instances \
    --region us-east-1 \
    --db-instance-identifier sample-cluster-instance \
    --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'

Windows の場合:

aws docdb describe-db-instances ^
    --region us-east-1 ^
    --db-instance-identifier sample-cluster-instance ^
    --query 'DBInstances[*].[DBInstanceIdentifier,Endpoint.Port,Endpoint.Address]'

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

[
    [
        "sample-cluster-instance",
        27017,
        "sample-cluster-instance.corcjozrlsfc.us-east-1.docdb.amazonaws.com"
    ]
]

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