mongocli atlas cluster update

On this page

Syntax

Options
Output
Examples

This version of the documentation is archived and no longer supported. View the current documentation to learn how to upgrade your version of MongoCLI.

The cluster update command modifies your Atlas cluster settings. You can only modify:

M10 or larger clusters
A single-region replica set

You can also modify a cluster through the Atlas console or API.

Syntax

mongocli atlas cluster(s) update <cluster-name>
     [ --diskSizeGB <size-of-disk> ]
     [ --file|-f <path-to-cluster-config-file> ]
     [ --tier <cluster-tier> ]
     [ --mdbVersion <mongodb-version> ]
     [ --output|-o <output-format> ]
     [ --profile|-P <profile-name> ]
     --projectId <id-of-project>

Note

Use -h or --help to view the command-line help for this command.

Options

Option	Type	Description	Required?
`<cluster-name>`	string	Name of your Atlas cluster. You cannot change the name of your cluster.	yes
`--diskSizeGB`	integer	Size of the server’s root volume in GB. Increase this number to add capacity.	no
`--file`, `-f`	string	Path to a JSON configuration file that defines cluster settings. Any settings specified in the configuration file take precedence over settings specified by a command option. For a list of settings you can define, see the Create One Cluster API.	no
`--tier`	string	Name of the cluster tier to use.	no
`--mdbVersion`	string	Major version of MogoDB to which you want to upgrade your cluster. You cannot downgrade the MongoDB version of your cluster. Note Before your upgrade, refer to the current recommended best practices for major version upgrades.	no
`--output`, `-o`	string	Command output format. Valid values are: `json` for output in JSON format `go-template` for custom output using the Go template `go-template-file` for custom output specified using Go template file If omitted, the command returns output in the default format.	no
`--profile`, `-P`	string	Name of the profile to use for accessing the Atlas project. If omitted, uses the default profile.	no
`--projectId`	string	Unique identifier of the project. If omitted, uses the project ID in the profile or environment variable.	yes

Output

The command returns the following JSON document if the command succeeds. If the command returns errors, see Troubleshooting for recommended solutions.

Field

Returned Value

autoScaling

Configuration for automatically scaling cluster storage and tier.

autoscaling

.diskGBEnabled

State of this cluster's disk auto-scaling:

true if enabled
false if disabled

By default, Atlas disables disk auto-scaling.

backupEnabled

State of cloud backup for this cluster:

true if enabled
false if disabled

biConnector

Configuration for BI Connector for Atlas on the cluster.

biConnector

.enabled

State of BI Connector for the cluster:

true if enabled
false if disabled

The default value is false.

biConnector

.readPreference

Read preference for BI Connector on the cluster:

primary: BI Connector reads from the primary.
secondary: BI Connector reads from the secondary.
analytics: BI Connector reads from the analytics node.

clusterType

Type of cluster:

REPLICASET
SHARDED
GEOSHARDED

diskSizeGB

Capacity, in GB, of the host's root volume.

encryptionAtRestProvider

Configuration for encryption at rest.

id

Unique identifier of the cluster.

groupId

Unique identifier of the project.

Note

Your project ID equals groupId.

labels

Returns identifying tags for the cluster. As of version 1.0.0, MongoDB uses this field to track use of monogcli.

mongoDBVersion

MongoDB version that is deployed.

mongoDBMajorVersion

Major version of MongoDB that is deployed.

mongoURI

Base connection string for the cluster.

MongoURIUpdated

Timestamp in Timestamp in ISO 8601 date and time format in UTC when someone last updated the connection string.

name

Name of the cluster.

numShards

Number of shards in the cluster:

1: replica set.
Between 2 and 12 inclusive: sharded cluster.

paused

State of the cluster:

true if cluster is paused.
false if cluster is active.

providerBackupEnabled

State of Cloud Backup for the cluster:

true if enabled.
false if disabled.

providerSettings

Configuration for the provisioned servers on which MongoDB runs.

providerSettings

.backingProviderName

Cloud provider service on which the servers are provisioned:

AWS for Amazon AWS
GCP for Google Cloud Platform
AZURE for Microsot Azure

providerSettings

.instanceSizeName

Name of the cluster tier used for Atlas cluster:

Cluster Tiers	Default Storage	Default RAM
`M2`	2 GB	Shared
`M5`	5 GB	Shared
`M10`	10 GB	2 GB
`M20`	20 GB	4 GB
`M30`	40 GB	8 GB
`M40` or `R40`	80 GB	16 GB
`M40_NVME`	380 GB	15.25 GB
`M50` or `R50`	160 GB	32 GB
`M50_NVME`	760 GB	30.5 GB
`M60` or `R60`	320 GB	64 GB
`M60_NVME`	1.6 TB	61 GB
`M80`	760 GB	131 GB
`R80`	750 GB	122 GB
`M80_NVME`	1.6 TB	122 GB
`M100`	1 TB	160 GB
`M140` ¹	1 TB	192 GB
`M200` or `R200`	1.5 TB	256 GB
`M200_NVME`	3.1 TB	244 GB
`M300` ¹	2 TB	384 GB
`R300`	2 TB	384 GB
`R400`	3 TB	488 GB
`M400_NVME` ²	4 TB	512 GB
`R700`	4 TB	768 GB

