1. Packages
  2. MongoDB Atlas
  3. API Docs
  4. GlobalClusterConfig
MongoDB Atlas v3.16.2 published on Friday, Jun 21, 2024 by Pulumi

mongodbatlas.GlobalClusterConfig

Explore with Pulumi AI

mongodbatlas logo
MongoDB Atlas v3.16.2 published on Friday, Jun 21, 2024 by Pulumi

    mongodbatlas.GlobalClusterConfig provides a Global Cluster Configuration resource.

    NOTE: Groups and projects are synonymous terms. You may find group_id in the official documentation.

    IMPORTANT: A Global Cluster Configuration, once created, can only be deleted. You can recreate the Global Cluster with the same data only in the Atlas UI. This is because the configuration and its related collection with shard key and indexes are managed separately and they would end up in an inconsistent state. Read more about Global Cluster Configuration

    Examples Usage

    Example Global cluster

    import * as pulumi from "@pulumi/pulumi";
    import * as mongodbatlas from "@pulumi/mongodbatlas";
    
    const test = new mongodbatlas.Cluster("test", {
        projectId: "<YOUR-PROJECT-ID>",
        name: "<CLUSTER-NAME>",
        cloudBackup: true,
        clusterType: "GEOSHARDED",
        providerName: "AWS",
        providerInstanceSizeName: "M30",
        replicationSpecs: [
            {
                zoneName: "Zone 1",
                numShards: 1,
                regionsConfigs: [{
                    regionName: "EU_CENTRAL_1",
                    electableNodes: 3,
                    priority: 7,
                    readOnlyNodes: 0,
                }],
            },
            {
                zoneName: "Zone 2",
                numShards: 1,
                regionsConfigs: [{
                    regionName: "US_EAST_2",
                    electableNodes: 3,
                    priority: 7,
                    readOnlyNodes: 0,
                }],
            },
        ],
    });
    const config = new mongodbatlas.GlobalClusterConfig("config", {
        projectId: test.projectId,
        clusterName: test.name,
        managedNamespaces: [{
            db: "mydata",
            collection: "publishers",
            customShardKey: "city",
            isCustomShardKeyHashed: false,
            isShardKeyUnique: false,
        }],
        customZoneMappings: [{
            location: "CA",
            zone: "Zone 1",
        }],
    });
    
    import pulumi
    import pulumi_mongodbatlas as mongodbatlas
    
    test = mongodbatlas.Cluster("test",
        project_id="<YOUR-PROJECT-ID>",
        name="<CLUSTER-NAME>",
        cloud_backup=True,
        cluster_type="GEOSHARDED",
        provider_name="AWS",
        provider_instance_size_name="M30",
        replication_specs=[
            mongodbatlas.ClusterReplicationSpecArgs(
                zone_name="Zone 1",
                num_shards=1,
                regions_configs=[mongodbatlas.ClusterReplicationSpecRegionsConfigArgs(
                    region_name="EU_CENTRAL_1",
                    electable_nodes=3,
                    priority=7,
                    read_only_nodes=0,
                )],
            ),
            mongodbatlas.ClusterReplicationSpecArgs(
                zone_name="Zone 2",
                num_shards=1,
                regions_configs=[mongodbatlas.ClusterReplicationSpecRegionsConfigArgs(
                    region_name="US_EAST_2",
                    electable_nodes=3,
                    priority=7,
                    read_only_nodes=0,
                )],
            ),
        ])
    config = mongodbatlas.GlobalClusterConfig("config",
        project_id=test.project_id,
        cluster_name=test.name,
        managed_namespaces=[mongodbatlas.GlobalClusterConfigManagedNamespaceArgs(
            db="mydata",
            collection="publishers",
            custom_shard_key="city",
            is_custom_shard_key_hashed=False,
            is_shard_key_unique=False,
        )],
        custom_zone_mappings=[mongodbatlas.GlobalClusterConfigCustomZoneMappingArgs(
            location="CA",
            zone="Zone 1",
        )])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-mongodbatlas/sdk/v3/go/mongodbatlas"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		test, err := mongodbatlas.NewCluster(ctx, "test", &mongodbatlas.ClusterArgs{
    			ProjectId:                pulumi.String("<YOUR-PROJECT-ID>"),
    			Name:                     pulumi.String("<CLUSTER-NAME>"),
    			CloudBackup:              pulumi.Bool(true),
    			ClusterType:              pulumi.String("GEOSHARDED"),
    			ProviderName:             pulumi.String("AWS"),
    			ProviderInstanceSizeName: pulumi.String("M30"),
    			ReplicationSpecs: mongodbatlas.ClusterReplicationSpecArray{
    				&mongodbatlas.ClusterReplicationSpecArgs{
    					ZoneName:  pulumi.String("Zone 1"),
    					NumShards: pulumi.Int(1),
    					RegionsConfigs: mongodbatlas.ClusterReplicationSpecRegionsConfigArray{
    						&mongodbatlas.ClusterReplicationSpecRegionsConfigArgs{
    							RegionName:     pulumi.String("EU_CENTRAL_1"),
    							ElectableNodes: pulumi.Int(3),
    							Priority:       pulumi.Int(7),
    							ReadOnlyNodes:  pulumi.Int(0),
    						},
    					},
    				},
    				&mongodbatlas.ClusterReplicationSpecArgs{
    					ZoneName:  pulumi.String("Zone 2"),
    					NumShards: pulumi.Int(1),
    					RegionsConfigs: mongodbatlas.ClusterReplicationSpecRegionsConfigArray{
    						&mongodbatlas.ClusterReplicationSpecRegionsConfigArgs{
    							RegionName:     pulumi.String("US_EAST_2"),
    							ElectableNodes: pulumi.Int(3),
    							Priority:       pulumi.Int(7),
    							ReadOnlyNodes:  pulumi.Int(0),
    						},
    					},
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		_, err = mongodbatlas.NewGlobalClusterConfig(ctx, "config", &mongodbatlas.GlobalClusterConfigArgs{
    			ProjectId:   test.ProjectId,
    			ClusterName: test.Name,
    			ManagedNamespaces: mongodbatlas.GlobalClusterConfigManagedNamespaceArray{
    				&mongodbatlas.GlobalClusterConfigManagedNamespaceArgs{
    					Db:                     pulumi.String("mydata"),
    					Collection:             pulumi.String("publishers"),
    					CustomShardKey:         pulumi.String("city"),
    					IsCustomShardKeyHashed: pulumi.Bool(false),
    					IsShardKeyUnique:       pulumi.Bool(false),
    				},
    			},
    			CustomZoneMappings: mongodbatlas.GlobalClusterConfigCustomZoneMappingArray{
    				&mongodbatlas.GlobalClusterConfigCustomZoneMappingArgs{
    					Location: pulumi.String("CA"),
    					Zone:     pulumi.String("Zone 1"),
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Mongodbatlas = Pulumi.Mongodbatlas;
    
    return await Deployment.RunAsync(() => 
    {
        var test = new Mongodbatlas.Cluster("test", new()
        {
            ProjectId = "<YOUR-PROJECT-ID>",
            Name = "<CLUSTER-NAME>",
            CloudBackup = true,
            ClusterType = "GEOSHARDED",
            ProviderName = "AWS",
            ProviderInstanceSizeName = "M30",
            ReplicationSpecs = new[]
            {
                new Mongodbatlas.Inputs.ClusterReplicationSpecArgs
                {
                    ZoneName = "Zone 1",
                    NumShards = 1,
                    RegionsConfigs = new[]
                    {
                        new Mongodbatlas.Inputs.ClusterReplicationSpecRegionsConfigArgs
                        {
                            RegionName = "EU_CENTRAL_1",
                            ElectableNodes = 3,
                            Priority = 7,
                            ReadOnlyNodes = 0,
                        },
                    },
                },
                new Mongodbatlas.Inputs.ClusterReplicationSpecArgs
                {
                    ZoneName = "Zone 2",
                    NumShards = 1,
                    RegionsConfigs = new[]
                    {
                        new Mongodbatlas.Inputs.ClusterReplicationSpecRegionsConfigArgs
                        {
                            RegionName = "US_EAST_2",
                            ElectableNodes = 3,
                            Priority = 7,
                            ReadOnlyNodes = 0,
                        },
                    },
                },
            },
        });
    
        var config = new Mongodbatlas.GlobalClusterConfig("config", new()
        {
            ProjectId = test.ProjectId,
            ClusterName = test.Name,
            ManagedNamespaces = new[]
            {
                new Mongodbatlas.Inputs.GlobalClusterConfigManagedNamespaceArgs
                {
                    Db = "mydata",
                    Collection = "publishers",
                    CustomShardKey = "city",
                    IsCustomShardKeyHashed = false,
                    IsShardKeyUnique = false,
                },
            },
            CustomZoneMappings = new[]
            {
                new Mongodbatlas.Inputs.GlobalClusterConfigCustomZoneMappingArgs
                {
                    Location = "CA",
                    Zone = "Zone 1",
                },
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.mongodbatlas.Cluster;
    import com.pulumi.mongodbatlas.ClusterArgs;
    import com.pulumi.mongodbatlas.inputs.ClusterReplicationSpecArgs;
    import com.pulumi.mongodbatlas.GlobalClusterConfig;
    import com.pulumi.mongodbatlas.GlobalClusterConfigArgs;
    import com.pulumi.mongodbatlas.inputs.GlobalClusterConfigManagedNamespaceArgs;
    import com.pulumi.mongodbatlas.inputs.GlobalClusterConfigCustomZoneMappingArgs;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var test = new Cluster("test", ClusterArgs.builder()
                .projectId("<YOUR-PROJECT-ID>")
                .name("<CLUSTER-NAME>")
                .cloudBackup(true)
                .clusterType("GEOSHARDED")
                .providerName("AWS")
                .providerInstanceSizeName("M30")
                .replicationSpecs(            
                    ClusterReplicationSpecArgs.builder()
                        .zoneName("Zone 1")
                        .numShards(1)
                        .regionsConfigs(ClusterReplicationSpecRegionsConfigArgs.builder()
                            .regionName("EU_CENTRAL_1")
                            .electableNodes(3)
                            .priority(7)
                            .readOnlyNodes(0)
                            .build())
                        .build(),
                    ClusterReplicationSpecArgs.builder()
                        .zoneName("Zone 2")
                        .numShards(1)
                        .regionsConfigs(ClusterReplicationSpecRegionsConfigArgs.builder()
                            .regionName("US_EAST_2")
                            .electableNodes(3)
                            .priority(7)
                            .readOnlyNodes(0)
                            .build())
                        .build())
                .build());
    
            var config = new GlobalClusterConfig("config", GlobalClusterConfigArgs.builder()
                .projectId(test.projectId())
                .clusterName(test.name())
                .managedNamespaces(GlobalClusterConfigManagedNamespaceArgs.builder()
                    .db("mydata")
                    .collection("publishers")
                    .customShardKey("city")
                    .isCustomShardKeyHashed(false)
                    .isShardKeyUnique(false)
                    .build())
                .customZoneMappings(GlobalClusterConfigCustomZoneMappingArgs.builder()
                    .location("CA")
                    .zone("Zone 1")
                    .build())
                .build());
    
        }
    }
    
    resources:
      test:
        type: mongodbatlas:Cluster
        properties:
          projectId: <YOUR-PROJECT-ID>
          name: <CLUSTER-NAME>
          cloudBackup: true
          clusterType: GEOSHARDED
          providerName: AWS
          providerInstanceSizeName: M30
          replicationSpecs:
            - zoneName: Zone 1
              numShards: 1
              regionsConfigs:
                - regionName: EU_CENTRAL_1
                  electableNodes: 3
                  priority: 7
                  readOnlyNodes: 0
            - zoneName: Zone 2
              numShards: 1
              regionsConfigs:
                - regionName: US_EAST_2
                  electableNodes: 3
                  priority: 7
                  readOnlyNodes: 0
      config:
        type: mongodbatlas:GlobalClusterConfig
        properties:
          projectId: ${test.projectId}
          clusterName: ${test.name}
          managedNamespaces:
            - db: mydata
              collection: publishers
              customShardKey: city
              isCustomShardKeyHashed: false
              isShardKeyUnique: false
          customZoneMappings:
            - location: CA
              zone: Zone 1
    

    Example Global cluster config

    import * as pulumi from "@pulumi/pulumi";
    import * as mongodbatlas from "@pulumi/mongodbatlas";
    
    const cluster_test = new mongodbatlas.Cluster("cluster-test", {
        projectId: "<YOUR-PROJECT-ID>",
        name: "cluster-test",
        clusterType: "REPLICASET",
        replicationSpecs: [{
            numShards: 1,
            regionsConfigs: [{
                regionName: "US_EAST_1",
                electableNodes: 3,
                priority: 7,
                readOnlyNodes: 0,
            }],
        }],
        backupEnabled: true,
        autoScalingDiskGbEnabled: true,
        mongoDbMajorVersion: "7.0",
        providerName: "AWS",
        providerInstanceSizeName: "M40",
    });
    const config = new mongodbatlas.GlobalClusterConfig("config", {
        projectId: test.projectId,
        clusterName: test.name,
        managedNamespaces: [{
            db: "mydata",
            collection: "publishers",
            customShardKey: "city",
        }],
        customZoneMappings: [{
            location: "CA",
            zone: "Zone 1",
        }],
    });
    
    import pulumi
    import pulumi_mongodbatlas as mongodbatlas
    
    cluster_test = mongodbatlas.Cluster("cluster-test",
        project_id="<YOUR-PROJECT-ID>",
        name="cluster-test",
        cluster_type="REPLICASET",
        replication_specs=[mongodbatlas.ClusterReplicationSpecArgs(
            num_shards=1,
            regions_configs=[mongodbatlas.ClusterReplicationSpecRegionsConfigArgs(
                region_name="US_EAST_1",
                electable_nodes=3,
                priority=7,
                read_only_nodes=0,
            )],
        )],
        backup_enabled=True,
        auto_scaling_disk_gb_enabled=True,
        mongo_db_major_version="7.0",
        provider_name="AWS",
        provider_instance_size_name="M40")
    config = mongodbatlas.GlobalClusterConfig("config",
        project_id=test["projectId"],
        cluster_name=test["name"],
        managed_namespaces=[mongodbatlas.GlobalClusterConfigManagedNamespaceArgs(
            db="mydata",
            collection="publishers",
            custom_shard_key="city",
        )],
        custom_zone_mappings=[mongodbatlas.GlobalClusterConfigCustomZoneMappingArgs(
            location="CA",
            zone="Zone 1",
        )])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-mongodbatlas/sdk/v3/go/mongodbatlas"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := mongodbatlas.NewCluster(ctx, "cluster-test", &mongodbatlas.ClusterArgs{
    			ProjectId:   pulumi.String("<YOUR-PROJECT-ID>"),
    			Name:        pulumi.String("cluster-test"),
    			ClusterType: pulumi.String("REPLICASET"),
    			ReplicationSpecs: mongodbatlas.ClusterReplicationSpecArray{
    				&mongodbatlas.ClusterReplicationSpecArgs{
    					NumShards: pulumi.Int(1),
    					RegionsConfigs: mongodbatlas.ClusterReplicationSpecRegionsConfigArray{
    						&mongodbatlas.ClusterReplicationSpecRegionsConfigArgs{
    							RegionName:     pulumi.String("US_EAST_1"),
    							ElectableNodes: pulumi.Int(3),
    							Priority:       pulumi.Int(7),
    							ReadOnlyNodes:  pulumi.Int(0),
    						},
    					},
    				},
    			},
    			BackupEnabled:            pulumi.Bool(true),
    			AutoScalingDiskGbEnabled: pulumi.Bool(true),
    			MongoDbMajorVersion:      pulumi.String("7.0"),
    			ProviderName:             pulumi.String("AWS"),
    			ProviderInstanceSizeName: pulumi.String("M40"),
    		})
    		if err != nil {
    			return err
    		}
    		_, err = mongodbatlas.NewGlobalClusterConfig(ctx, "config", &mongodbatlas.GlobalClusterConfigArgs{
    			ProjectId:   pulumi.Any(test.ProjectId),
    			ClusterName: pulumi.Any(test.Name),
    			ManagedNamespaces: mongodbatlas.GlobalClusterConfigManagedNamespaceArray{
    				&mongodbatlas.GlobalClusterConfigManagedNamespaceArgs{
    					Db:             pulumi.String("mydata"),
    					Collection:     pulumi.String("publishers"),
    					CustomShardKey: pulumi.String("city"),
    				},
    			},
    			CustomZoneMappings: mongodbatlas.GlobalClusterConfigCustomZoneMappingArray{
    				&mongodbatlas.GlobalClusterConfigCustomZoneMappingArgs{
    					Location: pulumi.String("CA"),
    					Zone:     pulumi.String("Zone 1"),
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Mongodbatlas = Pulumi.Mongodbatlas;
    
    return await Deployment.RunAsync(() => 
    {
        var cluster_test = new Mongodbatlas.Cluster("cluster-test", new()
        {
            ProjectId = "<YOUR-PROJECT-ID>",
            Name = "cluster-test",
            ClusterType = "REPLICASET",
            ReplicationSpecs = new[]
            {
                new Mongodbatlas.Inputs.ClusterReplicationSpecArgs
                {
                    NumShards = 1,
                    RegionsConfigs = new[]
                    {
                        new Mongodbatlas.Inputs.ClusterReplicationSpecRegionsConfigArgs
                        {
                            RegionName = "US_EAST_1",
                            ElectableNodes = 3,
                            Priority = 7,
                            ReadOnlyNodes = 0,
                        },
                    },
                },
            },
            BackupEnabled = true,
            AutoScalingDiskGbEnabled = true,
            MongoDbMajorVersion = "7.0",
            ProviderName = "AWS",
            ProviderInstanceSizeName = "M40",
        });
    
        var config = new Mongodbatlas.GlobalClusterConfig("config", new()
        {
            ProjectId = test.ProjectId,
            ClusterName = test.Name,
            ManagedNamespaces = new[]
            {
                new Mongodbatlas.Inputs.GlobalClusterConfigManagedNamespaceArgs
                {
                    Db = "mydata",
                    Collection = "publishers",
                    CustomShardKey = "city",
                },
            },
            CustomZoneMappings = new[]
            {
                new Mongodbatlas.Inputs.GlobalClusterConfigCustomZoneMappingArgs
                {
                    Location = "CA",
                    Zone = "Zone 1",
                },
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.mongodbatlas.Cluster;
    import com.pulumi.mongodbatlas.ClusterArgs;
    import com.pulumi.mongodbatlas.inputs.ClusterReplicationSpecArgs;
    import com.pulumi.mongodbatlas.GlobalClusterConfig;
    import com.pulumi.mongodbatlas.GlobalClusterConfigArgs;
    import com.pulumi.mongodbatlas.inputs.GlobalClusterConfigManagedNamespaceArgs;
    import com.pulumi.mongodbatlas.inputs.GlobalClusterConfigCustomZoneMappingArgs;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var cluster_test = new Cluster("cluster-test", ClusterArgs.builder()
                .projectId("<YOUR-PROJECT-ID>")
                .name("cluster-test")
                .clusterType("REPLICASET")
                .replicationSpecs(ClusterReplicationSpecArgs.builder()
                    .numShards(1)
                    .regionsConfigs(ClusterReplicationSpecRegionsConfigArgs.builder()
                        .regionName("US_EAST_1")
                        .electableNodes(3)
                        .priority(7)
                        .readOnlyNodes(0)
                        .build())
                    .build())
                .backupEnabled(true)
                .autoScalingDiskGbEnabled(true)
                .mongoDbMajorVersion("7.0")
                .providerName("AWS")
                .providerInstanceSizeName("M40")
                .build());
    
            var config = new GlobalClusterConfig("config", GlobalClusterConfigArgs.builder()
                .projectId(test.projectId())
                .clusterName(test.name())
                .managedNamespaces(GlobalClusterConfigManagedNamespaceArgs.builder()
                    .db("mydata")
                    .collection("publishers")
                    .customShardKey("city")
                    .build())
                .customZoneMappings(GlobalClusterConfigCustomZoneMappingArgs.builder()
                    .location("CA")
                    .zone("Zone 1")
                    .build())
                .build());
    
        }
    }
    
    resources:
      cluster-test:
        type: mongodbatlas:Cluster
        properties:
          projectId: <YOUR-PROJECT-ID>
          name: cluster-test
          clusterType: REPLICASET
          replicationSpecs:
            - numShards: 1
              regionsConfigs:
                - regionName: US_EAST_1
                  electableNodes: 3
                  priority: 7
                  readOnlyNodes: 0
          backupEnabled: true
          autoScalingDiskGbEnabled: true
          mongoDbMajorVersion: '7.0'
          providerName: AWS
          providerInstanceSizeName: M40
      config:
        type: mongodbatlas:GlobalClusterConfig
        properties:
          projectId: ${test.projectId}
          clusterName: ${test.name}
          managedNamespaces:
            - db: mydata
              collection: publishers
              customShardKey: city
          customZoneMappings:
            - location: CA
              zone: Zone 1
    

    Create GlobalClusterConfig Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new GlobalClusterConfig(name: string, args: GlobalClusterConfigArgs, opts?: CustomResourceOptions);
    @overload
    def GlobalClusterConfig(resource_name: str,
                            args: GlobalClusterConfigArgs,
                            opts: Optional[ResourceOptions] = None)
    
    @overload
    def GlobalClusterConfig(resource_name: str,
                            opts: Optional[ResourceOptions] = None,
                            cluster_name: Optional[str] = None,
                            project_id: Optional[str] = None,
                            custom_zone_mappings: Optional[Sequence[GlobalClusterConfigCustomZoneMappingArgs]] = None,
                            managed_namespaces: Optional[Sequence[GlobalClusterConfigManagedNamespaceArgs]] = None)
    func NewGlobalClusterConfig(ctx *Context, name string, args GlobalClusterConfigArgs, opts ...ResourceOption) (*GlobalClusterConfig, error)
    public GlobalClusterConfig(string name, GlobalClusterConfigArgs args, CustomResourceOptions? opts = null)
    public GlobalClusterConfig(String name, GlobalClusterConfigArgs args)
    public GlobalClusterConfig(String name, GlobalClusterConfigArgs args, CustomResourceOptions options)
    
    type: mongodbatlas:GlobalClusterConfig
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args GlobalClusterConfigArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args GlobalClusterConfigArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args GlobalClusterConfigArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args GlobalClusterConfigArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args GlobalClusterConfigArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var globalClusterConfigResource = new Mongodbatlas.GlobalClusterConfig("globalClusterConfigResource", new()
    {
        ClusterName = "string",
        ProjectId = "string",
        CustomZoneMappings = new[]
        {
            new Mongodbatlas.Inputs.GlobalClusterConfigCustomZoneMappingArgs
            {
                Location = "string",
                Zone = "string",
            },
        },
        ManagedNamespaces = new[]
        {
            new Mongodbatlas.Inputs.GlobalClusterConfigManagedNamespaceArgs
            {
                Collection = "string",
                CustomShardKey = "string",
                Db = "string",
                IsCustomShardKeyHashed = false,
                IsShardKeyUnique = false,
            },
        },
    });
    
    example, err := mongodbatlas.NewGlobalClusterConfig(ctx, "globalClusterConfigResource", &mongodbatlas.GlobalClusterConfigArgs{
    	ClusterName: pulumi.String("string"),
    	ProjectId:   pulumi.String("string"),
    	CustomZoneMappings: mongodbatlas.GlobalClusterConfigCustomZoneMappingArray{
    		&mongodbatlas.GlobalClusterConfigCustomZoneMappingArgs{
    			Location: pulumi.String("string"),
    			Zone:     pulumi.String("string"),
    		},
    	},
    	ManagedNamespaces: mongodbatlas.GlobalClusterConfigManagedNamespaceArray{
    		&mongodbatlas.GlobalClusterConfigManagedNamespaceArgs{
    			Collection:             pulumi.String("string"),
    			CustomShardKey:         pulumi.String("string"),
    			Db:                     pulumi.String("string"),
    			IsCustomShardKeyHashed: pulumi.Bool(false),
    			IsShardKeyUnique:       pulumi.Bool(false),
    		},
    	},
    })
    
    var globalClusterConfigResource = new GlobalClusterConfig("globalClusterConfigResource", GlobalClusterConfigArgs.builder()
        .clusterName("string")
        .projectId("string")
        .customZoneMappings(GlobalClusterConfigCustomZoneMappingArgs.builder()
            .location("string")
            .zone("string")
            .build())
        .managedNamespaces(GlobalClusterConfigManagedNamespaceArgs.builder()
            .collection("string")
            .customShardKey("string")
            .db("string")
            .isCustomShardKeyHashed(false)
            .isShardKeyUnique(false)
            .build())
        .build());
    
    global_cluster_config_resource = mongodbatlas.GlobalClusterConfig("globalClusterConfigResource",
        cluster_name="string",
        project_id="string",
        custom_zone_mappings=[mongodbatlas.GlobalClusterConfigCustomZoneMappingArgs(
            location="string",
            zone="string",
        )],
        managed_namespaces=[mongodbatlas.GlobalClusterConfigManagedNamespaceArgs(
            collection="string",
            custom_shard_key="string",
            db="string",
            is_custom_shard_key_hashed=False,
            is_shard_key_unique=False,
        )])
    
    const globalClusterConfigResource = new mongodbatlas.GlobalClusterConfig("globalClusterConfigResource", {
        clusterName: "string",
        projectId: "string",
        customZoneMappings: [{
            location: "string",
            zone: "string",
        }],
        managedNamespaces: [{
            collection: "string",
            customShardKey: "string",
            db: "string",
            isCustomShardKeyHashed: false,
            isShardKeyUnique: false,
        }],
    });
    
    type: mongodbatlas:GlobalClusterConfig
    properties:
        clusterName: string
        customZoneMappings:
            - location: string
              zone: string
        managedNamespaces:
            - collection: string
              customShardKey: string
              db: string
              isCustomShardKeyHashed: false
              isShardKeyUnique: false
        projectId: string
    

    GlobalClusterConfig Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The GlobalClusterConfig resource accepts the following input properties:

    ClusterName string
    The name of the Global Cluster.
    ProjectId string
    The unique ID for the project to create the database user.
    CustomZoneMappings List<GlobalClusterConfigCustomZoneMapping>
    Each element in the list maps one ISO location code to a zone in your Global Cluster. See Custom Zone Mapping below for more details.
    ManagedNamespaces List<GlobalClusterConfigManagedNamespace>
    Add a managed namespaces to a Global Cluster. For more information about managed namespaces, see Global Clusters. See Managed Namespace below for more details.
    ClusterName string
    The name of the Global Cluster.
    ProjectId string
    The unique ID for the project to create the database user.
    CustomZoneMappings []GlobalClusterConfigCustomZoneMappingArgs
    Each element in the list maps one ISO location code to a zone in your Global Cluster. See Custom Zone Mapping below for more details.
    ManagedNamespaces []GlobalClusterConfigManagedNamespaceArgs
    Add a managed namespaces to a Global Cluster. For more information about managed namespaces, see Global Clusters. See Managed Namespace below for more details.
    clusterName String
    The name of the Global Cluster.
    projectId String
    The unique ID for the project to create the database user.
    customZoneMappings List<GlobalClusterConfigCustomZoneMapping>
    Each element in the list maps one ISO location code to a zone in your Global Cluster. See Custom Zone Mapping below for more details.
    managedNamespaces List<GlobalClusterConfigManagedNamespace>
    Add a managed namespaces to a Global Cluster. For more information about managed namespaces, see Global Clusters. See Managed Namespace below for more details.
    clusterName string
    The name of the Global Cluster.
    projectId string
    The unique ID for the project to create the database user.
    customZoneMappings GlobalClusterConfigCustomZoneMapping[]
    Each element in the list maps one ISO location code to a zone in your Global Cluster. See Custom Zone Mapping below for more details.
    managedNamespaces GlobalClusterConfigManagedNamespace[]
    Add a managed namespaces to a Global Cluster. For more information about managed namespaces, see Global Clusters. See Managed Namespace below for more details.
    cluster_name str
    The name of the Global Cluster.
    project_id str
    The unique ID for the project to create the database user.
    custom_zone_mappings Sequence[GlobalClusterConfigCustomZoneMappingArgs]
    Each element in the list maps one ISO location code to a zone in your Global Cluster. See Custom Zone Mapping below for more details.
    managed_namespaces Sequence[GlobalClusterConfigManagedNamespaceArgs]
    Add a managed namespaces to a Global Cluster. For more information about managed namespaces, see Global Clusters. See Managed Namespace below for more details.
    clusterName String
    The name of the Global Cluster.
    projectId String
    The unique ID for the project to create the database user.
    customZoneMappings List<Property Map>
    Each element in the list maps one ISO location code to a zone in your Global Cluster. See Custom Zone Mapping below for more details.
    managedNamespaces List<Property Map>
    Add a managed namespaces to a Global Cluster. For more information about managed namespaces, see Global Clusters. See Managed Namespace below for more details.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the GlobalClusterConfig resource produces the following output properties:

    CustomZoneMapping Dictionary<string, object>
    A map of all custom zone mappings defined for the Global Cluster. Atlas automatically maps each location code to the closest geographical zone. Custom zone mappings allow administrators to override these automatic mappings. If your Global Cluster does not have any custom zone mappings, this document is empty.
    Id string
    The provider-assigned unique ID for this managed resource.
    CustomZoneMapping map[string]interface{}
    A map of all custom zone mappings defined for the Global Cluster. Atlas automatically maps each location code to the closest geographical zone. Custom zone mappings allow administrators to override these automatic mappings. If your Global Cluster does not have any custom zone mappings, this document is empty.
    Id string
    The provider-assigned unique ID for this managed resource.
    customZoneMapping Map<String,Object>
    A map of all custom zone mappings defined for the Global Cluster. Atlas automatically maps each location code to the closest geographical zone. Custom zone mappings allow administrators to override these automatic mappings. If your Global Cluster does not have any custom zone mappings, this document is empty.
    id String
    The provider-assigned unique ID for this managed resource.
    customZoneMapping {[key: string]: any}
    A map of all custom zone mappings defined for the Global Cluster. Atlas automatically maps each location code to the closest geographical zone. Custom zone mappings allow administrators to override these automatic mappings. If your Global Cluster does not have any custom zone mappings, this document is empty.
    id string
    The provider-assigned unique ID for this managed resource.
    custom_zone_mapping Mapping[str, Any]
    A map of all custom zone mappings defined for the Global Cluster. Atlas automatically maps each location code to the closest geographical zone. Custom zone mappings allow administrators to override these automatic mappings. If your Global Cluster does not have any custom zone mappings, this document is empty.
    id str
    The provider-assigned unique ID for this managed resource.
    customZoneMapping Map<Any>
    A map of all custom zone mappings defined for the Global Cluster. Atlas automatically maps each location code to the closest geographical zone. Custom zone mappings allow administrators to override these automatic mappings. If your Global Cluster does not have any custom zone mappings, this document is empty.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing GlobalClusterConfig Resource

    Get an existing GlobalClusterConfig resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: GlobalClusterConfigState, opts?: CustomResourceOptions): GlobalClusterConfig
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            cluster_name: Optional[str] = None,
            custom_zone_mapping: Optional[Mapping[str, Any]] = None,
            custom_zone_mappings: Optional[Sequence[GlobalClusterConfigCustomZoneMappingArgs]] = None,
            managed_namespaces: Optional[Sequence[GlobalClusterConfigManagedNamespaceArgs]] = None,
            project_id: Optional[str] = None) -> GlobalClusterConfig
    func GetGlobalClusterConfig(ctx *Context, name string, id IDInput, state *GlobalClusterConfigState, opts ...ResourceOption) (*GlobalClusterConfig, error)
    public static GlobalClusterConfig Get(string name, Input<string> id, GlobalClusterConfigState? state, CustomResourceOptions? opts = null)
    public static GlobalClusterConfig get(String name, Output<String> id, GlobalClusterConfigState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    ClusterName string
    The name of the Global Cluster.
    CustomZoneMapping Dictionary<string, object>
    A map of all custom zone mappings defined for the Global Cluster. Atlas automatically maps each location code to the closest geographical zone. Custom zone mappings allow administrators to override these automatic mappings. If your Global Cluster does not have any custom zone mappings, this document is empty.
    CustomZoneMappings List<GlobalClusterConfigCustomZoneMapping>
    Each element in the list maps one ISO location code to a zone in your Global Cluster. See Custom Zone Mapping below for more details.
    ManagedNamespaces List<GlobalClusterConfigManagedNamespace>
    Add a managed namespaces to a Global Cluster. For more information about managed namespaces, see Global Clusters. See Managed Namespace below for more details.
    ProjectId string
    The unique ID for the project to create the database user.
    ClusterName string
    The name of the Global Cluster.
    CustomZoneMapping map[string]interface{}
    A map of all custom zone mappings defined for the Global Cluster. Atlas automatically maps each location code to the closest geographical zone. Custom zone mappings allow administrators to override these automatic mappings. If your Global Cluster does not have any custom zone mappings, this document is empty.
    CustomZoneMappings []GlobalClusterConfigCustomZoneMappingArgs
    Each element in the list maps one ISO location code to a zone in your Global Cluster. See Custom Zone Mapping below for more details.
    ManagedNamespaces []GlobalClusterConfigManagedNamespaceArgs
    Add a managed namespaces to a Global Cluster. For more information about managed namespaces, see Global Clusters. See Managed Namespace below for more details.
    ProjectId string
    The unique ID for the project to create the database user.
    clusterName String
    The name of the Global Cluster.
    customZoneMapping Map<String,Object>
    A map of all custom zone mappings defined for the Global Cluster. Atlas automatically maps each location code to the closest geographical zone. Custom zone mappings allow administrators to override these automatic mappings. If your Global Cluster does not have any custom zone mappings, this document is empty.
    customZoneMappings List<GlobalClusterConfigCustomZoneMapping>
    Each element in the list maps one ISO location code to a zone in your Global Cluster. See Custom Zone Mapping below for more details.
    managedNamespaces List<GlobalClusterConfigManagedNamespace>
    Add a managed namespaces to a Global Cluster. For more information about managed namespaces, see Global Clusters. See Managed Namespace below for more details.
    projectId String
    The unique ID for the project to create the database user.
    clusterName string
    The name of the Global Cluster.
    customZoneMapping {[key: string]: any}
    A map of all custom zone mappings defined for the Global Cluster. Atlas automatically maps each location code to the closest geographical zone. Custom zone mappings allow administrators to override these automatic mappings. If your Global Cluster does not have any custom zone mappings, this document is empty.
    customZoneMappings GlobalClusterConfigCustomZoneMapping[]
    Each element in the list maps one ISO location code to a zone in your Global Cluster. See Custom Zone Mapping below for more details.
    managedNamespaces GlobalClusterConfigManagedNamespace[]
    Add a managed namespaces to a Global Cluster. For more information about managed namespaces, see Global Clusters. See Managed Namespace below for more details.
    projectId string
    The unique ID for the project to create the database user.
    cluster_name str
    The name of the Global Cluster.
    custom_zone_mapping Mapping[str, Any]
    A map of all custom zone mappings defined for the Global Cluster. Atlas automatically maps each location code to the closest geographical zone. Custom zone mappings allow administrators to override these automatic mappings. If your Global Cluster does not have any custom zone mappings, this document is empty.
    custom_zone_mappings Sequence[GlobalClusterConfigCustomZoneMappingArgs]
    Each element in the list maps one ISO location code to a zone in your Global Cluster. See Custom Zone Mapping below for more details.
    managed_namespaces Sequence[GlobalClusterConfigManagedNamespaceArgs]
    Add a managed namespaces to a Global Cluster. For more information about managed namespaces, see Global Clusters. See Managed Namespace below for more details.
    project_id str
    The unique ID for the project to create the database user.
    clusterName String
    The name of the Global Cluster.
    customZoneMapping Map<Any>
    A map of all custom zone mappings defined for the Global Cluster. Atlas automatically maps each location code to the closest geographical zone. Custom zone mappings allow administrators to override these automatic mappings. If your Global Cluster does not have any custom zone mappings, this document is empty.
    customZoneMappings List<Property Map>
    Each element in the list maps one ISO location code to a zone in your Global Cluster. See Custom Zone Mapping below for more details.
    managedNamespaces List<Property Map>
    Add a managed namespaces to a Global Cluster. For more information about managed namespaces, see Global Clusters. See Managed Namespace below for more details.
    projectId String
    The unique ID for the project to create the database user.

    Supporting Types

    GlobalClusterConfigCustomZoneMapping, GlobalClusterConfigCustomZoneMappingArgs

    Location string
    Zone string
    Location string
    Zone string
    location String
    zone String
    location string
    zone string
    location str
    zone str
    location String
    zone String

    GlobalClusterConfigManagedNamespace, GlobalClusterConfigManagedNamespaceArgs

    Import

    Global Clusters can be imported using project ID and cluster name, in the format PROJECTID-CLUSTER_NAME, e.g.

    $ pulumi import mongodbatlas:index/globalClusterConfig:GlobalClusterConfig config 1112222b3bf99403840e8934-Cluster0
    

    See detailed information for arguments and attributes: MongoDB API Global Clusters

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    MongoDB Atlas pulumi/pulumi-mongodbatlas
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the mongodbatlas Terraform Provider.
    mongodbatlas logo
    MongoDB Atlas v3.16.2 published on Friday, Jun 21, 2024 by Pulumi