Docs Menu
Docs Home
/ /
Atlas CLI
/ /

atlas api globalClusters

On this page

  • Options
  • Inherited Options
  • Related Commands

experimental: Returns, adds, and removes Global Cluster managed namespaces and custom zone mappings.

Each collection in a Global Cluster is associated with a managed namespace. When you create a managed namespace for a Global Cluster, MongoDB Cloud creates an empty collection for that namespace. Creating a managed namespace doesn't populate a collection with data. Similarly, deleting a managed namespace doesn't delete the associated collection. MongoDB Cloud shards the empty collection using the required location field and a custom shard key. For example, if your custom shard key is city, the compound shard key is location, city. Each Global Cluster is also associated with one or more Global Writes Zones. When a user creates a Global Cluster, MongoDB Cloud automatically maps each location code to the closest geographical zone. Custom zone mappings allow administrators to override these automatic mappings. For example, a use case might require mapping a location code to a geographically distant zone. Administrators can manage custom zone mappings with the APIs below and the Global Cluster Configuration pane when you create or modify your Global Cluster.

Name
Type
Required
Description

-h, --help

false

help for globalClusters

Name
Type
Required
Description

-P, --profile

string

false

  • atlas api globalClusters createCustomZoneMapping - experimental: Creates one custom zone mapping for the specified global cluster.

  • atlas api globalClusters createManagedNamespace - experimental: Creates one managed namespace within the specified global cluster.

  • atlas api globalClusters deleteAllCustomZoneMappings - experimental: Removes all custom zone mappings for the specified global cluster.

  • atlas api globalClusters deleteManagedNamespace - experimental: Removes one managed namespace within the specified global cluster.

  • atlas api globalClusters getManagedNamespace - experimental: Returns one managed namespace within the specified global cluster.

Back

listFlexBackups