¹ Unavailable if providerSettings.regionName equals AP_SOUTHEAST_2.

² Availability limited to the following regions:

US_EAST_1
US_EAST_2
US_WEST_2
EU_WEST_1
EU_CENTRAL_1
AP_NORTHEAST_1

Cluster Tiers	Default Storage	Default RAM
`M2`	2 GB	Shared
`M5`	5 GB	Shared
`M10`	32 GB	2 GB
`M20`	32 GB	4 GB
`M30`	32 GB	8 GB
`M40`	128 GB	16 GB
`M50`	128 GB	32 GB
`M60`	128 GB	64 GB
`M80`	256 GB	128 GB
`M200`	256 GB	256 GB

Cluster Tiers	Default Storage	Default RAM
`M2`	2 GB	Shared
`M5`	5 GB	Shared
`M10`	10 GB	1.70 GB
`M20`	20 GB	3.75 GB
`M30`	40 GB	7.5 GB
`M40`	80 GB	15 GB
`M50`	160 GB	30 GB
`M60`	320 GB	60 GB
`M80`	750 GB	120 GB
`M200`	1.5 TB	240 GB
`M300` ¹	2.2 TB	360 GB

¹ Unavailable if providerSettings.regionName equals:

SOUTH_AMERICA_EAST_1
EUROPE_WEST_3
NORTHEASTERN_ASIA_PACIFIC
AUSTRALIA_SOUTHEAST_1

providerSettings

.providerName

Name of the cloud service provider on which Atlas provisioned the MongoDB host:

AWS for Amazon AWS
GCP for Google Cloud Platform
AZURE for Microsot Azure

providerSettings

.regionName

Physical location of the cluster.

For a complete list of regions, see cloud provider reference:

replicationFactor

Number of replica set members in the cluster: 3, 5, or 7.

replicationSpec

Configuration for each region in the cluster. Each element in this object represents a region where Atlas deployed your cluster.

replicationSpec

.<region>

Physical location of the region.

Each <region> object describes the region’s priority in elections and the number and type of MongoDB nodes Atlas deploys to the region.

replicationSpec

.<region>.analyticsNodes

Number of analytics nodes in the region.

replicationSpec

.<region>.electableNodes

Number of electable nodes in the region.

replicationSpec

.<region>.priority

Election priority of the region as an integer between 0 and 7 inclusive.

replicationSpec

.<region>.readOnlyNodes

Number of read-only nodes in the region.

replicationSpecs

Returns Global Cluster zone. As mongocli can't create Global Clusters, this response includes one zone only.

Each object in this array represents a zone where Atlas deploys nodes for your Global Cluster.

replicationSpecs.id

Unique identifier of the replication object.

replicationSpecs.numShards

Number of shards to deploy in the specified zone.

replicationSpecs.zoneName

Name for the zone.

replicationSpecs.regionConfig

Configuration for the physical location of the region. Each regionsConfig object describes the region’s priority in elections and the number and type of MongoDB nodes that Atlas deploys to the region.

replicationSpecs[n]
.regionsConfig
.<regionName>.analyticsNodes

Number of analytics nodes to deploy in the region.

replicationSpecs[n]
.regionsConfig
.<regionName>.electableNodes

Number of electable nodes for Atlas to deploy to the region.

replicationSpecs[n]
.regionsConfig
.<regionName>.priority

Election priority of the region.

replicationSpecs[n]
.regionsConfig
.<regionName>.readOnlyNodes

Number of read-only nodes for Atlas to deploy to the region.

srvAddress

connection string for connecting to the Atlas cluster. The +srv modifier forces the connection to use TLS. The mongoURI parameter lists additional options.

stateName

Current status of the cluster:

IDLE
CREATING
UPDATING
DELETING
DELETED
REPAIRING

Examples

Example 1

The following mongocli atlas cluster update command migrates the cluster named sbxCluster in the specified project from M10 to M20. It uses the default profile to access the project.

mongocli atlas cluster update sbxCluster \
         --projectId 5e2211c17a3e5a48f5497de3 \
         --tier M20 --output json

The command returns the following JSON document:

