Finding a Cluster's Endpoints - Amazon DocumentDB
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Finding a Cluster's Endpoints

You can find a cluster's cluster endpoint and reader endpoint using the Amazon DocumentDB console or Amazon CLI.

Using the Console

To find a cluster's endpoints using the console
  1. Sign in to the Amazon Web Services Management Console, and open the Amazon DocumentDB console at

  2. In the navigation pane, choose clusters.

  3. From the list of clusters, choose the name of the cluster you are interested in.

  4. Scroll down to the Details section and locate the cluster endpoint and the reader endpoint.

                     Console screenshot showing cluster details with cluster endpoint and reader endpoint highlighted.
  5. To connect to this cluster, scroll up to the Connect section. Locate the connection string for the mongo shell and a connection string that can be used in the application code to connect to your cluster.

                     Console screenshot showing the connect section with mongo shell and application connection strings highlighted.

Using the Amazon CLI

To find the cluster and reader endpoints for your cluster using the Amazon CLI, run the describe-db-clusters command with these parameters.

  • --db-cluster-identifier—Optional. Specifies the cluster to return endpoints for. If omitted, returns endpoints for up to 100 of your clusters.

  • --query—Optional. Specifies the fields to display. Helpful by reducing the amount of data that you need to view to find the endpoints. If omitted, all information about a cluster is returned.

  • --region—Optional. Use the --region parameter to specify the Region that you want to apply the command to. If omitted, your default Region is used.

The following example returns the DBClusterIdentifier, endpoint (cluster endpoint), and ReaderEndpoint for sample-cluster.

For Linux, macOS, or Unix:

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

For Windows:

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

Output from this operation looks something like the following (JSON format).

[ [ "sample-cluster", 27017, "", "" ] ]

Now that you have the cluster endpoint, you can connect to the cluster using either mongo or mongodb. For more information, see Connecting to Endpoints.