Docs Menu
Docs Home
/ /
Atlas Command Line Interface
/ /

atlas clusters upgrade

Upgrade a shared cluster's tier, disk size, and/or MongoDB version.

This command is unavailable for dedicated clusters.

atlas clusters upgrade [clusterName] [options]
Name
Type
Required
Description

clusterName

string

false

Name of the cluster to upgrade.

Name
Type
Required
Description

--disableTerminationProtection

false

Disables termination protection for your cluster. You can delete a cluster with termination protection disabled.

--diskSizeGB

float

false

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

--enableTerminationProtection

false

Enables termination protection for your cluster. You can't delete a cluster with termination protection enabled.

-f, --file

string

false

Path to an optional JSON configuration file that defines cluster settings. To learn more about configuration files for the Atlas CLI, see https://www.mongodb.com/docs/atlas/cli/stable/cluster-config-file/. To learn more about configuration files for MongoCLI, see https://www.mongodb.com/docs/mongocli/stable/reference/mms-cluster-settings-file/.

-h, --help

false

help for upgrade

--mdbVersion

string

false

Major MongoDB version of the cluster.

-o, --output

string

false

Output format. Valid values are json, json-path, go-template, or go-template-file.

--projectId

string

false

Hexadecimal string that identifies the project to use. This option overrides the settings in the configuration file or environment variable.

--tier

string

false

Tier for each data-bearing server in the cluster. To learn more about cluster tiers, see https://www.mongodb.com/docs/atlas/manage-clusters/#select-cluster-tier.

Name
Type
Required
Description

-P, --profile

string

false

Human-readable label that identifies the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. To learn about profiles for MongoCLI, see https://dochub.mongodb.org/core/atlas-cli-configuration-file.

# Upgrade the tier, disk size, and MongoDB version for the shared cluster named myCluster in the project with the ID 5e2211c17a3e5a48f5497de3:
atlas cluster upgrade myCluster --projectId 5e2211c17a3e5a48f5497de3 --tier M50 --diskSizeGB 20 --mdbVersion 4.2

Back

update

On this page