Docs Menu

Docs HomeMongoDB Cloud Manager

Clusters

Note

Groups and projects are synonymous terms. Your {PROJECT-ID} is the same as your project id. For existing groups, your group/project id remains the same. This page uses the more familiar term group when referring to descriptions. The endpoint remains as stated in the document.

MongoDB supports two types of clusters: replica sets and sharded clusters. A sharded cluster can contain replica sets within it: each shard can be a replica set and the config server can also be a replica set. These relationships are reflected in the way Cloud Manager models clusters, and it might lead to unexpected results from the clusters resource.

Example

Consider a deployment with one sharded cluster containing four shards, and each shard is a three-node replica set.

In this scenario, the clusters resource will return five entities:

  • One that represents the sharded cluster, and

  • Four that represent the replica sets (shards).

However, if each shard in this fictitious deployment were a standalone mongod instead of a replica set, then the clusters resource returns only one entity representing the sharded cluster.

Base URL: https://cloud.mongodb.com/api/public/v1.0

The following endpoints are available for clusters.

Method
Endpoint
Description
GET
Get details for all clusters in all projects available to the programmatic key making the request.
GET
Retrieve details for all clusters in one project.
GET
Retrieve details for one cluster in one project.
PATCH
Update one cluster in one project.
←  Get a Database by NameGet All Clusters in All Projects →