{
  "autoScaling": {
    "diskGBEnabled": true
  },
  "backupEnabled": false,
  "biConnector": {
    "enabled": false,
    "readPreference": "secondary"
  },
  "clusterType": "REPLICASET",
  "diskSizeGB": 2,
  "encryptionAtRestProvider": "NONE",
  "id": "5e2f1f657a3e5a052beddd92",
  "groupId": "5e2211c17a3e5a48f5497de3",
  "labels": [
    {
      "key" : "Infrastructure Tool",
      "value" : "mongoCLI"
    }
  ],
  "mongoDBVersion": "4.2.3",
  "mongoDBMajorVersion": "4.2",
  "mongoURI": "mongodb://sbxcluster-shard-00-00-7hgjn.mongodb-dev.net:27017,sbxcluster-shard-00-01-7hgjn.mongodb-dev.net:27017,sbxcluster-shard-00-02-7hgjn.mongodb-dev.net:27017",
  "mongoURIUpdated": "2020-01-27T17:41:49Z",
  "mongoURIWithOptions": "mongodb://sbxcluster-shard-00-00-7hgjn.mongodb-dev.net:27017,sbxcluster-shard-00-01-7hgjn.mongodb-dev.net:27017,sbxcluster-shard-00-02-7hgjn.mongodb-dev.net:27017/?ssl=true\u0026authSource=admin\u0026replicaSet=sbxCluster-shard-0",
  "name": "sbxCluster",
  "numShards": 1,
  "paused": false,
  "providerBackupEnabled": false,
  "providerSettings": {
    "diskIOPS": 100,
    "encryptEBSVolume": true,
    "instanceSizeName": "M20",
    "providerName": "AWS",
    "regionName": "US_EAST_1",
    "volumeType": "STANDARD"
  },
  "replicationFactor": 3,
  "replicationSpec": {
    "US_EAST_1": {
      "analyticsNodes": 0,
      "electableNodes": 3,
      "priority": 7,
      "readOnlyNodes": 0
    }
  },
  "replicationSpecs": [
    {
      "id": "5e2f1f657a3e5a052beddd8d",
      "numShards": 1,
      "zoneName": "Zone 1",
      "regionsConfig": {
        "US_EAST_1": {
          "analyticsNodes": 0,
          "electableNodes": 3,
          "priority": 7,
          "readOnlyNodes": 0
        }
      }
    }
  ],
  "srvAddress": "mongodb+srv://sbxcluster-7hgjn.mongodb-dev.net",
  "stateName": "UPDATING"
}

Example 2

The following mongocli atlas cluster update command uses a configuration file to:

Increase the cluster tier from M10 to M20 and
Increase the server's root volume to 200 GB.

The command uses the profile named egAtlasProfile, which contains the public and private keys for accessing Atlas.

mongocli atlas cluster update myCluster \
         --file cluster-config.json --output json \
         --projectId 5e2211c17a3e5a48f5497de3 \
         --profile egAtlasProfile

The cluster configuration file contains the updated document:

{
  "diskSizeGB": 200,
  "providerSettings": {
     "providerName": "AWS",
     "diskIOPS": 100,
     "instanceSizeName": "M20"
 },
 "replicationFactor": 3
}

The command returns the following JSON document. To learn more about these fields, see Output.

{
   "autoScaling": {
      "diskGBEnabled": true
   },
   "backupEnabled": false,
   "biConnector": {
      "enabled": false,
      "readPreference": "secondary"
   },
   "clusterType": "REPLICASET",
   "diskSizeGB": 120,
   "encryptionAtRestProvider": "NONE",
   "id": "5e66718ec4121d0a54021794",
   "groupId": "5e2f04ecf10fab66c7d4072e",
   "labels": [
      {
         "key" : "Infrastructure Tool",
         "value" : "mongoCLI"
      }
   ],
   "mongoDBVersion": "4.2.3",
   "mongoDBMajorVersion": "4.2",
   "mongoURI": "mongodb://cluster0-shard-00-00-xgwul.mongodb-dev.net:27017,cluster0-shard-00-01-xgwul.mongodb-dev.net:27017,cluster0-shard-00-02-xgwul.mongodb-dev.net:27017",
   "mongoURIUpdated": "2020-03-09T16:47:50Z",
   "mongoURIWithOptions": "mongodb://cluster0-shard-00-00-xgwul.mongodb-dev.net:27017,cluster0-shard-00-01-xgwul.mongodb-dev.net:27017,cluster0-shard-00-02-xgwul.mongodb-dev.net:27017/?ssl=true\u0026authSource=admin\u0026replicaSet=Cluster0-shard-0",
   "name": "Cluster0",
   "numShards": 1,
   "paused": false,
   "providerBackupEnabled": true,
   "providerSettings": {
      "diskIOPS": 360,
      "encryptEBSVolume": true,
      "instanceSizeName": "M10",
      "providerName": "AWS",
      "regionName": "US_EAST_1",
      "volumeType": "STANDARD"
   },
   "replicationFactor": 3,
   "replicationSpec": {
      "US_EAST_1": {
         "analyticsNodes": 0,
         "electableNodes": 3,
         "priority": 7,
         "readOnlyNodes": 0
      }
   },
   "replicationSpecs": [
      {
         "id": "5e667185746809055da6b383",
         "numShards": 1,
         "zoneName": "Zone 1",
         "regionsConfig": {
            "US_EAST_1": {
               "analyticsNodes": 0,
               "electableNodes": 3,
               "priority": 7,
               "readOnlyNodes": 0
            }
         }
      }
   ],
   "srvAddress": "mongodb+srv://cluster0-xgwul.mongodb-dev.net",
   "stateName": "UPDATING"
}

Back

Delete a Cluster

Pause a Cluster