Docs
PackagesMongoDB Atlas v3.15.2 published on Monday, Jun 3, 2024 by Pulumi
mongodbatlas.AdvancedCluster
Explore with Pulumi AI
mongodbatlas.AdvancedCluster provides an Advanced Cluster resource. The resource lets you create, edit and delete advanced clusters. The resource requires your Project ID.
More information on considerations for using advanced clusters please see Considerations
IMPORTANT:
• The primary difference betweenmongodbatlas.Clusteris thatmongodbatlas.AdvancedClustersupports multi-cloud clusters. We recommend new users start with themongodbatlas.AdvancedClusterresource.
NOTE: If Backup Compliance Policy is enabled for the project for which this backup schedule is defined, you cannot modify the backup schedule for an individual cluster below the minimum requirements set in the Backup Compliance Policy. See Backup Compliance Policy Prohibited Actions and Considerations.
• Upgrading the shared tier is supported. Any change from a shared tier cluster (a tenant) to a different instance size will be considered a tenant upgrade. When upgrading from the shared tier, change the provider_name from “TENANT” to your preferred provider (AWS, GCP or Azure) and remove the variable backing_provider_name. See the Example Tenant Cluster Upgrade below. Note you can upgrade a shared tier cluster only to a single provider on an M10-tier cluster or greater.
• IMPORTANT NOTE When upgrading from the shared tier, only the upgrade changes will be applied. This helps avoid a corrupt state file in the event that the upgrade succeeds but subsequent updates fail within the same pulumi up. To apply additional cluster changes, run a secondary pulumi up after the upgrade succeeds.
NOTE: Groups and projects are synonymous terms. You might find group_id in the official documentation.
NOTE: A network container is created for each provider/region combination on the advanced cluster. This can be referenced via a computed attribute for use with other resources. Refer to the
replication_specs.#.container_idattribute in the Attributes Reference for more information.
NOTE: To enable Cluster Extended Storage Sizes use the
is_extended_storage_sizes_enabledparameter in the mongodbatlas.Project resource.
NOTE: The Low-CPU instance clusters are prefixed with
R, i.e.R40. For complete list of Low-CPU instance clusters see Cluster Configuration Options under each Cloud Provider (https://www.mongodb.com/docs/atlas/reference/cloud-providers/).
Example Usage
Example single provider and single region
import * as pulumi from "@pulumi/pulumi";
import * as mongodbatlas from "@pulumi/mongodbatlas";
const test = new mongodbatlas.AdvancedCluster("test", {
projectId: "PROJECT ID",
name: "NAME OF CLUSTER",
clusterType: "REPLICASET",
replicationSpecs: [{
regionConfigs: [{
electableSpecs: {
instanceSize: "M10",
nodeCount: 3,
},
analyticsSpecs: {
instanceSize: "M10",
nodeCount: 1,
},
providerName: "AWS",
priority: 7,
regionName: "US_EAST_1",
}],
}],
});
import pulumi
import pulumi_mongodbatlas as mongodbatlas
test = mongodbatlas.AdvancedCluster("test",
project_id="PROJECT ID",
name="NAME OF CLUSTER",
cluster_type="REPLICASET",
replication_specs=[mongodbatlas.AdvancedClusterReplicationSpecArgs(
region_configs=[mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs(
electable_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs(
instance_size="M10",
node_count=3,
),
analytics_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs(
instance_size="M10",
node_count=1,
),
provider_name="AWS",
priority=7,
region_name="US_EAST_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.NewAdvancedCluster(ctx, "test", &mongodbatlas.AdvancedClusterArgs{
ProjectId: pulumi.String("PROJECT ID"),
Name: pulumi.String("NAME OF CLUSTER"),
ClusterType: pulumi.String("REPLICASET"),
ReplicationSpecs: mongodbatlas.AdvancedClusterReplicationSpecArray{
&mongodbatlas.AdvancedClusterReplicationSpecArgs{
RegionConfigs: mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArray{
&mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs{
ElectableSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(3),
},
AnalyticsSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(1),
},
ProviderName: pulumi.String("AWS"),
Priority: pulumi.Int(7),
RegionName: pulumi.String("US_EAST_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.AdvancedCluster("test", new()
{
ProjectId = "PROJECT ID",
Name = "NAME OF CLUSTER",
ClusterType = "REPLICASET",
ReplicationSpecs = new[]
{
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecArgs
{
RegionConfigs = new[]
{
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigArgs
{
ElectableSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs
{
InstanceSize = "M10",
NodeCount = 3,
},
AnalyticsSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs
{
InstanceSize = "M10",
NodeCount = 1,
},
ProviderName = "AWS",
Priority = 7,
RegionName = "US_EAST_1",
},
},
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mongodbatlas.AdvancedCluster;
import com.pulumi.mongodbatlas.AdvancedClusterArgs;
import com.pulumi.mongodbatlas.inputs.AdvancedClusterReplicationSpecArgs;
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 AdvancedCluster("test", AdvancedClusterArgs.builder()
.projectId("PROJECT ID")
.name("NAME OF CLUSTER")
.clusterType("REPLICASET")
.replicationSpecs(AdvancedClusterReplicationSpecArgs.builder()
.regionConfigs(AdvancedClusterReplicationSpecRegionConfigArgs.builder()
.electableSpecs(AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(3)
.build())
.analyticsSpecs(AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(1)
.build())
.providerName("AWS")
.priority(7)
.regionName("US_EAST_1")
.build())
.build())
.build());
}
}
resources:
test:
type: mongodbatlas:AdvancedCluster
properties:
projectId: PROJECT ID
name: NAME OF CLUSTER
clusterType: REPLICASET
replicationSpecs:
- regionConfigs:
- electableSpecs:
instanceSize: M10
nodeCount: 3
analyticsSpecs:
instanceSize: M10
nodeCount: 1
providerName: AWS
priority: 7
regionName: US_EAST_1
Example Tenant Cluster
import * as pulumi from "@pulumi/pulumi";
import * as mongodbatlas from "@pulumi/mongodbatlas";
const test = new mongodbatlas.AdvancedCluster("test", {
projectId: "PROJECT ID",
name: "NAME OF CLUSTER",
clusterType: "REPLICASET",
replicationSpecs: [{
regionConfigs: [{
electableSpecs: {
instanceSize: "M5",
},
providerName: "TENANT",
backingProviderName: "AWS",
regionName: "US_EAST_1",
priority: 7,
}],
}],
});
import pulumi
import pulumi_mongodbatlas as mongodbatlas
test = mongodbatlas.AdvancedCluster("test",
project_id="PROJECT ID",
name="NAME OF CLUSTER",
cluster_type="REPLICASET",
replication_specs=[mongodbatlas.AdvancedClusterReplicationSpecArgs(
region_configs=[mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs(
electable_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs(
instance_size="M5",
),
provider_name="TENANT",
backing_provider_name="AWS",
region_name="US_EAST_1",
priority=7,
)],
)])
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.NewAdvancedCluster(ctx, "test", &mongodbatlas.AdvancedClusterArgs{
ProjectId: pulumi.String("PROJECT ID"),
Name: pulumi.String("NAME OF CLUSTER"),
ClusterType: pulumi.String("REPLICASET"),
ReplicationSpecs: mongodbatlas.AdvancedClusterReplicationSpecArray{
&mongodbatlas.AdvancedClusterReplicationSpecArgs{
RegionConfigs: mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArray{
&mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs{
ElectableSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs{
InstanceSize: pulumi.String("M5"),
},
ProviderName: pulumi.String("TENANT"),
BackingProviderName: pulumi.String("AWS"),
RegionName: pulumi.String("US_EAST_1"),
Priority: pulumi.Int(7),
},
},
},
},
})
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.AdvancedCluster("test", new()
{
ProjectId = "PROJECT ID",
Name = "NAME OF CLUSTER",
ClusterType = "REPLICASET",
ReplicationSpecs = new[]
{
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecArgs
{
RegionConfigs = new[]
{
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigArgs
{
ElectableSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs
{
InstanceSize = "M5",
},
ProviderName = "TENANT",
BackingProviderName = "AWS",
RegionName = "US_EAST_1",
Priority = 7,
},
},
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mongodbatlas.AdvancedCluster;
import com.pulumi.mongodbatlas.AdvancedClusterArgs;
import com.pulumi.mongodbatlas.inputs.AdvancedClusterReplicationSpecArgs;
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 AdvancedCluster("test", AdvancedClusterArgs.builder()
.projectId("PROJECT ID")
.name("NAME OF CLUSTER")
.clusterType("REPLICASET")
.replicationSpecs(AdvancedClusterReplicationSpecArgs.builder()
.regionConfigs(AdvancedClusterReplicationSpecRegionConfigArgs.builder()
.electableSpecs(AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs.builder()
.instanceSize("M5")
.build())
.providerName("TENANT")
.backingProviderName("AWS")
.regionName("US_EAST_1")
.priority(7)
.build())
.build())
.build());
}
}
resources:
test:
type: mongodbatlas:AdvancedCluster
properties:
projectId: PROJECT ID
name: NAME OF CLUSTER
clusterType: REPLICASET
replicationSpecs:
- regionConfigs:
- electableSpecs:
instanceSize: M5
providerName: TENANT
backingProviderName: AWS
regionName: US_EAST_1
priority: 7
Example Tenant Cluster Upgrade
import * as pulumi from "@pulumi/pulumi";
import * as mongodbatlas from "@pulumi/mongodbatlas";
const test = new mongodbatlas.AdvancedCluster("test", {
projectId: "PROJECT ID",
name: "NAME OF CLUSTER",
clusterType: "REPLICASET",
replicationSpecs: [{
regionConfigs: [{
electableSpecs: {
instanceSize: "M10",
},
providerName: "AWS",
regionName: "US_EAST_1",
priority: 7,
}],
}],
});
import pulumi
import pulumi_mongodbatlas as mongodbatlas
test = mongodbatlas.AdvancedCluster("test",
project_id="PROJECT ID",
name="NAME OF CLUSTER",
cluster_type="REPLICASET",
replication_specs=[mongodbatlas.AdvancedClusterReplicationSpecArgs(
region_configs=[mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs(
electable_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs(
instance_size="M10",
),
provider_name="AWS",
region_name="US_EAST_1",
priority=7,
)],
)])
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.NewAdvancedCluster(ctx, "test", &mongodbatlas.AdvancedClusterArgs{
ProjectId: pulumi.String("PROJECT ID"),
Name: pulumi.String("NAME OF CLUSTER"),
ClusterType: pulumi.String("REPLICASET"),
ReplicationSpecs: mongodbatlas.AdvancedClusterReplicationSpecArray{
&mongodbatlas.AdvancedClusterReplicationSpecArgs{
RegionConfigs: mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArray{
&mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs{
ElectableSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs{
InstanceSize: pulumi.String("M10"),
},
ProviderName: pulumi.String("AWS"),
RegionName: pulumi.String("US_EAST_1"),
Priority: pulumi.Int(7),
},
},
},
},
})
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.AdvancedCluster("test", new()
{
ProjectId = "PROJECT ID",
Name = "NAME OF CLUSTER",
ClusterType = "REPLICASET",
ReplicationSpecs = new[]
{
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecArgs
{
RegionConfigs = new[]
{
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigArgs
{
ElectableSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs
{
InstanceSize = "M10",
},
ProviderName = "AWS",
RegionName = "US_EAST_1",
Priority = 7,
},
},
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mongodbatlas.AdvancedCluster;
import com.pulumi.mongodbatlas.AdvancedClusterArgs;
import com.pulumi.mongodbatlas.inputs.AdvancedClusterReplicationSpecArgs;
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 AdvancedCluster("test", AdvancedClusterArgs.builder()
.projectId("PROJECT ID")
.name("NAME OF CLUSTER")
.clusterType("REPLICASET")
.replicationSpecs(AdvancedClusterReplicationSpecArgs.builder()
.regionConfigs(AdvancedClusterReplicationSpecRegionConfigArgs.builder()
.electableSpecs(AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs.builder()
.instanceSize("M10")
.build())
.providerName("AWS")
.regionName("US_EAST_1")
.priority(7)
.build())
.build())
.build());
}
}
resources:
test:
type: mongodbatlas:AdvancedCluster
properties:
projectId: PROJECT ID
name: NAME OF CLUSTER
clusterType: REPLICASET
replicationSpecs:
- regionConfigs:
- electableSpecs:
instanceSize: M10
providerName: AWS
regionName: US_EAST_1
priority: 7
Example Multi-Cloud Cluster
import * as pulumi from "@pulumi/pulumi";
import * as mongodbatlas from "@pulumi/mongodbatlas";
const test = new mongodbatlas.AdvancedCluster("test", {
projectId: "PROJECT ID",
name: "NAME OF CLUSTER",
clusterType: "REPLICASET",
replicationSpecs: [{
regionConfigs: [
{
electableSpecs: {
instanceSize: "M10",
nodeCount: 3,
},
analyticsSpecs: {
instanceSize: "M10",
nodeCount: 1,
},
providerName: "AWS",
priority: 7,
regionName: "US_EAST_1",
},
{
electableSpecs: {
instanceSize: "M10",
nodeCount: 2,
},
providerName: "GCP",
priority: 6,
regionName: "NORTH_AMERICA_NORTHEAST_1",
},
],
}],
});
import pulumi
import pulumi_mongodbatlas as mongodbatlas
test = mongodbatlas.AdvancedCluster("test",
project_id="PROJECT ID",
name="NAME OF CLUSTER",
cluster_type="REPLICASET",
replication_specs=[mongodbatlas.AdvancedClusterReplicationSpecArgs(
region_configs=[
mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs(
electable_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs(
instance_size="M10",
node_count=3,
),
analytics_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs(
instance_size="M10",
node_count=1,
),
provider_name="AWS",
priority=7,
region_name="US_EAST_1",
),
mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs(
electable_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs(
instance_size="M10",
node_count=2,
),
provider_name="GCP",
priority=6,
region_name="NORTH_AMERICA_NORTHEAST_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.NewAdvancedCluster(ctx, "test", &mongodbatlas.AdvancedClusterArgs{
ProjectId: pulumi.String("PROJECT ID"),
Name: pulumi.String("NAME OF CLUSTER"),
ClusterType: pulumi.String("REPLICASET"),
ReplicationSpecs: mongodbatlas.AdvancedClusterReplicationSpecArray{
&mongodbatlas.AdvancedClusterReplicationSpecArgs{
RegionConfigs: mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArray{
&mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs{
ElectableSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(3),
},
AnalyticsSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(1),
},
ProviderName: pulumi.String("AWS"),
Priority: pulumi.Int(7),
RegionName: pulumi.String("US_EAST_1"),
},
&mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs{
ElectableSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(2),
},
ProviderName: pulumi.String("GCP"),
Priority: pulumi.Int(6),
RegionName: pulumi.String("NORTH_AMERICA_NORTHEAST_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.AdvancedCluster("test", new()
{
ProjectId = "PROJECT ID",
Name = "NAME OF CLUSTER",
ClusterType = "REPLICASET",
ReplicationSpecs = new[]
{
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecArgs
{
RegionConfigs = new[]
{
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigArgs
{
ElectableSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs
{
InstanceSize = "M10",
NodeCount = 3,
},
AnalyticsSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs
{
InstanceSize = "M10",
NodeCount = 1,
},
ProviderName = "AWS",
Priority = 7,
RegionName = "US_EAST_1",
},
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigArgs
{
ElectableSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs
{
InstanceSize = "M10",
NodeCount = 2,
},
ProviderName = "GCP",
Priority = 6,
RegionName = "NORTH_AMERICA_NORTHEAST_1",
},
},
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mongodbatlas.AdvancedCluster;
import com.pulumi.mongodbatlas.AdvancedClusterArgs;
import com.pulumi.mongodbatlas.inputs.AdvancedClusterReplicationSpecArgs;
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 AdvancedCluster("test", AdvancedClusterArgs.builder()
.projectId("PROJECT ID")
.name("NAME OF CLUSTER")
.clusterType("REPLICASET")
.replicationSpecs(AdvancedClusterReplicationSpecArgs.builder()
.regionConfigs(
AdvancedClusterReplicationSpecRegionConfigArgs.builder()
.electableSpecs(AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(3)
.build())
.analyticsSpecs(AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(1)
.build())
.providerName("AWS")
.priority(7)
.regionName("US_EAST_1")
.build(),
AdvancedClusterReplicationSpecRegionConfigArgs.builder()
.electableSpecs(AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(2)
.build())
.providerName("GCP")
.priority(6)
.regionName("NORTH_AMERICA_NORTHEAST_1")
.build())
.build())
.build());
}
}
resources:
test:
type: mongodbatlas:AdvancedCluster
properties:
projectId: PROJECT ID
name: NAME OF CLUSTER
clusterType: REPLICASET
replicationSpecs:
- regionConfigs:
- electableSpecs:
instanceSize: M10
nodeCount: 3
analyticsSpecs:
instanceSize: M10
nodeCount: 1
providerName: AWS
priority: 7
regionName: US_EAST_1
- electableSpecs:
instanceSize: M10
nodeCount: 2
providerName: GCP
priority: 6
regionName: NORTH_AMERICA_NORTHEAST_1
Example of a Multi-Cloud Cluster
import * as pulumi from "@pulumi/pulumi";
import * as mongodbatlas from "@pulumi/mongodbatlas";
const cluster = new mongodbatlas.AdvancedCluster("cluster", {
projectId: project.id,
name: clusterName,
clusterType: "SHARDED",
backupEnabled: true,
replicationSpecs: [{
numShards: 3,
regionConfigs: [
{
electableSpecs: {
instanceSize: "M10",
nodeCount: 3,
},
analyticsSpecs: {
instanceSize: "M10",
nodeCount: 1,
},
providerName: "AWS",
priority: 7,
regionName: "US_EAST_1",
},
{
electableSpecs: {
instanceSize: "M10",
nodeCount: 2,
},
analyticsSpecs: {
instanceSize: "M10",
nodeCount: 1,
},
providerName: "AZURE",
priority: 6,
regionName: "US_EAST_2",
},
{
electableSpecs: {
instanceSize: "M10",
nodeCount: 2,
},
analyticsSpecs: {
instanceSize: "M10",
nodeCount: 1,
},
providerName: "GCP",
priority: 5,
regionName: "US_EAST_4",
},
],
}],
advancedConfiguration: {
javascriptEnabled: true,
oplogSizeMb: 30,
sampleRefreshIntervalBiConnector: 300,
},
});
import pulumi
import pulumi_mongodbatlas as mongodbatlas
cluster = mongodbatlas.AdvancedCluster("cluster",
project_id=project["id"],
name=cluster_name,
cluster_type="SHARDED",
backup_enabled=True,
replication_specs=[mongodbatlas.AdvancedClusterReplicationSpecArgs(
num_shards=3,
region_configs=[
mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs(
electable_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs(
instance_size="M10",
node_count=3,
),
analytics_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs(
instance_size="M10",
node_count=1,
),
provider_name="AWS",
priority=7,
region_name="US_EAST_1",
),
mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs(
electable_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs(
instance_size="M10",
node_count=2,
),
analytics_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs(
instance_size="M10",
node_count=1,
),
provider_name="AZURE",
priority=6,
region_name="US_EAST_2",
),
mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs(
electable_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs(
instance_size="M10",
node_count=2,
),
analytics_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs(
instance_size="M10",
node_count=1,
),
provider_name="GCP",
priority=5,
region_name="US_EAST_4",
),
],
)],
advanced_configuration=mongodbatlas.AdvancedClusterAdvancedConfigurationArgs(
javascript_enabled=True,
oplog_size_mb=30,
sample_refresh_interval_bi_connector=300,
))
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.NewAdvancedCluster(ctx, "cluster", &mongodbatlas.AdvancedClusterArgs{
ProjectId: pulumi.Any(project.Id),
Name: pulumi.Any(clusterName),
ClusterType: pulumi.String("SHARDED"),
BackupEnabled: pulumi.Bool(true),
ReplicationSpecs: mongodbatlas.AdvancedClusterReplicationSpecArray{
&mongodbatlas.AdvancedClusterReplicationSpecArgs{
NumShards: pulumi.Int(3),
RegionConfigs: mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArray{
&mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs{
ElectableSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(3),
},
AnalyticsSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(1),
},
ProviderName: pulumi.String("AWS"),
Priority: pulumi.Int(7),
RegionName: pulumi.String("US_EAST_1"),
},
&mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs{
ElectableSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(2),
},
AnalyticsSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(1),
},
ProviderName: pulumi.String("AZURE"),
Priority: pulumi.Int(6),
RegionName: pulumi.String("US_EAST_2"),
},
&mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs{
ElectableSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(2),
},
AnalyticsSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(1),
},
ProviderName: pulumi.String("GCP"),
Priority: pulumi.Int(5),
RegionName: pulumi.String("US_EAST_4"),
},
},
},
},
AdvancedConfiguration: &mongodbatlas.AdvancedClusterAdvancedConfigurationArgs{
JavascriptEnabled: pulumi.Bool(true),
OplogSizeMb: pulumi.Int(30),
SampleRefreshIntervalBiConnector: pulumi.Int(300),
},
})
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 = new Mongodbatlas.AdvancedCluster("cluster", new()
{
ProjectId = project.Id,
Name = clusterName,
ClusterType = "SHARDED",
BackupEnabled = true,
ReplicationSpecs = new[]
{
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecArgs
{
NumShards = 3,
RegionConfigs = new[]
{
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigArgs
{
ElectableSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs
{
InstanceSize = "M10",
NodeCount = 3,
},
AnalyticsSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs
{
InstanceSize = "M10",
NodeCount = 1,
},
ProviderName = "AWS",
Priority = 7,
RegionName = "US_EAST_1",
},
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigArgs
{
ElectableSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs
{
InstanceSize = "M10",
NodeCount = 2,
},
AnalyticsSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs
{
InstanceSize = "M10",
NodeCount = 1,
},
ProviderName = "AZURE",
Priority = 6,
RegionName = "US_EAST_2",
},
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigArgs
{
ElectableSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs
{
InstanceSize = "M10",
NodeCount = 2,
},
AnalyticsSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs
{
InstanceSize = "M10",
NodeCount = 1,
},
ProviderName = "GCP",
Priority = 5,
RegionName = "US_EAST_4",
},
},
},
},
AdvancedConfiguration = new Mongodbatlas.Inputs.AdvancedClusterAdvancedConfigurationArgs
{
JavascriptEnabled = true,
OplogSizeMb = 30,
SampleRefreshIntervalBiConnector = 300,
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mongodbatlas.AdvancedCluster;
import com.pulumi.mongodbatlas.AdvancedClusterArgs;
import com.pulumi.mongodbatlas.inputs.AdvancedClusterReplicationSpecArgs;
import com.pulumi.mongodbatlas.inputs.AdvancedClusterAdvancedConfigurationArgs;
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 = new AdvancedCluster("cluster", AdvancedClusterArgs.builder()
.projectId(project.id())
.name(clusterName)
.clusterType("SHARDED")
.backupEnabled(true)
.replicationSpecs(AdvancedClusterReplicationSpecArgs.builder()
.numShards(3)
.regionConfigs(
AdvancedClusterReplicationSpecRegionConfigArgs.builder()
.electableSpecs(AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(3)
.build())
.analyticsSpecs(AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(1)
.build())
.providerName("AWS")
.priority(7)
.regionName("US_EAST_1")
.build(),
AdvancedClusterReplicationSpecRegionConfigArgs.builder()
.electableSpecs(AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(2)
.build())
.analyticsSpecs(AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(1)
.build())
.providerName("AZURE")
.priority(6)
.regionName("US_EAST_2")
.build(),
AdvancedClusterReplicationSpecRegionConfigArgs.builder()
.electableSpecs(AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(2)
.build())
.analyticsSpecs(AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(1)
.build())
.providerName("GCP")
.priority(5)
.regionName("US_EAST_4")
.build())
.build())
.advancedConfiguration(AdvancedClusterAdvancedConfigurationArgs.builder()
.javascriptEnabled(true)
.oplogSizeMb(30)
.sampleRefreshIntervalBiConnector(300)
.build())
.build());
}
}
resources:
cluster:
type: mongodbatlas:AdvancedCluster
properties:
projectId: ${project.id}
name: ${clusterName}
clusterType: SHARDED
backupEnabled: true
replicationSpecs:
- numShards: 3
regionConfigs:
- electableSpecs:
instanceSize: M10
nodeCount: 3
analyticsSpecs:
instanceSize: M10
nodeCount: 1
providerName: AWS
priority: 7
regionName: US_EAST_1
- electableSpecs:
instanceSize: M10
nodeCount: 2
analyticsSpecs:
instanceSize: M10
nodeCount: 1
providerName: AZURE
priority: 6
regionName: US_EAST_2
- electableSpecs:
instanceSize: M10
nodeCount: 2
analyticsSpecs:
instanceSize: M10
nodeCount: 1
providerName: GCP
priority: 5
regionName: US_EAST_4
advancedConfiguration:
javascriptEnabled: true
oplogSizeMb: 30
sampleRefreshIntervalBiConnector: 300
Example of a Global Cluster
import * as pulumi from "@pulumi/pulumi";
import * as mongodbatlas from "@pulumi/mongodbatlas";
const cluster = new mongodbatlas.AdvancedCluster("cluster", {
projectId: project.id,
name: clusterName,
clusterType: "GEOSHARDED",
backupEnabled: true,
replicationSpecs: [
{
zoneName: "zone n1",
numShards: 3,
regionConfigs: [
{
electableSpecs: {
instanceSize: "M10",
nodeCount: 3,
},
analyticsSpecs: {
instanceSize: "M10",
nodeCount: 1,
},
providerName: "AWS",
priority: 7,
regionName: "US_EAST_1",
},
{
electableSpecs: {
instanceSize: "M10",
nodeCount: 2,
},
analyticsSpecs: {
instanceSize: "M10",
nodeCount: 1,
},
providerName: "AZURE",
priority: 6,
regionName: "US_EAST_2",
},
{
electableSpecs: {
instanceSize: "M10",
nodeCount: 2,
},
analyticsSpecs: {
instanceSize: "M10",
nodeCount: 1,
},
providerName: "GCP",
priority: 5,
regionName: "US_EAST_4",
},
],
},
{
zoneName: "zone n2",
numShards: 2,
regionConfigs: [
{
electableSpecs: {
instanceSize: "M10",
nodeCount: 3,
},
analyticsSpecs: {
instanceSize: "M10",
nodeCount: 1,
},
providerName: "AWS",
priority: 7,
regionName: "EU_WEST_1",
},
{
electableSpecs: {
instanceSize: "M10",
nodeCount: 2,
},
analyticsSpecs: {
instanceSize: "M10",
nodeCount: 1,
},
providerName: "AZURE",
priority: 6,
regionName: "EUROPE_NORTH",
},
{
electableSpecs: {
instanceSize: "M10",
nodeCount: 2,
},
analyticsSpecs: {
instanceSize: "M10",
nodeCount: 1,
},
providerName: "GCP",
priority: 5,
regionName: "US_EAST_4",
},
],
},
],
advancedConfiguration: {
javascriptEnabled: true,
oplogSizeMb: 999,
sampleRefreshIntervalBiConnector: 300,
},
});
import pulumi
import pulumi_mongodbatlas as mongodbatlas
cluster = mongodbatlas.AdvancedCluster("cluster",
project_id=project["id"],
name=cluster_name,
cluster_type="GEOSHARDED",
backup_enabled=True,
replication_specs=[
mongodbatlas.AdvancedClusterReplicationSpecArgs(
zone_name="zone n1",
num_shards=3,
region_configs=[
mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs(
electable_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs(
instance_size="M10",
node_count=3,
),
analytics_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs(
instance_size="M10",
node_count=1,
),
provider_name="AWS",
priority=7,
region_name="US_EAST_1",
),
mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs(
electable_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs(
instance_size="M10",
node_count=2,
),
analytics_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs(
instance_size="M10",
node_count=1,
),
provider_name="AZURE",
priority=6,
region_name="US_EAST_2",
),
mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs(
electable_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs(
instance_size="M10",
node_count=2,
),
analytics_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs(
instance_size="M10",
node_count=1,
),
provider_name="GCP",
priority=5,
region_name="US_EAST_4",
),
],
),
mongodbatlas.AdvancedClusterReplicationSpecArgs(
zone_name="zone n2",
num_shards=2,
region_configs=[
mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs(
electable_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs(
instance_size="M10",
node_count=3,
),
analytics_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs(
instance_size="M10",
node_count=1,
),
provider_name="AWS",
priority=7,
region_name="EU_WEST_1",
),
mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs(
electable_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs(
instance_size="M10",
node_count=2,
),
analytics_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs(
instance_size="M10",
node_count=1,
),
provider_name="AZURE",
priority=6,
region_name="EUROPE_NORTH",
),
mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs(
electable_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs(
instance_size="M10",
node_count=2,
),
analytics_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs(
instance_size="M10",
node_count=1,
),
provider_name="GCP",
priority=5,
region_name="US_EAST_4",
),
],
),
],
advanced_configuration=mongodbatlas.AdvancedClusterAdvancedConfigurationArgs(
javascript_enabled=True,
oplog_size_mb=999,
sample_refresh_interval_bi_connector=300,
))
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.NewAdvancedCluster(ctx, "cluster", &mongodbatlas.AdvancedClusterArgs{
ProjectId: pulumi.Any(project.Id),
Name: pulumi.Any(clusterName),
ClusterType: pulumi.String("GEOSHARDED"),
BackupEnabled: pulumi.Bool(true),
ReplicationSpecs: mongodbatlas.AdvancedClusterReplicationSpecArray{
&mongodbatlas.AdvancedClusterReplicationSpecArgs{
ZoneName: pulumi.String("zone n1"),
NumShards: pulumi.Int(3),
RegionConfigs: mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArray{
&mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs{
ElectableSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(3),
},
AnalyticsSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(1),
},
ProviderName: pulumi.String("AWS"),
Priority: pulumi.Int(7),
RegionName: pulumi.String("US_EAST_1"),
},
&mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs{
ElectableSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(2),
},
AnalyticsSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(1),
},
ProviderName: pulumi.String("AZURE"),
Priority: pulumi.Int(6),
RegionName: pulumi.String("US_EAST_2"),
},
&mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs{
ElectableSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(2),
},
AnalyticsSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(1),
},
ProviderName: pulumi.String("GCP"),
Priority: pulumi.Int(5),
RegionName: pulumi.String("US_EAST_4"),
},
},
},
&mongodbatlas.AdvancedClusterReplicationSpecArgs{
ZoneName: pulumi.String("zone n2"),
NumShards: pulumi.Int(2),
RegionConfigs: mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArray{
&mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs{
ElectableSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(3),
},
AnalyticsSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(1),
},
ProviderName: pulumi.String("AWS"),
Priority: pulumi.Int(7),
RegionName: pulumi.String("EU_WEST_1"),
},
&mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs{
ElectableSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(2),
},
AnalyticsSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(1),
},
ProviderName: pulumi.String("AZURE"),
Priority: pulumi.Int(6),
RegionName: pulumi.String("EUROPE_NORTH"),
},
&mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs{
ElectableSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(2),
},
AnalyticsSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs{
InstanceSize: pulumi.String("M10"),
NodeCount: pulumi.Int(1),
},
ProviderName: pulumi.String("GCP"),
Priority: pulumi.Int(5),
RegionName: pulumi.String("US_EAST_4"),
},
},
},
},
AdvancedConfiguration: &mongodbatlas.AdvancedClusterAdvancedConfigurationArgs{
JavascriptEnabled: pulumi.Bool(true),
OplogSizeMb: pulumi.Int(999),
SampleRefreshIntervalBiConnector: pulumi.Int(300),
},
})
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 = new Mongodbatlas.AdvancedCluster("cluster", new()
{
ProjectId = project.Id,
Name = clusterName,
ClusterType = "GEOSHARDED",
BackupEnabled = true,
ReplicationSpecs = new[]
{
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecArgs
{
ZoneName = "zone n1",
NumShards = 3,
RegionConfigs = new[]
{
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigArgs
{
ElectableSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs
{
InstanceSize = "M10",
NodeCount = 3,
},
AnalyticsSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs
{
InstanceSize = "M10",
NodeCount = 1,
},
ProviderName = "AWS",
Priority = 7,
RegionName = "US_EAST_1",
},
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigArgs
{
ElectableSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs
{
InstanceSize = "M10",
NodeCount = 2,
},
AnalyticsSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs
{
InstanceSize = "M10",
NodeCount = 1,
},
ProviderName = "AZURE",
Priority = 6,
RegionName = "US_EAST_2",
},
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigArgs
{
ElectableSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs
{
InstanceSize = "M10",
NodeCount = 2,
},
AnalyticsSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs
{
InstanceSize = "M10",
NodeCount = 1,
},
ProviderName = "GCP",
Priority = 5,
RegionName = "US_EAST_4",
},
},
},
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecArgs
{
ZoneName = "zone n2",
NumShards = 2,
RegionConfigs = new[]
{
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigArgs
{
ElectableSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs
{
InstanceSize = "M10",
NodeCount = 3,
},
AnalyticsSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs
{
InstanceSize = "M10",
NodeCount = 1,
},
ProviderName = "AWS",
Priority = 7,
RegionName = "EU_WEST_1",
},
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigArgs
{
ElectableSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs
{
InstanceSize = "M10",
NodeCount = 2,
},
AnalyticsSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs
{
InstanceSize = "M10",
NodeCount = 1,
},
ProviderName = "AZURE",
Priority = 6,
RegionName = "EUROPE_NORTH",
},
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigArgs
{
ElectableSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs
{
InstanceSize = "M10",
NodeCount = 2,
},
AnalyticsSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs
{
InstanceSize = "M10",
NodeCount = 1,
},
ProviderName = "GCP",
Priority = 5,
RegionName = "US_EAST_4",
},
},
},
},
AdvancedConfiguration = new Mongodbatlas.Inputs.AdvancedClusterAdvancedConfigurationArgs
{
JavascriptEnabled = true,
OplogSizeMb = 999,
SampleRefreshIntervalBiConnector = 300,
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mongodbatlas.AdvancedCluster;
import com.pulumi.mongodbatlas.AdvancedClusterArgs;
import com.pulumi.mongodbatlas.inputs.AdvancedClusterReplicationSpecArgs;
import com.pulumi.mongodbatlas.inputs.AdvancedClusterAdvancedConfigurationArgs;
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 = new AdvancedCluster("cluster", AdvancedClusterArgs.builder()
.projectId(project.id())
.name(clusterName)
.clusterType("GEOSHARDED")
.backupEnabled(true)
.replicationSpecs(
AdvancedClusterReplicationSpecArgs.builder()
.zoneName("zone n1")
.numShards(3)
.regionConfigs(
AdvancedClusterReplicationSpecRegionConfigArgs.builder()
.electableSpecs(AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(3)
.build())
.analyticsSpecs(AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(1)
.build())
.providerName("AWS")
.priority(7)
.regionName("US_EAST_1")
.build(),
AdvancedClusterReplicationSpecRegionConfigArgs.builder()
.electableSpecs(AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(2)
.build())
.analyticsSpecs(AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(1)
.build())
.providerName("AZURE")
.priority(6)
.regionName("US_EAST_2")
.build(),
AdvancedClusterReplicationSpecRegionConfigArgs.builder()
.electableSpecs(AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(2)
.build())
.analyticsSpecs(AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(1)
.build())
.providerName("GCP")
.priority(5)
.regionName("US_EAST_4")
.build())
.build(),
AdvancedClusterReplicationSpecArgs.builder()
.zoneName("zone n2")
.numShards(2)
.regionConfigs(
AdvancedClusterReplicationSpecRegionConfigArgs.builder()
.electableSpecs(AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(3)
.build())
.analyticsSpecs(AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(1)
.build())
.providerName("AWS")
.priority(7)
.regionName("EU_WEST_1")
.build(),
AdvancedClusterReplicationSpecRegionConfigArgs.builder()
.electableSpecs(AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(2)
.build())
.analyticsSpecs(AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(1)
.build())
.providerName("AZURE")
.priority(6)
.regionName("EUROPE_NORTH")
.build(),
AdvancedClusterReplicationSpecRegionConfigArgs.builder()
.electableSpecs(AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(2)
.build())
.analyticsSpecs(AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs.builder()
.instanceSize("M10")
.nodeCount(1)
.build())
.providerName("GCP")
.priority(5)
.regionName("US_EAST_4")
.build())
.build())
.advancedConfiguration(AdvancedClusterAdvancedConfigurationArgs.builder()
.javascriptEnabled(true)
.oplogSizeMb(999)
.sampleRefreshIntervalBiConnector(300)
.build())
.build());
}
}
resources:
cluster:
type: mongodbatlas:AdvancedCluster
properties:
projectId: ${project.id}
name: ${clusterName}
clusterType: GEOSHARDED
backupEnabled: true
replicationSpecs:
- zoneName: zone n1
numShards: 3
regionConfigs:
- electableSpecs:
instanceSize: M10
nodeCount: 3
analyticsSpecs:
instanceSize: M10
nodeCount: 1
providerName: AWS
priority: 7
regionName: US_EAST_1
- electableSpecs:
instanceSize: M10
nodeCount: 2
analyticsSpecs:
instanceSize: M10
nodeCount: 1
providerName: AZURE
priority: 6
regionName: US_EAST_2
- electableSpecs:
instanceSize: M10
nodeCount: 2
analyticsSpecs:
instanceSize: M10
nodeCount: 1
providerName: GCP
priority: 5
regionName: US_EAST_4
- zoneName: zone n2
numShards: 2
regionConfigs:
- electableSpecs:
instanceSize: M10
nodeCount: 3
analyticsSpecs:
instanceSize: M10
nodeCount: 1
providerName: AWS
priority: 7
regionName: EU_WEST_1
- electableSpecs:
instanceSize: M10
nodeCount: 2
analyticsSpecs:
instanceSize: M10
nodeCount: 1
providerName: AZURE
priority: 6
regionName: EUROPE_NORTH
- electableSpecs:
instanceSize: M10
nodeCount: 2
analyticsSpecs:
instanceSize: M10
nodeCount: 1
providerName: GCP
priority: 5
regionName: US_EAST_4
advancedConfiguration:
javascriptEnabled: true
oplogSizeMb: 999
sampleRefreshIntervalBiConnector: 300
Example - Return a Connection String
Standard
import * as pulumi from "@pulumi/pulumi";
export const standard = cluster_test.connectionStrings[0].standard;
import pulumi
pulumi.export("standard", cluster_test["connectionStrings"][0]["standard"])
package main
import (
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
ctx.Export("standard", cluster_test.ConnectionStrings[0].Standard)
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
return await Deployment.RunAsync(() =>
{
return new Dictionary<string, object?>
{
["standard"] = cluster_test.ConnectionStrings[0].Standard,
};
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
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) {
ctx.export("standard", cluster_test.connectionStrings()[0].standard());
}
}
outputs:
standard: ${["cluster-test"].connectionStrings[0].standard}
Standard srv
import * as pulumi from "@pulumi/pulumi";
export const standardSrv = cluster_test.connectionStrings[0].standardSrv;
import pulumi
pulumi.export("standardSrv", cluster_test["connectionStrings"][0]["standardSrv"])
package main
import (
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
ctx.Export("standardSrv", cluster_test.ConnectionStrings[0].StandardSrv)
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
return await Deployment.RunAsync(() =>
{
return new Dictionary<string, object?>
{
["standardSrv"] = cluster_test.ConnectionStrings[0].StandardSrv,
};
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
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) {
ctx.export("standardSrv", cluster_test.connectionStrings()[0].standardSrv());
}
}
outputs:
standardSrv: ${["cluster-test"].connectionStrings[0].standardSrv}
Private with Network peering and Custom DNS AWS enabled
Import
Clusters can be imported using project ID and cluster name, in the format PROJECTID-CLUSTERNAME, e.g.
$ pulumi import mongodbatlas:index/advancedCluster:AdvancedCluster my_cluster 1112222b3bf99403840e8934-Cluster0
See detailed information for arguments and attributes: MongoDB API Advanced Clusters
Create AdvancedCluster Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new AdvancedCluster(name: string, args: AdvancedClusterArgs, opts?: CustomResourceOptions);@overload
def AdvancedCluster(resource_name: str,
args: AdvancedClusterArgs,
opts: Optional[ResourceOptions] = None)
@overload
def AdvancedCluster(resource_name: str,
opts: Optional[ResourceOptions] = None,
project_id: Optional[str] = None,
cluster_type: Optional[str] = None,
replication_specs: Optional[Sequence[AdvancedClusterReplicationSpecArgs]] = None,
disk_size_gb: Optional[float] = None,
pit_enabled: Optional[bool] = None,
advanced_configuration: Optional[AdvancedClusterAdvancedConfigurationArgs] = None,
encryption_at_rest_provider: Optional[str] = None,
labels: Optional[Sequence[AdvancedClusterLabelArgs]] = None,
backup_enabled: Optional[bool] = None,
version_release_system: Optional[str] = None,
bi_connector_config: Optional[AdvancedClusterBiConnectorConfigArgs] = None,
paused: Optional[bool] = None,
accept_data_risks_and_force_replica_set_reconfig: Optional[str] = None,
mongo_db_major_version: Optional[str] = None,
retain_backups_enabled: Optional[bool] = None,
root_cert_type: Optional[str] = None,
tags: Optional[Sequence[AdvancedClusterTagArgs]] = None,
termination_protection_enabled: Optional[bool] = None,
name: Optional[str] = None)func NewAdvancedCluster(ctx *Context, name string, args AdvancedClusterArgs, opts ...ResourceOption) (*AdvancedCluster, error)public AdvancedCluster(string name, AdvancedClusterArgs args, CustomResourceOptions? opts = null)
public AdvancedCluster(String name, AdvancedClusterArgs args)
public AdvancedCluster(String name, AdvancedClusterArgs args, CustomResourceOptions options)
type: mongodbatlas:AdvancedCluster
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 AdvancedClusterArgs
- 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 AdvancedClusterArgs
- 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 AdvancedClusterArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args AdvancedClusterArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args AdvancedClusterArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Example
The following reference example uses placeholder values for all input properties.
var advancedClusterResource = new Mongodbatlas.AdvancedCluster("advancedClusterResource", new()
{
ProjectId = "string",
ClusterType = "string",
ReplicationSpecs = new[]
{
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecArgs
{
RegionConfigs = new[]
{
new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigArgs
{
Priority = 0,
ProviderName = "string",
RegionName = "string",
AnalyticsAutoScaling = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigAnalyticsAutoScalingArgs
{
ComputeEnabled = false,
ComputeMaxInstanceSize = "string",
ComputeMinInstanceSize = "string",
ComputeScaleDownEnabled = false,
DiskGbEnabled = false,
},
AnalyticsSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs
{
InstanceSize = "string",
DiskIops = 0,
EbsVolumeType = "string",
NodeCount = 0,
},
AutoScaling = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigAutoScalingArgs
{
ComputeEnabled = false,
ComputeMaxInstanceSize = "string",
ComputeMinInstanceSize = "string",
ComputeScaleDownEnabled = false,
DiskGbEnabled = false,
},
BackingProviderName = "string",
ElectableSpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs
{
InstanceSize = "string",
DiskIops = 0,
EbsVolumeType = "string",
NodeCount = 0,
},
ReadOnlySpecs = new Mongodbatlas.Inputs.AdvancedClusterReplicationSpecRegionConfigReadOnlySpecsArgs
{
InstanceSize = "string",
DiskIops = 0,
EbsVolumeType = "string",
NodeCount = 0,
},
},
},
ContainerId =
{
{ "string", "string" },
},
Id = "string",
NumShards = 0,
ZoneName = "string",
},
},
DiskSizeGb = 0,
PitEnabled = false,
AdvancedConfiguration = new Mongodbatlas.Inputs.AdvancedClusterAdvancedConfigurationArgs
{
DefaultReadConcern = "string",
DefaultWriteConcern = "string",
FailIndexKeyTooLong = false,
JavascriptEnabled = false,
MinimumEnabledTlsProtocol = "string",
NoTableScan = false,
OplogMinRetentionHours = 0,
OplogSizeMb = 0,
SampleRefreshIntervalBiConnector = 0,
SampleSizeBiConnector = 0,
TransactionLifetimeLimitSeconds = 0,
},
EncryptionAtRestProvider = "string",
BackupEnabled = false,
VersionReleaseSystem = "string",
BiConnectorConfig = new Mongodbatlas.Inputs.AdvancedClusterBiConnectorConfigArgs
{
Enabled = false,
ReadPreference = "string",
},
Paused = false,
AcceptDataRisksAndForceReplicaSetReconfig = "string",
MongoDbMajorVersion = "string",
RetainBackupsEnabled = false,
RootCertType = "string",
Tags = new[]
{
new Mongodbatlas.Inputs.AdvancedClusterTagArgs
{
Key = "string",
Value = "string",
},
},
TerminationProtectionEnabled = false,
Name = "string",
});
example, err := mongodbatlas.NewAdvancedCluster(ctx, "advancedClusterResource", &mongodbatlas.AdvancedClusterArgs{
ProjectId: pulumi.String("string"),
ClusterType: pulumi.String("string"),
ReplicationSpecs: mongodbatlas.AdvancedClusterReplicationSpecArray{
&mongodbatlas.AdvancedClusterReplicationSpecArgs{
RegionConfigs: mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArray{
&mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs{
Priority: pulumi.Int(0),
ProviderName: pulumi.String("string"),
RegionName: pulumi.String("string"),
AnalyticsAutoScaling: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsAutoScalingArgs{
ComputeEnabled: pulumi.Bool(false),
ComputeMaxInstanceSize: pulumi.String("string"),
ComputeMinInstanceSize: pulumi.String("string"),
ComputeScaleDownEnabled: pulumi.Bool(false),
DiskGbEnabled: pulumi.Bool(false),
},
AnalyticsSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs{
InstanceSize: pulumi.String("string"),
DiskIops: pulumi.Int(0),
EbsVolumeType: pulumi.String("string"),
NodeCount: pulumi.Int(0),
},
AutoScaling: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAutoScalingArgs{
ComputeEnabled: pulumi.Bool(false),
ComputeMaxInstanceSize: pulumi.String("string"),
ComputeMinInstanceSize: pulumi.String("string"),
ComputeScaleDownEnabled: pulumi.Bool(false),
DiskGbEnabled: pulumi.Bool(false),
},
BackingProviderName: pulumi.String("string"),
ElectableSpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs{
InstanceSize: pulumi.String("string"),
DiskIops: pulumi.Int(0),
EbsVolumeType: pulumi.String("string"),
NodeCount: pulumi.Int(0),
},
ReadOnlySpecs: &mongodbatlas.AdvancedClusterReplicationSpecRegionConfigReadOnlySpecsArgs{
InstanceSize: pulumi.String("string"),
DiskIops: pulumi.Int(0),
EbsVolumeType: pulumi.String("string"),
NodeCount: pulumi.Int(0),
},
},
},
ContainerId: pulumi.StringMap{
"string": pulumi.String("string"),
},
Id: pulumi.String("string"),
NumShards: pulumi.Int(0),
ZoneName: pulumi.String("string"),
},
},
DiskSizeGb: pulumi.Float64(0),
PitEnabled: pulumi.Bool(false),
AdvancedConfiguration: &mongodbatlas.AdvancedClusterAdvancedConfigurationArgs{
DefaultReadConcern: pulumi.String("string"),
DefaultWriteConcern: pulumi.String("string"),
FailIndexKeyTooLong: pulumi.Bool(false),
JavascriptEnabled: pulumi.Bool(false),
MinimumEnabledTlsProtocol: pulumi.String("string"),
NoTableScan: pulumi.Bool(false),
OplogMinRetentionHours: pulumi.Int(0),
OplogSizeMb: pulumi.Int(0),
SampleRefreshIntervalBiConnector: pulumi.Int(0),
SampleSizeBiConnector: pulumi.Int(0),
TransactionLifetimeLimitSeconds: pulumi.Int(0),
},
EncryptionAtRestProvider: pulumi.String("string"),
BackupEnabled: pulumi.Bool(false),
VersionReleaseSystem: pulumi.String("string"),
BiConnectorConfig: &mongodbatlas.AdvancedClusterBiConnectorConfigArgs{
Enabled: pulumi.Bool(false),
ReadPreference: pulumi.String("string"),
},
Paused: pulumi.Bool(false),
AcceptDataRisksAndForceReplicaSetReconfig: pulumi.String("string"),
MongoDbMajorVersion: pulumi.String("string"),
RetainBackupsEnabled: pulumi.Bool(false),
RootCertType: pulumi.String("string"),
Tags: mongodbatlas.AdvancedClusterTagArray{
&mongodbatlas.AdvancedClusterTagArgs{
Key: pulumi.String("string"),
Value: pulumi.String("string"),
},
},
TerminationProtectionEnabled: pulumi.Bool(false),
Name: pulumi.String("string"),
})
var advancedClusterResource = new AdvancedCluster("advancedClusterResource", AdvancedClusterArgs.builder()
.projectId("string")
.clusterType("string")
.replicationSpecs(AdvancedClusterReplicationSpecArgs.builder()
.regionConfigs(AdvancedClusterReplicationSpecRegionConfigArgs.builder()
.priority(0)
.providerName("string")
.regionName("string")
.analyticsAutoScaling(AdvancedClusterReplicationSpecRegionConfigAnalyticsAutoScalingArgs.builder()
.computeEnabled(false)
.computeMaxInstanceSize("string")
.computeMinInstanceSize("string")
.computeScaleDownEnabled(false)
.diskGbEnabled(false)
.build())
.analyticsSpecs(AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs.builder()
.instanceSize("string")
.diskIops(0)
.ebsVolumeType("string")
.nodeCount(0)
.build())
.autoScaling(AdvancedClusterReplicationSpecRegionConfigAutoScalingArgs.builder()
.computeEnabled(false)
.computeMaxInstanceSize("string")
.computeMinInstanceSize("string")
.computeScaleDownEnabled(false)
.diskGbEnabled(false)
.build())
.backingProviderName("string")
.electableSpecs(AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs.builder()
.instanceSize("string")
.diskIops(0)
.ebsVolumeType("string")
.nodeCount(0)
.build())
.readOnlySpecs(AdvancedClusterReplicationSpecRegionConfigReadOnlySpecsArgs.builder()
.instanceSize("string")
.diskIops(0)
.ebsVolumeType("string")
.nodeCount(0)
.build())
.build())
.containerId(Map.of("string", "string"))
.id("string")
.numShards(0)
.zoneName("string")
.build())
.diskSizeGb(0)
.pitEnabled(false)
.advancedConfiguration(AdvancedClusterAdvancedConfigurationArgs.builder()
.defaultReadConcern("string")
.defaultWriteConcern("string")
.failIndexKeyTooLong(false)
.javascriptEnabled(false)
.minimumEnabledTlsProtocol("string")
.noTableScan(false)
.oplogMinRetentionHours(0)
.oplogSizeMb(0)
.sampleRefreshIntervalBiConnector(0)
.sampleSizeBiConnector(0)
.transactionLifetimeLimitSeconds(0)
.build())
.encryptionAtRestProvider("string")
.backupEnabled(false)
.versionReleaseSystem("string")
.biConnectorConfig(AdvancedClusterBiConnectorConfigArgs.builder()
.enabled(false)
.readPreference("string")
.build())
.paused(false)
.acceptDataRisksAndForceReplicaSetReconfig("string")
.mongoDbMajorVersion("string")
.retainBackupsEnabled(false)
.rootCertType("string")
.tags(AdvancedClusterTagArgs.builder()
.key("string")
.value("string")
.build())
.terminationProtectionEnabled(false)
.name("string")
.build());
advanced_cluster_resource = mongodbatlas.AdvancedCluster("advancedClusterResource",
project_id="string",
cluster_type="string",
replication_specs=[mongodbatlas.AdvancedClusterReplicationSpecArgs(
region_configs=[mongodbatlas.AdvancedClusterReplicationSpecRegionConfigArgs(
priority=0,
provider_name="string",
region_name="string",
analytics_auto_scaling=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsAutoScalingArgs(
compute_enabled=False,
compute_max_instance_size="string",
compute_min_instance_size="string",
compute_scale_down_enabled=False,
disk_gb_enabled=False,
),
analytics_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs(
instance_size="string",
disk_iops=0,
ebs_volume_type="string",
node_count=0,
),
auto_scaling=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigAutoScalingArgs(
compute_enabled=False,
compute_max_instance_size="string",
compute_min_instance_size="string",
compute_scale_down_enabled=False,
disk_gb_enabled=False,
),
backing_provider_name="string",
electable_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs(
instance_size="string",
disk_iops=0,
ebs_volume_type="string",
node_count=0,
),
read_only_specs=mongodbatlas.AdvancedClusterReplicationSpecRegionConfigReadOnlySpecsArgs(
instance_size="string",
disk_iops=0,
ebs_volume_type="string",
node_count=0,
),
)],
container_id={
"string": "string",
},
id="string",
num_shards=0,
zone_name="string",
)],
disk_size_gb=0,
pit_enabled=False,
advanced_configuration=mongodbatlas.AdvancedClusterAdvancedConfigurationArgs(
default_read_concern="string",
default_write_concern="string",
fail_index_key_too_long=False,
javascript_enabled=False,
minimum_enabled_tls_protocol="string",
no_table_scan=False,
oplog_min_retention_hours=0,
oplog_size_mb=0,
sample_refresh_interval_bi_connector=0,
sample_size_bi_connector=0,
transaction_lifetime_limit_seconds=0,
),
encryption_at_rest_provider="string",
backup_enabled=False,
version_release_system="string",
bi_connector_config=mongodbatlas.AdvancedClusterBiConnectorConfigArgs(
enabled=False,
read_preference="string",
),
paused=False,
accept_data_risks_and_force_replica_set_reconfig="string",
mongo_db_major_version="string",
retain_backups_enabled=False,
root_cert_type="string",
tags=[mongodbatlas.AdvancedClusterTagArgs(
key="string",
value="string",
)],
termination_protection_enabled=False,
name="string")
const advancedClusterResource = new mongodbatlas.AdvancedCluster("advancedClusterResource", {
projectId: "string",
clusterType: "string",
replicationSpecs: [{
regionConfigs: [{
priority: 0,
providerName: "string",
regionName: "string",
analyticsAutoScaling: {
computeEnabled: false,
computeMaxInstanceSize: "string",
computeMinInstanceSize: "string",
computeScaleDownEnabled: false,
diskGbEnabled: false,
},
analyticsSpecs: {
instanceSize: "string",
diskIops: 0,
ebsVolumeType: "string",
nodeCount: 0,
},
autoScaling: {
computeEnabled: false,
computeMaxInstanceSize: "string",
computeMinInstanceSize: "string",
computeScaleDownEnabled: false,
diskGbEnabled: false,
},
backingProviderName: "string",
electableSpecs: {
instanceSize: "string",
diskIops: 0,
ebsVolumeType: "string",
nodeCount: 0,
},
readOnlySpecs: {
instanceSize: "string",
diskIops: 0,
ebsVolumeType: "string",
nodeCount: 0,
},
}],
containerId: {
string: "string",
},
id: "string",
numShards: 0,
zoneName: "string",
}],
diskSizeGb: 0,
pitEnabled: false,
advancedConfiguration: {
defaultReadConcern: "string",
defaultWriteConcern: "string",
failIndexKeyTooLong: false,
javascriptEnabled: false,
minimumEnabledTlsProtocol: "string",
noTableScan: false,
oplogMinRetentionHours: 0,
oplogSizeMb: 0,
sampleRefreshIntervalBiConnector: 0,
sampleSizeBiConnector: 0,
transactionLifetimeLimitSeconds: 0,
},
encryptionAtRestProvider: "string",
backupEnabled: false,
versionReleaseSystem: "string",
biConnectorConfig: {
enabled: false,
readPreference: "string",
},
paused: false,
acceptDataRisksAndForceReplicaSetReconfig: "string",
mongoDbMajorVersion: "string",
retainBackupsEnabled: false,
rootCertType: "string",
tags: [{
key: "string",
value: "string",
}],
terminationProtectionEnabled: false,
name: "string",
});
type: mongodbatlas:AdvancedCluster
properties:
acceptDataRisksAndForceReplicaSetReconfig: string
advancedConfiguration:
defaultReadConcern: string
defaultWriteConcern: string
failIndexKeyTooLong: false
javascriptEnabled: false
minimumEnabledTlsProtocol: string
noTableScan: false
oplogMinRetentionHours: 0
oplogSizeMb: 0
sampleRefreshIntervalBiConnector: 0
sampleSizeBiConnector: 0
transactionLifetimeLimitSeconds: 0
backupEnabled: false
biConnectorConfig:
enabled: false
readPreference: string
clusterType: string
diskSizeGb: 0
encryptionAtRestProvider: string
mongoDbMajorVersion: string
name: string
paused: false
pitEnabled: false
projectId: string
replicationSpecs:
- containerId:
string: string
id: string
numShards: 0
regionConfigs:
- analyticsAutoScaling:
computeEnabled: false
computeMaxInstanceSize: string
computeMinInstanceSize: string
computeScaleDownEnabled: false
diskGbEnabled: false
analyticsSpecs:
diskIops: 0
ebsVolumeType: string
instanceSize: string
nodeCount: 0
autoScaling:
computeEnabled: false
computeMaxInstanceSize: string
computeMinInstanceSize: string
computeScaleDownEnabled: false
diskGbEnabled: false
backingProviderName: string
electableSpecs:
diskIops: 0
ebsVolumeType: string
instanceSize: string
nodeCount: 0
priority: 0
providerName: string
readOnlySpecs:
diskIops: 0
ebsVolumeType: string
instanceSize: string
nodeCount: 0
regionName: string
zoneName: string
retainBackupsEnabled: false
rootCertType: string
tags:
- key: string
value: string
terminationProtectionEnabled: false
versionReleaseSystem: string
AdvancedCluster 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 AdvancedCluster resource accepts the following input properties:
- Cluster
Type string - Type of the cluster that you want to create.
Accepted values include:
REPLICASETReplica setSHARDEDSharded clusterGEOSHARDEDGlobal Cluster
- Project
Id string - Unique ID for the project to create the database user.
- Replication
Specs List<AdvancedCluster Replication Spec> - Configuration for cluster regions and the hardware provisioned in them. See below
- Accept
Data stringRisks And Force Replica Set Reconfig - If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set
accept_data_risks_and_force_replica_set_reconfigto the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - Advanced
Configuration AdvancedCluster Advanced Configuration - Backup
Enabled bool Flag that indicates whether the cluster can perform backups. If
true, the cluster can perform backups. You must set this value totruefor NVMe clusters.Backup uses: Cloud Backups for dedicated clusters. Shared Cluster Backups for tenant clusters. If "
backup_enabled" :false, the cluster doesn't use Atlas backups.This parameter defaults to false.
- Bi
Connector AdvancedConfig Cluster Bi Connector Config - Configuration settings applied to BI Connector for Atlas on this cluster. The MongoDB Connector for Business Intelligence for Atlas (BI Connector) is only available for M10 and larger clusters. The BI Connector is a powerful tool which provides users SQL-based access to their MongoDB databases. As a result, the BI Connector performs operations which may be CPU and memory intensive. Given the limited hardware resources on M10 and M20 cluster tiers, you may experience performance degradation of the cluster when enabling the BI Connector. If this occurs, upgrade to an M30 or larger cluster or disable the BI Connector. See below.
- Disk
Size doubleGb - Capacity, in gigabytes, of the host's root volume. Increase this number to add capacity, up to a maximum possible value of 4096 (i.e., 4 TB). This value must be a positive number. You can't set this value with clusters with local NVMe SSDs. The minimum disk size for dedicated clusters is 10 GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value. If your cluster includes Azure nodes, this value must correspond to an existing Azure disk type (8, 16, 32, 64, 128, 256, 512, 1024, 2048, or 4095)Atlas calculates storage charges differently depending on whether you choose the default value or a custom value. The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require additional storage space beyond this limitation, consider upgrading your cluster to a higher tier. If your cluster spans cloud service providers, this value defaults to the minimum default of the providers involved.
- Encryption
At stringRest Provider - Possible values are AWS, GCP, AZURE or NONE. Only needed if you desire to manage the keys, see Encryption at Rest using Customer Key Management for complete documentation. You must configure encryption at rest for the Atlas project before enabling it on any cluster in the project. For Documentation, see AWS, GCP and Azure. Requirements are if
replication_specs.#.region_configs.#.<type>Specs.instance_sizeis M10 or greater andbackup_enabledis false or omitted. - Labels
List<Advanced
Cluster Label> - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below. DEPRECATED Use
tagsinstead. - Mongo
Db stringMajor Version - Version of the cluster to deploy. Atlas supports the following MongoDB versions for M10+ clusters:
4.4,5.0,6.0or7.0. If omitted, Atlas deploys a cluster that runs MongoDB 7.0. Ifreplication_specs#.region_configs#.<type>Specs.instance_size:M0,M2orM5, Atlas deploys MongoDB 4.4. Atlas always deploys the cluster with the latest stable release of the specified version. If you set a value to this parameter and setversion_release_systemCONTINUOUS, the resource returns an error. Either clear this parameter or setversion_release_system:LTS. - Name string
- Name of the cluster as it appears in Atlas. Once the cluster is created, its name cannot be changed. WARNING Changing the name will result in destruction of the existing cluster and the creation of a new cluster.
- Paused bool
- Pit
Enabled bool - Flag that indicates if the cluster uses Continuous Cloud Backup.
- Retain
Backups boolEnabled - Flag that indicates whether to retain backup snapshots for the deleted dedicated cluster
- Root
Cert stringType - Certificate Authority that MongoDB Atlas clusters use. You can specify ISRGROOTX1 (for ISRG Root X1).
-
List<Advanced
Cluster Tag> - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
- Termination
Protection boolEnabled - Flag that indicates whether termination protection is enabled on the cluster. If set to true, MongoDB Cloud won't delete the cluster. If set to false, MongoDB Cloud will delete the cluster.
- Version
Release stringSystem - Release cadence that Atlas uses for this cluster. This parameter defaults to
LTS. If you set this field toCONTINUOUS, you must omit themongo_db_major_versionfield. Atlas accepts:CONTINUOUS: Atlas creates your cluster using the most recent MongoDB release. Atlas automatically updates your cluster to the latest major and rapid MongoDB releases as they become available.LTS: Atlas creates your cluster using the latest patch release of the MongoDB version that you specify in the mongoDBMajorVersion field. Atlas automatically updates your cluster to subsequent patch releases of this MongoDB version. Atlas doesn't update your cluster to newer rapid or major MongoDB releases as they become available.
- Cluster
Type string - Type of the cluster that you want to create.
Accepted values include:
REPLICASETReplica setSHARDEDSharded clusterGEOSHARDEDGlobal Cluster
- Project
Id string - Unique ID for the project to create the database user.
- Replication
Specs []AdvancedCluster Replication Spec Args - Configuration for cluster regions and the hardware provisioned in them. See below
- Accept
Data stringRisks And Force Replica Set Reconfig - If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set
accept_data_risks_and_force_replica_set_reconfigto the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - Advanced
Configuration AdvancedCluster Advanced Configuration Args - Backup
Enabled bool Flag that indicates whether the cluster can perform backups. If
true, the cluster can perform backups. You must set this value totruefor NVMe clusters.Backup uses: Cloud Backups for dedicated clusters. Shared Cluster Backups for tenant clusters. If "
backup_enabled" :false, the cluster doesn't use Atlas backups.This parameter defaults to false.
- Bi
Connector AdvancedConfig Cluster Bi Connector Config Args - Configuration settings applied to BI Connector for Atlas on this cluster. The MongoDB Connector for Business Intelligence for Atlas (BI Connector) is only available for M10 and larger clusters. The BI Connector is a powerful tool which provides users SQL-based access to their MongoDB databases. As a result, the BI Connector performs operations which may be CPU and memory intensive. Given the limited hardware resources on M10 and M20 cluster tiers, you may experience performance degradation of the cluster when enabling the BI Connector. If this occurs, upgrade to an M30 or larger cluster or disable the BI Connector. See below.
- Disk
Size float64Gb - Capacity, in gigabytes, of the host's root volume. Increase this number to add capacity, up to a maximum possible value of 4096 (i.e., 4 TB). This value must be a positive number. You can't set this value with clusters with local NVMe SSDs. The minimum disk size for dedicated clusters is 10 GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value. If your cluster includes Azure nodes, this value must correspond to an existing Azure disk type (8, 16, 32, 64, 128, 256, 512, 1024, 2048, or 4095)Atlas calculates storage charges differently depending on whether you choose the default value or a custom value. The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require additional storage space beyond this limitation, consider upgrading your cluster to a higher tier. If your cluster spans cloud service providers, this value defaults to the minimum default of the providers involved.
- Encryption
At stringRest Provider - Possible values are AWS, GCP, AZURE or NONE. Only needed if you desire to manage the keys, see Encryption at Rest using Customer Key Management for complete documentation. You must configure encryption at rest for the Atlas project before enabling it on any cluster in the project. For Documentation, see AWS, GCP and Azure. Requirements are if
replication_specs.#.region_configs.#.<type>Specs.instance_sizeis M10 or greater andbackup_enabledis false or omitted. - Labels
[]Advanced
Cluster Label Args - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below. DEPRECATED Use
tagsinstead. - Mongo
Db stringMajor Version - Version of the cluster to deploy. Atlas supports the following MongoDB versions for M10+ clusters:
4.4,5.0,6.0or7.0. If omitted, Atlas deploys a cluster that runs MongoDB 7.0. Ifreplication_specs#.region_configs#.<type>Specs.instance_size:M0,M2orM5, Atlas deploys MongoDB 4.4. Atlas always deploys the cluster with the latest stable release of the specified version. If you set a value to this parameter and setversion_release_systemCONTINUOUS, the resource returns an error. Either clear this parameter or setversion_release_system:LTS. - Name string
- Name of the cluster as it appears in Atlas. Once the cluster is created, its name cannot be changed. WARNING Changing the name will result in destruction of the existing cluster and the creation of a new cluster.
- Paused bool
- Pit
Enabled bool - Flag that indicates if the cluster uses Continuous Cloud Backup.
- Retain
Backups boolEnabled - Flag that indicates whether to retain backup snapshots for the deleted dedicated cluster
- Root
Cert stringType - Certificate Authority that MongoDB Atlas clusters use. You can specify ISRGROOTX1 (for ISRG Root X1).
-
[]Advanced
Cluster Tag Args - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
- Termination
Protection boolEnabled - Flag that indicates whether termination protection is enabled on the cluster. If set to true, MongoDB Cloud won't delete the cluster. If set to false, MongoDB Cloud will delete the cluster.
- Version
Release stringSystem - Release cadence that Atlas uses for this cluster. This parameter defaults to
LTS. If you set this field toCONTINUOUS, you must omit themongo_db_major_versionfield. Atlas accepts:CONTINUOUS: Atlas creates your cluster using the most recent MongoDB release. Atlas automatically updates your cluster to the latest major and rapid MongoDB releases as they become available.LTS: Atlas creates your cluster using the latest patch release of the MongoDB version that you specify in the mongoDBMajorVersion field. Atlas automatically updates your cluster to subsequent patch releases of this MongoDB version. Atlas doesn't update your cluster to newer rapid or major MongoDB releases as they become available.
- cluster
Type String - Type of the cluster that you want to create.
Accepted values include:
REPLICASETReplica setSHARDEDSharded clusterGEOSHARDEDGlobal Cluster
- project
Id String - Unique ID for the project to create the database user.
- replication
Specs List<AdvancedCluster Replication Spec> - Configuration for cluster regions and the hardware provisioned in them. See below
- accept
Data StringRisks And Force Replica Set Reconfig - If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set
accept_data_risks_and_force_replica_set_reconfigto the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - advanced
Configuration AdvancedCluster Advanced Configuration - backup
Enabled Boolean Flag that indicates whether the cluster can perform backups. If
true, the cluster can perform backups. You must set this value totruefor NVMe clusters.Backup uses: Cloud Backups for dedicated clusters. Shared Cluster Backups for tenant clusters. If "
backup_enabled" :false, the cluster doesn't use Atlas backups.This parameter defaults to false.
- bi
Connector AdvancedConfig Cluster Bi Connector Config - Configuration settings applied to BI Connector for Atlas on this cluster. The MongoDB Connector for Business Intelligence for Atlas (BI Connector) is only available for M10 and larger clusters. The BI Connector is a powerful tool which provides users SQL-based access to their MongoDB databases. As a result, the BI Connector performs operations which may be CPU and memory intensive. Given the limited hardware resources on M10 and M20 cluster tiers, you may experience performance degradation of the cluster when enabling the BI Connector. If this occurs, upgrade to an M30 or larger cluster or disable the BI Connector. See below.
- disk
Size DoubleGb - Capacity, in gigabytes, of the host's root volume. Increase this number to add capacity, up to a maximum possible value of 4096 (i.e., 4 TB). This value must be a positive number. You can't set this value with clusters with local NVMe SSDs. The minimum disk size for dedicated clusters is 10 GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value. If your cluster includes Azure nodes, this value must correspond to an existing Azure disk type (8, 16, 32, 64, 128, 256, 512, 1024, 2048, or 4095)Atlas calculates storage charges differently depending on whether you choose the default value or a custom value. The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require additional storage space beyond this limitation, consider upgrading your cluster to a higher tier. If your cluster spans cloud service providers, this value defaults to the minimum default of the providers involved.
- encryption
At StringRest Provider - Possible values are AWS, GCP, AZURE or NONE. Only needed if you desire to manage the keys, see Encryption at Rest using Customer Key Management for complete documentation. You must configure encryption at rest for the Atlas project before enabling it on any cluster in the project. For Documentation, see AWS, GCP and Azure. Requirements are if
replication_specs.#.region_configs.#.<type>Specs.instance_sizeis M10 or greater andbackup_enabledis false or omitted. - labels
List<Advanced
Cluster Label> - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below. DEPRECATED Use
tagsinstead. - mongo
Db StringMajor Version - Version of the cluster to deploy. Atlas supports the following MongoDB versions for M10+ clusters:
4.4,5.0,6.0or7.0. If omitted, Atlas deploys a cluster that runs MongoDB 7.0. Ifreplication_specs#.region_configs#.<type>Specs.instance_size:M0,M2orM5, Atlas deploys MongoDB 4.4. Atlas always deploys the cluster with the latest stable release of the specified version. If you set a value to this parameter and setversion_release_systemCONTINUOUS, the resource returns an error. Either clear this parameter or setversion_release_system:LTS. - name String
- Name of the cluster as it appears in Atlas. Once the cluster is created, its name cannot be changed. WARNING Changing the name will result in destruction of the existing cluster and the creation of a new cluster.
- paused Boolean
- pit
Enabled Boolean - Flag that indicates if the cluster uses Continuous Cloud Backup.
- retain
Backups BooleanEnabled - Flag that indicates whether to retain backup snapshots for the deleted dedicated cluster
- root
Cert StringType - Certificate Authority that MongoDB Atlas clusters use. You can specify ISRGROOTX1 (for ISRG Root X1).
-
List<Advanced
Cluster Tag> - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
- termination
Protection BooleanEnabled - Flag that indicates whether termination protection is enabled on the cluster. If set to true, MongoDB Cloud won't delete the cluster. If set to false, MongoDB Cloud will delete the cluster.
- version
Release StringSystem - Release cadence that Atlas uses for this cluster. This parameter defaults to
LTS. If you set this field toCONTINUOUS, you must omit themongo_db_major_versionfield. Atlas accepts:CONTINUOUS: Atlas creates your cluster using the most recent MongoDB release. Atlas automatically updates your cluster to the latest major and rapid MongoDB releases as they become available.LTS: Atlas creates your cluster using the latest patch release of the MongoDB version that you specify in the mongoDBMajorVersion field. Atlas automatically updates your cluster to subsequent patch releases of this MongoDB version. Atlas doesn't update your cluster to newer rapid or major MongoDB releases as they become available.
- cluster
Type string - Type of the cluster that you want to create.
Accepted values include:
REPLICASETReplica setSHARDEDSharded clusterGEOSHARDEDGlobal Cluster
- project
Id string - Unique ID for the project to create the database user.
- replication
Specs AdvancedCluster Replication Spec[] - Configuration for cluster regions and the hardware provisioned in them. See below
- accept
Data stringRisks And Force Replica Set Reconfig - If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set
accept_data_risks_and_force_replica_set_reconfigto the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - advanced
Configuration AdvancedCluster Advanced Configuration - backup
Enabled boolean Flag that indicates whether the cluster can perform backups. If
true, the cluster can perform backups. You must set this value totruefor NVMe clusters.Backup uses: Cloud Backups for dedicated clusters. Shared Cluster Backups for tenant clusters. If "
backup_enabled" :false, the cluster doesn't use Atlas backups.This parameter defaults to false.
- bi
Connector AdvancedConfig Cluster Bi Connector Config - Configuration settings applied to BI Connector for Atlas on this cluster. The MongoDB Connector for Business Intelligence for Atlas (BI Connector) is only available for M10 and larger clusters. The BI Connector is a powerful tool which provides users SQL-based access to their MongoDB databases. As a result, the BI Connector performs operations which may be CPU and memory intensive. Given the limited hardware resources on M10 and M20 cluster tiers, you may experience performance degradation of the cluster when enabling the BI Connector. If this occurs, upgrade to an M30 or larger cluster or disable the BI Connector. See below.
- disk
Size numberGb - Capacity, in gigabytes, of the host's root volume. Increase this number to add capacity, up to a maximum possible value of 4096 (i.e., 4 TB). This value must be a positive number. You can't set this value with clusters with local NVMe SSDs. The minimum disk size for dedicated clusters is 10 GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value. If your cluster includes Azure nodes, this value must correspond to an existing Azure disk type (8, 16, 32, 64, 128, 256, 512, 1024, 2048, or 4095)Atlas calculates storage charges differently depending on whether you choose the default value or a custom value. The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require additional storage space beyond this limitation, consider upgrading your cluster to a higher tier. If your cluster spans cloud service providers, this value defaults to the minimum default of the providers involved.
- encryption
At stringRest Provider - Possible values are AWS, GCP, AZURE or NONE. Only needed if you desire to manage the keys, see Encryption at Rest using Customer Key Management for complete documentation. You must configure encryption at rest for the Atlas project before enabling it on any cluster in the project. For Documentation, see AWS, GCP and Azure. Requirements are if
replication_specs.#.region_configs.#.<type>Specs.instance_sizeis M10 or greater andbackup_enabledis false or omitted. - labels
Advanced
Cluster Label[] - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below. DEPRECATED Use
tagsinstead. - mongo
Db stringMajor Version - Version of the cluster to deploy. Atlas supports the following MongoDB versions for M10+ clusters:
4.4,5.0,6.0or7.0. If omitted, Atlas deploys a cluster that runs MongoDB 7.0. Ifreplication_specs#.region_configs#.<type>Specs.instance_size:M0,M2orM5, Atlas deploys MongoDB 4.4. Atlas always deploys the cluster with the latest stable release of the specified version. If you set a value to this parameter and setversion_release_systemCONTINUOUS, the resource returns an error. Either clear this parameter or setversion_release_system:LTS. - name string
- Name of the cluster as it appears in Atlas. Once the cluster is created, its name cannot be changed. WARNING Changing the name will result in destruction of the existing cluster and the creation of a new cluster.
- paused boolean
- pit
Enabled boolean - Flag that indicates if the cluster uses Continuous Cloud Backup.
- retain
Backups booleanEnabled - Flag that indicates whether to retain backup snapshots for the deleted dedicated cluster
- root
Cert stringType - Certificate Authority that MongoDB Atlas clusters use. You can specify ISRGROOTX1 (for ISRG Root X1).
-
Advanced
Cluster Tag[] - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
- termination
Protection booleanEnabled - Flag that indicates whether termination protection is enabled on the cluster. If set to true, MongoDB Cloud won't delete the cluster. If set to false, MongoDB Cloud will delete the cluster.
- version
Release stringSystem - Release cadence that Atlas uses for this cluster. This parameter defaults to
LTS. If you set this field toCONTINUOUS, you must omit themongo_db_major_versionfield. Atlas accepts:CONTINUOUS: Atlas creates your cluster using the most recent MongoDB release. Atlas automatically updates your cluster to the latest major and rapid MongoDB releases as they become available.LTS: Atlas creates your cluster using the latest patch release of the MongoDB version that you specify in the mongoDBMajorVersion field. Atlas automatically updates your cluster to subsequent patch releases of this MongoDB version. Atlas doesn't update your cluster to newer rapid or major MongoDB releases as they become available.
- cluster_
type str - Type of the cluster that you want to create.
Accepted values include:
REPLICASETReplica setSHARDEDSharded clusterGEOSHARDEDGlobal Cluster
- project_
id str - Unique ID for the project to create the database user.
- replication_
specs Sequence[AdvancedCluster Replication Spec Args] - Configuration for cluster regions and the hardware provisioned in them. See below
- accept_
data_ strrisks_ and_ force_ replica_ set_ reconfig - If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set
accept_data_risks_and_force_replica_set_reconfigto the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - advanced_
configuration AdvancedCluster Advanced Configuration Args - backup_
enabled bool Flag that indicates whether the cluster can perform backups. If
true, the cluster can perform backups. You must set this value totruefor NVMe clusters.Backup uses: Cloud Backups for dedicated clusters. Shared Cluster Backups for tenant clusters. If "
backup_enabled" :false, the cluster doesn't use Atlas backups.This parameter defaults to false.
- bi_
connector_ Advancedconfig Cluster Bi Connector Config Args - Configuration settings applied to BI Connector for Atlas on this cluster. The MongoDB Connector for Business Intelligence for Atlas (BI Connector) is only available for M10 and larger clusters. The BI Connector is a powerful tool which provides users SQL-based access to their MongoDB databases. As a result, the BI Connector performs operations which may be CPU and memory intensive. Given the limited hardware resources on M10 and M20 cluster tiers, you may experience performance degradation of the cluster when enabling the BI Connector. If this occurs, upgrade to an M30 or larger cluster or disable the BI Connector. See below.
- disk_
size_ floatgb - Capacity, in gigabytes, of the host's root volume. Increase this number to add capacity, up to a maximum possible value of 4096 (i.e., 4 TB). This value must be a positive number. You can't set this value with clusters with local NVMe SSDs. The minimum disk size for dedicated clusters is 10 GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value. If your cluster includes Azure nodes, this value must correspond to an existing Azure disk type (8, 16, 32, 64, 128, 256, 512, 1024, 2048, or 4095)Atlas calculates storage charges differently depending on whether you choose the default value or a custom value. The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require additional storage space beyond this limitation, consider upgrading your cluster to a higher tier. If your cluster spans cloud service providers, this value defaults to the minimum default of the providers involved.
- encryption_
at_ strrest_ provider - Possible values are AWS, GCP, AZURE or NONE. Only needed if you desire to manage the keys, see Encryption at Rest using Customer Key Management for complete documentation. You must configure encryption at rest for the Atlas project before enabling it on any cluster in the project. For Documentation, see AWS, GCP and Azure. Requirements are if
replication_specs.#.region_configs.#.<type>Specs.instance_sizeis M10 or greater andbackup_enabledis false or omitted. - labels
Sequence[Advanced
Cluster Label Args] - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below. DEPRECATED Use
tagsinstead. - mongo_
db_ strmajor_ version - Version of the cluster to deploy. Atlas supports the following MongoDB versions for M10+ clusters:
4.4,5.0,6.0or7.0. If omitted, Atlas deploys a cluster that runs MongoDB 7.0. Ifreplication_specs#.region_configs#.<type>Specs.instance_size:M0,M2orM5, Atlas deploys MongoDB 4.4. Atlas always deploys the cluster with the latest stable release of the specified version. If you set a value to this parameter and setversion_release_systemCONTINUOUS, the resource returns an error. Either clear this parameter or setversion_release_system:LTS. - name str
- Name of the cluster as it appears in Atlas. Once the cluster is created, its name cannot be changed. WARNING Changing the name will result in destruction of the existing cluster and the creation of a new cluster.
- paused bool
- pit_
enabled bool - Flag that indicates if the cluster uses Continuous Cloud Backup.
- retain_
backups_ boolenabled - Flag that indicates whether to retain backup snapshots for the deleted dedicated cluster
- root_
cert_ strtype - Certificate Authority that MongoDB Atlas clusters use. You can specify ISRGROOTX1 (for ISRG Root X1).
-
Sequence[Advanced
Cluster Tag Args] - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
- termination_
protection_ boolenabled - Flag that indicates whether termination protection is enabled on the cluster. If set to true, MongoDB Cloud won't delete the cluster. If set to false, MongoDB Cloud will delete the cluster.
- version_
release_ strsystem - Release cadence that Atlas uses for this cluster. This parameter defaults to
LTS. If you set this field toCONTINUOUS, you must omit themongo_db_major_versionfield. Atlas accepts:CONTINUOUS: Atlas creates your cluster using the most recent MongoDB release. Atlas automatically updates your cluster to the latest major and rapid MongoDB releases as they become available.LTS: Atlas creates your cluster using the latest patch release of the MongoDB version that you specify in the mongoDBMajorVersion field. Atlas automatically updates your cluster to subsequent patch releases of this MongoDB version. Atlas doesn't update your cluster to newer rapid or major MongoDB releases as they become available.
- cluster
Type String - Type of the cluster that you want to create.
Accepted values include:
REPLICASETReplica setSHARDEDSharded clusterGEOSHARDEDGlobal Cluster
- project
Id String - Unique ID for the project to create the database user.
- replication
Specs List<Property Map> - Configuration for cluster regions and the hardware provisioned in them. See below
- accept
Data StringRisks And Force Replica Set Reconfig - If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set
accept_data_risks_and_force_replica_set_reconfigto the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - advanced
Configuration Property Map - backup
Enabled Boolean Flag that indicates whether the cluster can perform backups. If
true, the cluster can perform backups. You must set this value totruefor NVMe clusters.Backup uses: Cloud Backups for dedicated clusters. Shared Cluster Backups for tenant clusters. If "
backup_enabled" :false, the cluster doesn't use Atlas backups.This parameter defaults to false.
- bi
Connector Property MapConfig - Configuration settings applied to BI Connector for Atlas on this cluster. The MongoDB Connector for Business Intelligence for Atlas (BI Connector) is only available for M10 and larger clusters. The BI Connector is a powerful tool which provides users SQL-based access to their MongoDB databases. As a result, the BI Connector performs operations which may be CPU and memory intensive. Given the limited hardware resources on M10 and M20 cluster tiers, you may experience performance degradation of the cluster when enabling the BI Connector. If this occurs, upgrade to an M30 or larger cluster or disable the BI Connector. See below.
- disk
Size NumberGb - Capacity, in gigabytes, of the host's root volume. Increase this number to add capacity, up to a maximum possible value of 4096 (i.e., 4 TB). This value must be a positive number. You can't set this value with clusters with local NVMe SSDs. The minimum disk size for dedicated clusters is 10 GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value. If your cluster includes Azure nodes, this value must correspond to an existing Azure disk type (8, 16, 32, 64, 128, 256, 512, 1024, 2048, or 4095)Atlas calculates storage charges differently depending on whether you choose the default value or a custom value. The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require additional storage space beyond this limitation, consider upgrading your cluster to a higher tier. If your cluster spans cloud service providers, this value defaults to the minimum default of the providers involved.
- encryption
At StringRest Provider - Possible values are AWS, GCP, AZURE or NONE. Only needed if you desire to manage the keys, see Encryption at Rest using Customer Key Management for complete documentation. You must configure encryption at rest for the Atlas project before enabling it on any cluster in the project. For Documentation, see AWS, GCP and Azure. Requirements are if
replication_specs.#.region_configs.#.<type>Specs.instance_sizeis M10 or greater andbackup_enabledis false or omitted. - labels List<Property Map>
- Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below. DEPRECATED Use
tagsinstead. - mongo
Db StringMajor Version - Version of the cluster to deploy. Atlas supports the following MongoDB versions for M10+ clusters:
4.4,5.0,6.0or7.0. If omitted, Atlas deploys a cluster that runs MongoDB 7.0. Ifreplication_specs#.region_configs#.<type>Specs.instance_size:M0,M2orM5, Atlas deploys MongoDB 4.4. Atlas always deploys the cluster with the latest stable release of the specified version. If you set a value to this parameter and setversion_release_systemCONTINUOUS, the resource returns an error. Either clear this parameter or setversion_release_system:LTS. - name String
- Name of the cluster as it appears in Atlas. Once the cluster is created, its name cannot be changed. WARNING Changing the name will result in destruction of the existing cluster and the creation of a new cluster.
- paused Boolean
- pit
Enabled Boolean - Flag that indicates if the cluster uses Continuous Cloud Backup.
- retain
Backups BooleanEnabled - Flag that indicates whether to retain backup snapshots for the deleted dedicated cluster
- root
Cert StringType - Certificate Authority that MongoDB Atlas clusters use. You can specify ISRGROOTX1 (for ISRG Root X1).
- List<Property Map>
- Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
- termination
Protection BooleanEnabled - Flag that indicates whether termination protection is enabled on the cluster. If set to true, MongoDB Cloud won't delete the cluster. If set to false, MongoDB Cloud will delete the cluster.
- version
Release StringSystem - Release cadence that Atlas uses for this cluster. This parameter defaults to
LTS. If you set this field toCONTINUOUS, you must omit themongo_db_major_versionfield. Atlas accepts:CONTINUOUS: Atlas creates your cluster using the most recent MongoDB release. Atlas automatically updates your cluster to the latest major and rapid MongoDB releases as they become available.LTS: Atlas creates your cluster using the latest patch release of the MongoDB version that you specify in the mongoDBMajorVersion field. Atlas automatically updates your cluster to subsequent patch releases of this MongoDB version. Atlas doesn't update your cluster to newer rapid or major MongoDB releases as they become available.
Outputs
All input properties are implicitly available as output properties. Additionally, the AdvancedCluster resource produces the following output properties:
- Cluster
Id string - The cluster ID.
- Connection
Strings List<AdvancedCluster Connection String> - Set of connection strings that your applications use to connect to this cluster. More info in Connection-strings. Use the parameters in this object to connect your applications to this cluster. To learn more about the formats of connection strings, see Connection String Options. NOTE: Atlas returns the contents of this object after the cluster is operational, not while it builds the cluster.
- Create
Date string - Id string
- The provider-assigned unique ID for this managed resource.
- Mongo
Db stringVersion - Version of MongoDB the cluster runs, in
major-version.minor-versionformat. - State
Name string - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
- Cluster
Id string - The cluster ID.
- Connection
Strings []AdvancedCluster Connection String - Set of connection strings that your applications use to connect to this cluster. More info in Connection-strings. Use the parameters in this object to connect your applications to this cluster. To learn more about the formats of connection strings, see Connection String Options. NOTE: Atlas returns the contents of this object after the cluster is operational, not while it builds the cluster.
- Create
Date string - Id string
- The provider-assigned unique ID for this managed resource.
- Mongo
Db stringVersion - Version of MongoDB the cluster runs, in
major-version.minor-versionformat. - State
Name string - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
- cluster
Id String - The cluster ID.
- connection
Strings List<AdvancedCluster Connection String> - Set of connection strings that your applications use to connect to this cluster. More info in Connection-strings. Use the parameters in this object to connect your applications to this cluster. To learn more about the formats of connection strings, see Connection String Options. NOTE: Atlas returns the contents of this object after the cluster is operational, not while it builds the cluster.
- create
Date String - id String
- The provider-assigned unique ID for this managed resource.
- mongo
Db StringVersion - Version of MongoDB the cluster runs, in
major-version.minor-versionformat. - state
Name String - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
- cluster
Id string - The cluster ID.
- connection
Strings AdvancedCluster Connection String[] - Set of connection strings that your applications use to connect to this cluster. More info in Connection-strings. Use the parameters in this object to connect your applications to this cluster. To learn more about the formats of connection strings, see Connection String Options. NOTE: Atlas returns the contents of this object after the cluster is operational, not while it builds the cluster.
- create
Date string - id string
- The provider-assigned unique ID for this managed resource.
- mongo
Db stringVersion - Version of MongoDB the cluster runs, in
major-version.minor-versionformat. - state
Name string - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
- cluster_
id str - The cluster ID.
- connection_
strings Sequence[AdvancedCluster Connection String] - Set of connection strings that your applications use to connect to this cluster. More info in Connection-strings. Use the parameters in this object to connect your applications to this cluster. To learn more about the formats of connection strings, see Connection String Options. NOTE: Atlas returns the contents of this object after the cluster is operational, not while it builds the cluster.
- create_
date str - id str
- The provider-assigned unique ID for this managed resource.
- mongo_
db_ strversion - Version of MongoDB the cluster runs, in
major-version.minor-versionformat. - state_
name str - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
- cluster
Id String - The cluster ID.
- connection
Strings List<Property Map> - Set of connection strings that your applications use to connect to this cluster. More info in Connection-strings. Use the parameters in this object to connect your applications to this cluster. To learn more about the formats of connection strings, see Connection String Options. NOTE: Atlas returns the contents of this object after the cluster is operational, not while it builds the cluster.
- create
Date String - id String
- The provider-assigned unique ID for this managed resource.
- mongo
Db StringVersion - Version of MongoDB the cluster runs, in
major-version.minor-versionformat. - state
Name String - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
Look up Existing AdvancedCluster Resource
Get an existing AdvancedCluster 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?: AdvancedClusterState, opts?: CustomResourceOptions): AdvancedCluster@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
accept_data_risks_and_force_replica_set_reconfig: Optional[str] = None,
advanced_configuration: Optional[AdvancedClusterAdvancedConfigurationArgs] = None,
backup_enabled: Optional[bool] = None,
bi_connector_config: Optional[AdvancedClusterBiConnectorConfigArgs] = None,
cluster_id: Optional[str] = None,
cluster_type: Optional[str] = None,
connection_strings: Optional[Sequence[AdvancedClusterConnectionStringArgs]] = None,
create_date: Optional[str] = None,
disk_size_gb: Optional[float] = None,
encryption_at_rest_provider: Optional[str] = None,
labels: Optional[Sequence[AdvancedClusterLabelArgs]] = None,
mongo_db_major_version: Optional[str] = None,
mongo_db_version: Optional[str] = None,
name: Optional[str] = None,
paused: Optional[bool] = None,
pit_enabled: Optional[bool] = None,
project_id: Optional[str] = None,
replication_specs: Optional[Sequence[AdvancedClusterReplicationSpecArgs]] = None,
retain_backups_enabled: Optional[bool] = None,
root_cert_type: Optional[str] = None,
state_name: Optional[str] = None,
tags: Optional[Sequence[AdvancedClusterTagArgs]] = None,
termination_protection_enabled: Optional[bool] = None,
version_release_system: Optional[str] = None) -> AdvancedClusterfunc GetAdvancedCluster(ctx *Context, name string, id IDInput, state *AdvancedClusterState, opts ...ResourceOption) (*AdvancedCluster, error)public static AdvancedCluster Get(string name, Input<string> id, AdvancedClusterState? state, CustomResourceOptions? opts = null)public static AdvancedCluster get(String name, Output<String> id, AdvancedClusterState 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.
- Accept
Data stringRisks And Force Replica Set Reconfig - If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set
accept_data_risks_and_force_replica_set_reconfigto the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - Advanced
Configuration AdvancedCluster Advanced Configuration - Backup
Enabled bool Flag that indicates whether the cluster can perform backups. If
true, the cluster can perform backups. You must set this value totruefor NVMe clusters.Backup uses: Cloud Backups for dedicated clusters. Shared Cluster Backups for tenant clusters. If "
backup_enabled" :false, the cluster doesn't use Atlas backups.This parameter defaults to false.
- Bi
Connector AdvancedConfig Cluster Bi Connector Config - Configuration settings applied to BI Connector for Atlas on this cluster. The MongoDB Connector for Business Intelligence for Atlas (BI Connector) is only available for M10 and larger clusters. The BI Connector is a powerful tool which provides users SQL-based access to their MongoDB databases. As a result, the BI Connector performs operations which may be CPU and memory intensive. Given the limited hardware resources on M10 and M20 cluster tiers, you may experience performance degradation of the cluster when enabling the BI Connector. If this occurs, upgrade to an M30 or larger cluster or disable the BI Connector. See below.
- Cluster
Id string - The cluster ID.
- Cluster
Type string - Type of the cluster that you want to create.
Accepted values include:
REPLICASETReplica setSHARDEDSharded clusterGEOSHARDEDGlobal Cluster
- Connection
Strings List<AdvancedCluster Connection String> - Set of connection strings that your applications use to connect to this cluster. More info in Connection-strings. Use the parameters in this object to connect your applications to this cluster. To learn more about the formats of connection strings, see Connection String Options. NOTE: Atlas returns the contents of this object after the cluster is operational, not while it builds the cluster.
- Create
Date string - Disk
Size doubleGb - Capacity, in gigabytes, of the host's root volume. Increase this number to add capacity, up to a maximum possible value of 4096 (i.e., 4 TB). This value must be a positive number. You can't set this value with clusters with local NVMe SSDs. The minimum disk size for dedicated clusters is 10 GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value. If your cluster includes Azure nodes, this value must correspond to an existing Azure disk type (8, 16, 32, 64, 128, 256, 512, 1024, 2048, or 4095)Atlas calculates storage charges differently depending on whether you choose the default value or a custom value. The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require additional storage space beyond this limitation, consider upgrading your cluster to a higher tier. If your cluster spans cloud service providers, this value defaults to the minimum default of the providers involved.
- Encryption
At stringRest Provider - Possible values are AWS, GCP, AZURE or NONE. Only needed if you desire to manage the keys, see Encryption at Rest using Customer Key Management for complete documentation. You must configure encryption at rest for the Atlas project before enabling it on any cluster in the project. For Documentation, see AWS, GCP and Azure. Requirements are if
replication_specs.#.region_configs.#.<type>Specs.instance_sizeis M10 or greater andbackup_enabledis false or omitted. - Labels
List<Advanced
Cluster Label> - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below. DEPRECATED Use
tagsinstead. - Mongo
Db stringMajor Version - Version of the cluster to deploy. Atlas supports the following MongoDB versions for M10+ clusters:
4.4,5.0,6.0or7.0. If omitted, Atlas deploys a cluster that runs MongoDB 7.0. Ifreplication_specs#.region_configs#.<type>Specs.instance_size:M0,M2orM5, Atlas deploys MongoDB 4.4. Atlas always deploys the cluster with the latest stable release of the specified version. If you set a value to this parameter and setversion_release_systemCONTINUOUS, the resource returns an error. Either clear this parameter or setversion_release_system:LTS. - Mongo
Db stringVersion - Version of MongoDB the cluster runs, in
major-version.minor-versionformat. - Name string
- Name of the cluster as it appears in Atlas. Once the cluster is created, its name cannot be changed. WARNING Changing the name will result in destruction of the existing cluster and the creation of a new cluster.
- Paused bool
- Pit
Enabled bool - Flag that indicates if the cluster uses Continuous Cloud Backup.
- Project
Id string - Unique ID for the project to create the database user.
- Replication
Specs List<AdvancedCluster Replication Spec> - Configuration for cluster regions and the hardware provisioned in them. See below
- Retain
Backups boolEnabled - Flag that indicates whether to retain backup snapshots for the deleted dedicated cluster
- Root
Cert stringType - Certificate Authority that MongoDB Atlas clusters use. You can specify ISRGROOTX1 (for ISRG Root X1).
- State
Name string - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
-
List<Advanced
Cluster Tag> - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
- Termination
Protection boolEnabled - Flag that indicates whether termination protection is enabled on the cluster. If set to true, MongoDB Cloud won't delete the cluster. If set to false, MongoDB Cloud will delete the cluster.
- Version
Release stringSystem - Release cadence that Atlas uses for this cluster. This parameter defaults to
LTS. If you set this field toCONTINUOUS, you must omit themongo_db_major_versionfield. Atlas accepts:CONTINUOUS: Atlas creates your cluster using the most recent MongoDB release. Atlas automatically updates your cluster to the latest major and rapid MongoDB releases as they become available.LTS: Atlas creates your cluster using the latest patch release of the MongoDB version that you specify in the mongoDBMajorVersion field. Atlas automatically updates your cluster to subsequent patch releases of this MongoDB version. Atlas doesn't update your cluster to newer rapid or major MongoDB releases as they become available.
- Accept
Data stringRisks And Force Replica Set Reconfig - If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set
accept_data_risks_and_force_replica_set_reconfigto the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - Advanced
Configuration AdvancedCluster Advanced Configuration Args - Backup
Enabled bool Flag that indicates whether the cluster can perform backups. If
true, the cluster can perform backups. You must set this value totruefor NVMe clusters.Backup uses: Cloud Backups for dedicated clusters. Shared Cluster Backups for tenant clusters. If "
backup_enabled" :false, the cluster doesn't use Atlas backups.This parameter defaults to false.
- Bi
Connector AdvancedConfig Cluster Bi Connector Config Args - Configuration settings applied to BI Connector for Atlas on this cluster. The MongoDB Connector for Business Intelligence for Atlas (BI Connector) is only available for M10 and larger clusters. The BI Connector is a powerful tool which provides users SQL-based access to their MongoDB databases. As a result, the BI Connector performs operations which may be CPU and memory intensive. Given the limited hardware resources on M10 and M20 cluster tiers, you may experience performance degradation of the cluster when enabling the BI Connector. If this occurs, upgrade to an M30 or larger cluster or disable the BI Connector. See below.
- Cluster
Id string - The cluster ID.
- Cluster
Type string - Type of the cluster that you want to create.
Accepted values include:
REPLICASETReplica setSHARDEDSharded clusterGEOSHARDEDGlobal Cluster
- Connection
Strings []AdvancedCluster Connection String Args - Set of connection strings that your applications use to connect to this cluster. More info in Connection-strings. Use the parameters in this object to connect your applications to this cluster. To learn more about the formats of connection strings, see Connection String Options. NOTE: Atlas returns the contents of this object after the cluster is operational, not while it builds the cluster.
- Create
Date string - Disk
Size float64Gb - Capacity, in gigabytes, of the host's root volume. Increase this number to add capacity, up to a maximum possible value of 4096 (i.e., 4 TB). This value must be a positive number. You can't set this value with clusters with local NVMe SSDs. The minimum disk size for dedicated clusters is 10 GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value. If your cluster includes Azure nodes, this value must correspond to an existing Azure disk type (8, 16, 32, 64, 128, 256, 512, 1024, 2048, or 4095)Atlas calculates storage charges differently depending on whether you choose the default value or a custom value. The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require additional storage space beyond this limitation, consider upgrading your cluster to a higher tier. If your cluster spans cloud service providers, this value defaults to the minimum default of the providers involved.
- Encryption
At stringRest Provider - Possible values are AWS, GCP, AZURE or NONE. Only needed if you desire to manage the keys, see Encryption at Rest using Customer Key Management for complete documentation. You must configure encryption at rest for the Atlas project before enabling it on any cluster in the project. For Documentation, see AWS, GCP and Azure. Requirements are if
replication_specs.#.region_configs.#.<type>Specs.instance_sizeis M10 or greater andbackup_enabledis false or omitted. - Labels
[]Advanced
Cluster Label Args - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below. DEPRECATED Use
tagsinstead. - Mongo
Db stringMajor Version - Version of the cluster to deploy. Atlas supports the following MongoDB versions for M10+ clusters:
4.4,5.0,6.0or7.0. If omitted, Atlas deploys a cluster that runs MongoDB 7.0. Ifreplication_specs#.region_configs#.<type>Specs.instance_size:M0,M2orM5, Atlas deploys MongoDB 4.4. Atlas always deploys the cluster with the latest stable release of the specified version. If you set a value to this parameter and setversion_release_systemCONTINUOUS, the resource returns an error. Either clear this parameter or setversion_release_system:LTS. - Mongo
Db stringVersion - Version of MongoDB the cluster runs, in
major-version.minor-versionformat. - Name string
- Name of the cluster as it appears in Atlas. Once the cluster is created, its name cannot be changed. WARNING Changing the name will result in destruction of the existing cluster and the creation of a new cluster.
- Paused bool
- Pit
Enabled bool - Flag that indicates if the cluster uses Continuous Cloud Backup.
- Project
Id string - Unique ID for the project to create the database user.
- Replication
Specs []AdvancedCluster Replication Spec Args - Configuration for cluster regions and the hardware provisioned in them. See below
- Retain
Backups boolEnabled - Flag that indicates whether to retain backup snapshots for the deleted dedicated cluster
- Root
Cert stringType - Certificate Authority that MongoDB Atlas clusters use. You can specify ISRGROOTX1 (for ISRG Root X1).
- State
Name string - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
-
[]Advanced
Cluster Tag Args - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
- Termination
Protection boolEnabled - Flag that indicates whether termination protection is enabled on the cluster. If set to true, MongoDB Cloud won't delete the cluster. If set to false, MongoDB Cloud will delete the cluster.
- Version
Release stringSystem - Release cadence that Atlas uses for this cluster. This parameter defaults to
LTS. If you set this field toCONTINUOUS, you must omit themongo_db_major_versionfield. Atlas accepts:CONTINUOUS: Atlas creates your cluster using the most recent MongoDB release. Atlas automatically updates your cluster to the latest major and rapid MongoDB releases as they become available.LTS: Atlas creates your cluster using the latest patch release of the MongoDB version that you specify in the mongoDBMajorVersion field. Atlas automatically updates your cluster to subsequent patch releases of this MongoDB version. Atlas doesn't update your cluster to newer rapid or major MongoDB releases as they become available.
- accept
Data StringRisks And Force Replica Set Reconfig - If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set
accept_data_risks_and_force_replica_set_reconfigto the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - advanced
Configuration AdvancedCluster Advanced Configuration - backup
Enabled Boolean Flag that indicates whether the cluster can perform backups. If
true, the cluster can perform backups. You must set this value totruefor NVMe clusters.Backup uses: Cloud Backups for dedicated clusters. Shared Cluster Backups for tenant clusters. If "
backup_enabled" :false, the cluster doesn't use Atlas backups.This parameter defaults to false.
- bi
Connector AdvancedConfig Cluster Bi Connector Config - Configuration settings applied to BI Connector for Atlas on this cluster. The MongoDB Connector for Business Intelligence for Atlas (BI Connector) is only available for M10 and larger clusters. The BI Connector is a powerful tool which provides users SQL-based access to their MongoDB databases. As a result, the BI Connector performs operations which may be CPU and memory intensive. Given the limited hardware resources on M10 and M20 cluster tiers, you may experience performance degradation of the cluster when enabling the BI Connector. If this occurs, upgrade to an M30 or larger cluster or disable the BI Connector. See below.
- cluster
Id String - The cluster ID.
- cluster
Type String - Type of the cluster that you want to create.
Accepted values include:
REPLICASETReplica setSHARDEDSharded clusterGEOSHARDEDGlobal Cluster
- connection
Strings List<AdvancedCluster Connection String> - Set of connection strings that your applications use to connect to this cluster. More info in Connection-strings. Use the parameters in this object to connect your applications to this cluster. To learn more about the formats of connection strings, see Connection String Options. NOTE: Atlas returns the contents of this object after the cluster is operational, not while it builds the cluster.
- create
Date String - disk
Size DoubleGb - Capacity, in gigabytes, of the host's root volume. Increase this number to add capacity, up to a maximum possible value of 4096 (i.e., 4 TB). This value must be a positive number. You can't set this value with clusters with local NVMe SSDs. The minimum disk size for dedicated clusters is 10 GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value. If your cluster includes Azure nodes, this value must correspond to an existing Azure disk type (8, 16, 32, 64, 128, 256, 512, 1024, 2048, or 4095)Atlas calculates storage charges differently depending on whether you choose the default value or a custom value. The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require additional storage space beyond this limitation, consider upgrading your cluster to a higher tier. If your cluster spans cloud service providers, this value defaults to the minimum default of the providers involved.
- encryption
At StringRest Provider - Possible values are AWS, GCP, AZURE or NONE. Only needed if you desire to manage the keys, see Encryption at Rest using Customer Key Management for complete documentation. You must configure encryption at rest for the Atlas project before enabling it on any cluster in the project. For Documentation, see AWS, GCP and Azure. Requirements are if
replication_specs.#.region_configs.#.<type>Specs.instance_sizeis M10 or greater andbackup_enabledis false or omitted. - labels
List<Advanced
Cluster Label> - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below. DEPRECATED Use
tagsinstead. - mongo
Db StringMajor Version - Version of the cluster to deploy. Atlas supports the following MongoDB versions for M10+ clusters:
4.4,5.0,6.0or7.0. If omitted, Atlas deploys a cluster that runs MongoDB 7.0. Ifreplication_specs#.region_configs#.<type>Specs.instance_size:M0,M2orM5, Atlas deploys MongoDB 4.4. Atlas always deploys the cluster with the latest stable release of the specified version. If you set a value to this parameter and setversion_release_systemCONTINUOUS, the resource returns an error. Either clear this parameter or setversion_release_system:LTS. - mongo
Db StringVersion - Version of MongoDB the cluster runs, in
major-version.minor-versionformat. - name String
- Name of the cluster as it appears in Atlas. Once the cluster is created, its name cannot be changed. WARNING Changing the name will result in destruction of the existing cluster and the creation of a new cluster.
- paused Boolean
- pit
Enabled Boolean - Flag that indicates if the cluster uses Continuous Cloud Backup.
- project
Id String - Unique ID for the project to create the database user.
- replication
Specs List<AdvancedCluster Replication Spec> - Configuration for cluster regions and the hardware provisioned in them. See below
- retain
Backups BooleanEnabled - Flag that indicates whether to retain backup snapshots for the deleted dedicated cluster
- root
Cert StringType - Certificate Authority that MongoDB Atlas clusters use. You can specify ISRGROOTX1 (for ISRG Root X1).
- state
Name String - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
-
List<Advanced
Cluster Tag> - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
- termination
Protection BooleanEnabled - Flag that indicates whether termination protection is enabled on the cluster. If set to true, MongoDB Cloud won't delete the cluster. If set to false, MongoDB Cloud will delete the cluster.
- version
Release StringSystem - Release cadence that Atlas uses for this cluster. This parameter defaults to
LTS. If you set this field toCONTINUOUS, you must omit themongo_db_major_versionfield. Atlas accepts:CONTINUOUS: Atlas creates your cluster using the most recent MongoDB release. Atlas automatically updates your cluster to the latest major and rapid MongoDB releases as they become available.LTS: Atlas creates your cluster using the latest patch release of the MongoDB version that you specify in the mongoDBMajorVersion field. Atlas automatically updates your cluster to subsequent patch releases of this MongoDB version. Atlas doesn't update your cluster to newer rapid or major MongoDB releases as they become available.
- accept
Data stringRisks And Force Replica Set Reconfig - If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set
accept_data_risks_and_force_replica_set_reconfigto the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - advanced
Configuration AdvancedCluster Advanced Configuration - backup
Enabled boolean Flag that indicates whether the cluster can perform backups. If
true, the cluster can perform backups. You must set this value totruefor NVMe clusters.Backup uses: Cloud Backups for dedicated clusters. Shared Cluster Backups for tenant clusters. If "
backup_enabled" :false, the cluster doesn't use Atlas backups.This parameter defaults to false.
- bi
Connector AdvancedConfig Cluster Bi Connector Config - Configuration settings applied to BI Connector for Atlas on this cluster. The MongoDB Connector for Business Intelligence for Atlas (BI Connector) is only available for M10 and larger clusters. The BI Connector is a powerful tool which provides users SQL-based access to their MongoDB databases. As a result, the BI Connector performs operations which may be CPU and memory intensive. Given the limited hardware resources on M10 and M20 cluster tiers, you may experience performance degradation of the cluster when enabling the BI Connector. If this occurs, upgrade to an M30 or larger cluster or disable the BI Connector. See below.
- cluster
Id string - The cluster ID.
- cluster
Type string - Type of the cluster that you want to create.
Accepted values include:
REPLICASETReplica setSHARDEDSharded clusterGEOSHARDEDGlobal Cluster
- connection
Strings AdvancedCluster Connection String[] - Set of connection strings that your applications use to connect to this cluster. More info in Connection-strings. Use the parameters in this object to connect your applications to this cluster. To learn more about the formats of connection strings, see Connection String Options. NOTE: Atlas returns the contents of this object after the cluster is operational, not while it builds the cluster.
- create
Date string - disk
Size numberGb - Capacity, in gigabytes, of the host's root volume. Increase this number to add capacity, up to a maximum possible value of 4096 (i.e., 4 TB). This value must be a positive number. You can't set this value with clusters with local NVMe SSDs. The minimum disk size for dedicated clusters is 10 GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value. If your cluster includes Azure nodes, this value must correspond to an existing Azure disk type (8, 16, 32, 64, 128, 256, 512, 1024, 2048, or 4095)Atlas calculates storage charges differently depending on whether you choose the default value or a custom value. The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require additional storage space beyond this limitation, consider upgrading your cluster to a higher tier. If your cluster spans cloud service providers, this value defaults to the minimum default of the providers involved.
- encryption
At stringRest Provider - Possible values are AWS, GCP, AZURE or NONE. Only needed if you desire to manage the keys, see Encryption at Rest using Customer Key Management for complete documentation. You must configure encryption at rest for the Atlas project before enabling it on any cluster in the project. For Documentation, see AWS, GCP and Azure. Requirements are if
replication_specs.#.region_configs.#.<type>Specs.instance_sizeis M10 or greater andbackup_enabledis false or omitted. - labels
Advanced
Cluster Label[] - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below. DEPRECATED Use
tagsinstead. - mongo
Db stringMajor Version - Version of the cluster to deploy. Atlas supports the following MongoDB versions for M10+ clusters:
4.4,5.0,6.0or7.0. If omitted, Atlas deploys a cluster that runs MongoDB 7.0. Ifreplication_specs#.region_configs#.<type>Specs.instance_size:M0,M2orM5, Atlas deploys MongoDB 4.4. Atlas always deploys the cluster with the latest stable release of the specified version. If you set a value to this parameter and setversion_release_systemCONTINUOUS, the resource returns an error. Either clear this parameter or setversion_release_system:LTS. - mongo
Db stringVersion - Version of MongoDB the cluster runs, in
major-version.minor-versionformat. - name string
- Name of the cluster as it appears in Atlas. Once the cluster is created, its name cannot be changed. WARNING Changing the name will result in destruction of the existing cluster and the creation of a new cluster.
- paused boolean
- pit
Enabled boolean - Flag that indicates if the cluster uses Continuous Cloud Backup.
- project
Id string - Unique ID for the project to create the database user.
- replication
Specs AdvancedCluster Replication Spec[] - Configuration for cluster regions and the hardware provisioned in them. See below
- retain
Backups booleanEnabled - Flag that indicates whether to retain backup snapshots for the deleted dedicated cluster
- root
Cert stringType - Certificate Authority that MongoDB Atlas clusters use. You can specify ISRGROOTX1 (for ISRG Root X1).
- state
Name string - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
-
Advanced
Cluster Tag[] - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
- termination
Protection booleanEnabled - Flag that indicates whether termination protection is enabled on the cluster. If set to true, MongoDB Cloud won't delete the cluster. If set to false, MongoDB Cloud will delete the cluster.
- version
Release stringSystem - Release cadence that Atlas uses for this cluster. This parameter defaults to
LTS. If you set this field toCONTINUOUS, you must omit themongo_db_major_versionfield. Atlas accepts:CONTINUOUS: Atlas creates your cluster using the most recent MongoDB release. Atlas automatically updates your cluster to the latest major and rapid MongoDB releases as they become available.LTS: Atlas creates your cluster using the latest patch release of the MongoDB version that you specify in the mongoDBMajorVersion field. Atlas automatically updates your cluster to subsequent patch releases of this MongoDB version. Atlas doesn't update your cluster to newer rapid or major MongoDB releases as they become available.
- accept_
data_ strrisks_ and_ force_ replica_ set_ reconfig - If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set
accept_data_risks_and_force_replica_set_reconfigto the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - advanced_
configuration AdvancedCluster Advanced Configuration Args - backup_
enabled bool Flag that indicates whether the cluster can perform backups. If
true, the cluster can perform backups. You must set this value totruefor NVMe clusters.Backup uses: Cloud Backups for dedicated clusters. Shared Cluster Backups for tenant clusters. If "
backup_enabled" :false, the cluster doesn't use Atlas backups.This parameter defaults to false.
- bi_
connector_ Advancedconfig Cluster Bi Connector Config Args - Configuration settings applied to BI Connector for Atlas on this cluster. The MongoDB Connector for Business Intelligence for Atlas (BI Connector) is only available for M10 and larger clusters. The BI Connector is a powerful tool which provides users SQL-based access to their MongoDB databases. As a result, the BI Connector performs operations which may be CPU and memory intensive. Given the limited hardware resources on M10 and M20 cluster tiers, you may experience performance degradation of the cluster when enabling the BI Connector. If this occurs, upgrade to an M30 or larger cluster or disable the BI Connector. See below.
- cluster_
id str - The cluster ID.
- cluster_
type str - Type of the cluster that you want to create.
Accepted values include:
REPLICASETReplica setSHARDEDSharded clusterGEOSHARDEDGlobal Cluster
- connection_
strings Sequence[AdvancedCluster Connection String Args] - Set of connection strings that your applications use to connect to this cluster. More info in Connection-strings. Use the parameters in this object to connect your applications to this cluster. To learn more about the formats of connection strings, see Connection String Options. NOTE: Atlas returns the contents of this object after the cluster is operational, not while it builds the cluster.
- create_
date str - disk_
size_ floatgb - Capacity, in gigabytes, of the host's root volume. Increase this number to add capacity, up to a maximum possible value of 4096 (i.e., 4 TB). This value must be a positive number. You can't set this value with clusters with local NVMe SSDs. The minimum disk size for dedicated clusters is 10 GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value. If your cluster includes Azure nodes, this value must correspond to an existing Azure disk type (8, 16, 32, 64, 128, 256, 512, 1024, 2048, or 4095)Atlas calculates storage charges differently depending on whether you choose the default value or a custom value. The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require additional storage space beyond this limitation, consider upgrading your cluster to a higher tier. If your cluster spans cloud service providers, this value defaults to the minimum default of the providers involved.
- encryption_
at_ strrest_ provider - Possible values are AWS, GCP, AZURE or NONE. Only needed if you desire to manage the keys, see Encryption at Rest using Customer Key Management for complete documentation. You must configure encryption at rest for the Atlas project before enabling it on any cluster in the project. For Documentation, see AWS, GCP and Azure. Requirements are if
replication_specs.#.region_configs.#.<type>Specs.instance_sizeis M10 or greater andbackup_enabledis false or omitted. - labels
Sequence[Advanced
Cluster Label Args] - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below. DEPRECATED Use
tagsinstead. - mongo_
db_ strmajor_ version - Version of the cluster to deploy. Atlas supports the following MongoDB versions for M10+ clusters:
4.4,5.0,6.0or7.0. If omitted, Atlas deploys a cluster that runs MongoDB 7.0. Ifreplication_specs#.region_configs#.<type>Specs.instance_size:M0,M2orM5, Atlas deploys MongoDB 4.4. Atlas always deploys the cluster with the latest stable release of the specified version. If you set a value to this parameter and setversion_release_systemCONTINUOUS, the resource returns an error. Either clear this parameter or setversion_release_system:LTS. - mongo_
db_ strversion - Version of MongoDB the cluster runs, in
major-version.minor-versionformat. - name str
- Name of the cluster as it appears in Atlas. Once the cluster is created, its name cannot be changed. WARNING Changing the name will result in destruction of the existing cluster and the creation of a new cluster.
- paused bool
- pit_
enabled bool - Flag that indicates if the cluster uses Continuous Cloud Backup.
- project_
id str - Unique ID for the project to create the database user.
- replication_
specs Sequence[AdvancedCluster Replication Spec Args] - Configuration for cluster regions and the hardware provisioned in them. See below
- retain_
backups_ boolenabled - Flag that indicates whether to retain backup snapshots for the deleted dedicated cluster
- root_
cert_ strtype - Certificate Authority that MongoDB Atlas clusters use. You can specify ISRGROOTX1 (for ISRG Root X1).
- state_
name str - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
-
Sequence[Advanced
Cluster Tag Args] - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
- termination_
protection_ boolenabled - Flag that indicates whether termination protection is enabled on the cluster. If set to true, MongoDB Cloud won't delete the cluster. If set to false, MongoDB Cloud will delete the cluster.
- version_
release_ strsystem - Release cadence that Atlas uses for this cluster. This parameter defaults to
LTS. If you set this field toCONTINUOUS, you must omit themongo_db_major_versionfield. Atlas accepts:CONTINUOUS: Atlas creates your cluster using the most recent MongoDB release. Atlas automatically updates your cluster to the latest major and rapid MongoDB releases as they become available.LTS: Atlas creates your cluster using the latest patch release of the MongoDB version that you specify in the mongoDBMajorVersion field. Atlas automatically updates your cluster to subsequent patch releases of this MongoDB version. Atlas doesn't update your cluster to newer rapid or major MongoDB releases as they become available.
- accept
Data StringRisks And Force Replica Set Reconfig - If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set
accept_data_risks_and_force_replica_set_reconfigto the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - advanced
Configuration Property Map - backup
Enabled Boolean Flag that indicates whether the cluster can perform backups. If
true, the cluster can perform backups. You must set this value totruefor NVMe clusters.Backup uses: Cloud Backups for dedicated clusters. Shared Cluster Backups for tenant clusters. If "
backup_enabled" :false, the cluster doesn't use Atlas backups.This parameter defaults to false.
- bi
Connector Property MapConfig - Configuration settings applied to BI Connector for Atlas on this cluster. The MongoDB Connector for Business Intelligence for Atlas (BI Connector) is only available for M10 and larger clusters. The BI Connector is a powerful tool which provides users SQL-based access to their MongoDB databases. As a result, the BI Connector performs operations which may be CPU and memory intensive. Given the limited hardware resources on M10 and M20 cluster tiers, you may experience performance degradation of the cluster when enabling the BI Connector. If this occurs, upgrade to an M30 or larger cluster or disable the BI Connector. See below.
- cluster
Id String - The cluster ID.
- cluster
Type String - Type of the cluster that you want to create.
Accepted values include:
REPLICASETReplica setSHARDEDSharded clusterGEOSHARDEDGlobal Cluster
- connection
Strings List<Property Map> - Set of connection strings that your applications use to connect to this cluster. More info in Connection-strings. Use the parameters in this object to connect your applications to this cluster. To learn more about the formats of connection strings, see Connection String Options. NOTE: Atlas returns the contents of this object after the cluster is operational, not while it builds the cluster.
- create
Date String - disk
Size NumberGb - Capacity, in gigabytes, of the host's root volume. Increase this number to add capacity, up to a maximum possible value of 4096 (i.e., 4 TB). This value must be a positive number. You can't set this value with clusters with local NVMe SSDs. The minimum disk size for dedicated clusters is 10 GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value. If your cluster includes Azure nodes, this value must correspond to an existing Azure disk type (8, 16, 32, 64, 128, 256, 512, 1024, 2048, or 4095)Atlas calculates storage charges differently depending on whether you choose the default value or a custom value. The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require additional storage space beyond this limitation, consider upgrading your cluster to a higher tier. If your cluster spans cloud service providers, this value defaults to the minimum default of the providers involved.
- encryption
At StringRest Provider - Possible values are AWS, GCP, AZURE or NONE. Only needed if you desire to manage the keys, see Encryption at Rest using Customer Key Management for complete documentation. You must configure encryption at rest for the Atlas project before enabling it on any cluster in the project. For Documentation, see AWS, GCP and Azure. Requirements are if
replication_specs.#.region_configs.#.<type>Specs.instance_sizeis M10 or greater andbackup_enabledis false or omitted. - labels List<Property Map>
- Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below. DEPRECATED Use
tagsinstead. - mongo
Db StringMajor Version - Version of the cluster to deploy. Atlas supports the following MongoDB versions for M10+ clusters:
4.4,5.0,6.0or7.0. If omitted, Atlas deploys a cluster that runs MongoDB 7.0. Ifreplication_specs#.region_configs#.<type>Specs.instance_size:M0,M2orM5, Atlas deploys MongoDB 4.4. Atlas always deploys the cluster with the latest stable release of the specified version. If you set a value to this parameter and setversion_release_systemCONTINUOUS, the resource returns an error. Either clear this parameter or setversion_release_system:LTS. - mongo
Db StringVersion - Version of MongoDB the cluster runs, in
major-version.minor-versionformat. - name String
- Name of the cluster as it appears in Atlas. Once the cluster is created, its name cannot be changed. WARNING Changing the name will result in destruction of the existing cluster and the creation of a new cluster.
- paused Boolean
- pit
Enabled Boolean - Flag that indicates if the cluster uses Continuous Cloud Backup.
- project
Id String - Unique ID for the project to create the database user.
- replication
Specs List<Property Map> - Configuration for cluster regions and the hardware provisioned in them. See below
- retain
Backups BooleanEnabled - Flag that indicates whether to retain backup snapshots for the deleted dedicated cluster
- root
Cert StringType - Certificate Authority that MongoDB Atlas clusters use. You can specify ISRGROOTX1 (for ISRG Root X1).
- state
Name String - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
- List<Property Map>
- Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
- termination
Protection BooleanEnabled - Flag that indicates whether termination protection is enabled on the cluster. If set to true, MongoDB Cloud won't delete the cluster. If set to false, MongoDB Cloud will delete the cluster.
- version
Release StringSystem - Release cadence that Atlas uses for this cluster. This parameter defaults to
LTS. If you set this field toCONTINUOUS, you must omit themongo_db_major_versionfield. Atlas accepts:CONTINUOUS: Atlas creates your cluster using the most recent MongoDB release. Atlas automatically updates your cluster to the latest major and rapid MongoDB releases as they become available.LTS: Atlas creates your cluster using the latest patch release of the MongoDB version that you specify in the mongoDBMajorVersion field. Atlas automatically updates your cluster to subsequent patch releases of this MongoDB version. Atlas doesn't update your cluster to newer rapid or major MongoDB releases as they become available.
Supporting Types
AdvancedClusterAdvancedConfiguration, AdvancedClusterAdvancedConfigurationArgs
- default
Read StringConcern - default
Write StringConcern - fail
Index BooleanKey Too Long - javascript
Enabled Boolean - minimum
Enabled StringTls Protocol - no
Table BooleanScan - oplog
Min IntegerRetention Hours - oplog
Size IntegerMb - sample
Refresh IntegerInterval Bi Connector - sample
Size IntegerBi Connector - transaction
Lifetime IntegerLimit Seconds
- default
Read stringConcern - default
Write stringConcern - fail
Index booleanKey Too Long - javascript
Enabled boolean - minimum
Enabled stringTls Protocol - no
Table booleanScan - oplog
Min numberRetention Hours - oplog
Size numberMb - sample
Refresh numberInterval Bi Connector - sample
Size numberBi Connector - transaction
Lifetime numberLimit Seconds
- default_
read_ strconcern - default_
write_ strconcern - fail_
index_ boolkey_ too_ long - javascript_
enabled bool - minimum_
enabled_ strtls_ protocol - no_
table_ boolscan - oplog_
min_ intretention_ hours - oplog_
size_ intmb - sample_
refresh_ intinterval_ bi_ connector - sample_
size_ intbi_ connector - transaction_
lifetime_ intlimit_ seconds
- default
Read StringConcern - default
Write StringConcern - fail
Index BooleanKey Too Long - javascript
Enabled Boolean - minimum
Enabled StringTls Protocol - no
Table BooleanScan - oplog
Min NumberRetention Hours - oplog
Size NumberMb - sample
Refresh NumberInterval Bi Connector - sample
Size NumberBi Connector - transaction
Lifetime NumberLimit Seconds
AdvancedClusterBiConnectorConfig, AdvancedClusterBiConnectorConfigArgs
- Enabled bool
- Specifies whether or not BI Connector for Atlas is enabled on the cluster.l
*
- Set to
trueto enable BI Connector for Atlas. - Set to
falseto disable BI Connector for Atlas.
- Set to
- Read
Preference string Specifies the read preference to be used by BI Connector for Atlas on the cluster. Each BI Connector for Atlas read preference contains a distinct combination of readPreference and readPreferenceTags options. For details on BI Connector for Atlas read preferences, refer to the BI Connector Read Preferences Table.
Set to "primary" to have BI Connector for Atlas read from the primary.
Set to "secondary" to have BI Connector for Atlas read from a secondary member. Default if there are no analytics nodes in the cluster.
Set to "analytics" to have BI Connector for Atlas read from an analytics node. Default if the cluster contains analytics nodes.
- Enabled bool
- Specifies whether or not BI Connector for Atlas is enabled on the cluster.l
*
- Set to
trueto enable BI Connector for Atlas. - Set to
falseto disable BI Connector for Atlas.
- Set to
- Read
Preference string Specifies the read preference to be used by BI Connector for Atlas on the cluster. Each BI Connector for Atlas read preference contains a distinct combination of readPreference and readPreferenceTags options. For details on BI Connector for Atlas read preferences, refer to the BI Connector Read Preferences Table.
Set to "primary" to have BI Connector for Atlas read from the primary.
Set to "secondary" to have BI Connector for Atlas read from a secondary member. Default if there are no analytics nodes in the cluster.
Set to "analytics" to have BI Connector for Atlas read from an analytics node. Default if the cluster contains analytics nodes.
- enabled Boolean
- Specifies whether or not BI Connector for Atlas is enabled on the cluster.l
*
- Set to
trueto enable BI Connector for Atlas. - Set to
falseto disable BI Connector for Atlas.
- Set to
- read
Preference String Specifies the read preference to be used by BI Connector for Atlas on the cluster. Each BI Connector for Atlas read preference contains a distinct combination of readPreference and readPreferenceTags options. For details on BI Connector for Atlas read preferences, refer to the BI Connector Read Preferences Table.
Set to "primary" to have BI Connector for Atlas read from the primary.
Set to "secondary" to have BI Connector for Atlas read from a secondary member. Default if there are no analytics nodes in the cluster.
Set to "analytics" to have BI Connector for Atlas read from an analytics node. Default if the cluster contains analytics nodes.
- enabled boolean
- Specifies whether or not BI Connector for Atlas is enabled on the cluster.l
*
- Set to
trueto enable BI Connector for Atlas. - Set to
falseto disable BI Connector for Atlas.
- Set to
- read
Preference string Specifies the read preference to be used by BI Connector for Atlas on the cluster. Each BI Connector for Atlas read preference contains a distinct combination of readPreference and readPreferenceTags options. For details on BI Connector for Atlas read preferences, refer to the BI Connector Read Preferences Table.
Set to "primary" to have BI Connector for Atlas read from the primary.
Set to "secondary" to have BI Connector for Atlas read from a secondary member. Default if there are no analytics nodes in the cluster.
Set to "analytics" to have BI Connector for Atlas read from an analytics node. Default if the cluster contains analytics nodes.
- enabled bool
- Specifies whether or not BI Connector for Atlas is enabled on the cluster.l
*
- Set to
trueto enable BI Connector for Atlas. - Set to
falseto disable BI Connector for Atlas.
- Set to
- read_
preference str Specifies the read preference to be used by BI Connector for Atlas on the cluster. Each BI Connector for Atlas read preference contains a distinct combination of readPreference and readPreferenceTags options. For details on BI Connector for Atlas read preferences, refer to the BI Connector Read Preferences Table.
Set to "primary" to have BI Connector for Atlas read from the primary.
Set to "secondary" to have BI Connector for Atlas read from a secondary member. Default if there are no analytics nodes in the cluster.
Set to "analytics" to have BI Connector for Atlas read from an analytics node. Default if the cluster contains analytics nodes.
- enabled Boolean
- Specifies whether or not BI Connector for Atlas is enabled on the cluster.l
*
- Set to
trueto enable BI Connector for Atlas. - Set to
falseto disable BI Connector for Atlas.
- Set to
- read
Preference String Specifies the read preference to be used by BI Connector for Atlas on the cluster. Each BI Connector for Atlas read preference contains a distinct combination of readPreference and readPreferenceTags options. For details on BI Connector for Atlas read preferences, refer to the BI Connector Read Preferences Table.
Set to "primary" to have BI Connector for Atlas read from the primary.
Set to "secondary" to have BI Connector for Atlas read from a secondary member. Default if there are no analytics nodes in the cluster.
Set to "analytics" to have BI Connector for Atlas read from an analytics node. Default if the cluster contains analytics nodes.
AdvancedClusterConnectionString, AdvancedClusterConnectionStringArgs
- Private string
- Network-peering-endpoint-aware mongodb://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a network peering connection to this cluster.
- Private
Endpoints List<AdvancedCluster Connection String Private Endpoint> - Private endpoint connection strings. Each object describes the connection strings you can use to connect to this cluster through a private endpoint. Atlas returns this parameter only if you deployed a private endpoint to all regions to which you deployed this cluster's nodes.
connection_strings.private_endpoint.#.connection_string- Private-endpoint-awaremongodb://connection string for this private endpoint.connection_strings.private_endpoint.#.srv_connection_string- Private-endpoint-awaremongodb+srv://connection string for this private endpoint. Themongodb+srvprotocol tells the driver to look up the seed list of hosts in DNS . Atlas synchronizes this list with the nodes in a cluster. If the connection string uses this URI format, you don't need to: Append the seed list or Change the URI if the nodes change. Use this URI format if your driver supports it. If it doesn't, useconnection_strings.private_endpoint[n].connection_stringconnection_strings.private_endpoint.#.srv_shard_optimized_connection_string- Private endpoint-aware connection string optimized for sharded clusters that uses themongodb+srv://protocol to connect to MongoDB Cloud through a private endpoint. If the connection string uses this Uniform Resource Identifier (URI) format, you don't need to change the Uniform Resource Identifier (URI) if the nodes change. Use this Uniform Resource Identifier (URI) format if your application and Atlas cluster supports it. If it doesn't, use and consult the documentation for connectionStrings.privateEndpoint[n].srvConnectionString.connection_strings.private_endpoint.#.type- Type of MongoDB process that you connect to with the connection strings. Atlas returnsMONGODfor replica sets, orMONGOSfor sharded clusters.connection_strings.private_endpoint.#.endpoints- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[n].connection_stringorconnection_strings.private_endpoint[n].srv_connection_stringconnection_strings.private_endpoint.#.endpoints.#.endpoint_id- Unique identifier of the private endpoint.connection_strings.private_endpoint.#.endpoints.#.provider_name- Cloud provider to which you deployed the private endpoint. Atlas returnsAWSorAZURE.connection_strings.private_endpoint.#.endpoints.#.region- Region to which you deployed the private endpoint.
- Private
Srv string - Network-peering-endpoint-aware mongodb+srv://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a network peering connection to this cluster.
- Standard string
- Public mongodb:// connection string for this cluster.
- Standard
Srv string - Public mongodb+srv:// connection string for this cluster. The mongodb+srv protocol tells the driver to look up the seed list of hosts in DNS. Atlas synchronizes this list with the nodes in a cluster. If the connection string uses this URI format, you don’t need to append the seed list or change the URI if the nodes change. Use this URI format if your driver supports it. If it doesn’t , use connectionStrings.standard.
- Private string
- Network-peering-endpoint-aware mongodb://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a network peering connection to this cluster.
- Private
Endpoints []AdvancedCluster Connection String Private Endpoint - Private endpoint connection strings. Each object describes the connection strings you can use to connect to this cluster through a private endpoint. Atlas returns this parameter only if you deployed a private endpoint to all regions to which you deployed this cluster's nodes.
connection_strings.private_endpoint.#.connection_string- Private-endpoint-awaremongodb://connection string for this private endpoint.connection_strings.private_endpoint.#.srv_connection_string- Private-endpoint-awaremongodb+srv://connection string for this private endpoint. Themongodb+srvprotocol tells the driver to look up the seed list of hosts in DNS . Atlas synchronizes this list with the nodes in a cluster. If the connection string uses this URI format, you don't need to: Append the seed list or Change the URI if the nodes change. Use this URI format if your driver supports it. If it doesn't, useconnection_strings.private_endpoint[n].connection_stringconnection_strings.private_endpoint.#.srv_shard_optimized_connection_string- Private endpoint-aware connection string optimized for sharded clusters that uses themongodb+srv://protocol to connect to MongoDB Cloud through a private endpoint. If the connection string uses this Uniform Resource Identifier (URI) format, you don't need to change the Uniform Resource Identifier (URI) if the nodes change. Use this Uniform Resource Identifier (URI) format if your application and Atlas cluster supports it. If it doesn't, use and consult the documentation for connectionStrings.privateEndpoint[n].srvConnectionString.connection_strings.private_endpoint.#.type- Type of MongoDB process that you connect to with the connection strings. Atlas returnsMONGODfor replica sets, orMONGOSfor sharded clusters.connection_strings.private_endpoint.#.endpoints- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[n].connection_stringorconnection_strings.private_endpoint[n].srv_connection_stringconnection_strings.private_endpoint.#.endpoints.#.endpoint_id- Unique identifier of the private endpoint.connection_strings.private_endpoint.#.endpoints.#.provider_name- Cloud provider to which you deployed the private endpoint. Atlas returnsAWSorAZURE.connection_strings.private_endpoint.#.endpoints.#.region- Region to which you deployed the private endpoint.
- Private
Srv string - Network-peering-endpoint-aware mongodb+srv://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a network peering connection to this cluster.
- Standard string
- Public mongodb:// connection string for this cluster.
- Standard
Srv string - Public mongodb+srv:// connection string for this cluster. The mongodb+srv protocol tells the driver to look up the seed list of hosts in DNS. Atlas synchronizes this list with the nodes in a cluster. If the connection string uses this URI format, you don’t need to append the seed list or change the URI if the nodes change. Use this URI format if your driver supports it. If it doesn’t , use connectionStrings.standard.
- private
Endpoints List<AdvancedCluster Connection String Private Endpoint> - Private endpoint connection strings. Each object describes the connection strings you can use to connect to this cluster through a private endpoint. Atlas returns this parameter only if you deployed a private endpoint to all regions to which you deployed this cluster's nodes.
connection_strings.private_endpoint.#.connection_string- Private-endpoint-awaremongodb://connection string for this private endpoint.connection_strings.private_endpoint.#.srv_connection_string- Private-endpoint-awaremongodb+srv://connection string for this private endpoint. Themongodb+srvprotocol tells the driver to look up the seed list of hosts in DNS . Atlas synchronizes this list with the nodes in a cluster. If the connection string uses this URI format, you don't need to: Append the seed list or Change the URI if the nodes change. Use this URI format if your driver supports it. If it doesn't, useconnection_strings.private_endpoint[n].connection_stringconnection_strings.private_endpoint.#.srv_shard_optimized_connection_string- Private endpoint-aware connection string optimized for sharded clusters that uses themongodb+srv://protocol to connect to MongoDB Cloud through a private endpoint. If the connection string uses this Uniform Resource Identifier (URI) format, you don't need to change the Uniform Resource Identifier (URI) if the nodes change. Use this Uniform Resource Identifier (URI) format if your application and Atlas cluster supports it. If it doesn't, use and consult the documentation for connectionStrings.privateEndpoint[n].srvConnectionString.connection_strings.private_endpoint.#.type- Type of MongoDB process that you connect to with the connection strings. Atlas returnsMONGODfor replica sets, orMONGOSfor sharded clusters.connection_strings.private_endpoint.#.endpoints- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[n].connection_stringorconnection_strings.private_endpoint[n].srv_connection_stringconnection_strings.private_endpoint.#.endpoints.#.endpoint_id- Unique identifier of the private endpoint.connection_strings.private_endpoint.#.endpoints.#.provider_name- Cloud provider to which you deployed the private endpoint. Atlas returnsAWSorAZURE.connection_strings.private_endpoint.#.endpoints.#.region- Region to which you deployed the private endpoint.
- private
Srv String - Network-peering-endpoint-aware mongodb+srv://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a network peering connection to this cluster.
- private_ String
- Network-peering-endpoint-aware mongodb://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a network peering connection to this cluster.
- standard String
- Public mongodb:// connection string for this cluster.
- standard
Srv String - Public mongodb+srv:// connection string for this cluster. The mongodb+srv protocol tells the driver to look up the seed list of hosts in DNS. Atlas synchronizes this list with the nodes in a cluster. If the connection string uses this URI format, you don’t need to append the seed list or change the URI if the nodes change. Use this URI format if your driver supports it. If it doesn’t , use connectionStrings.standard.
- private string
- Network-peering-endpoint-aware mongodb://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a network peering connection to this cluster.
- private
Endpoints AdvancedCluster Connection String Private Endpoint[] - Private endpoint connection strings. Each object describes the connection strings you can use to connect to this cluster through a private endpoint. Atlas returns this parameter only if you deployed a private endpoint to all regions to which you deployed this cluster's nodes.
connection_strings.private_endpoint.#.connection_string- Private-endpoint-awaremongodb://connection string for this private endpoint.connection_strings.private_endpoint.#.srv_connection_string- Private-endpoint-awaremongodb+srv://connection string for this private endpoint. Themongodb+srvprotocol tells the driver to look up the seed list of hosts in DNS . Atlas synchronizes this list with the nodes in a cluster. If the connection string uses this URI format, you don't need to: Append the seed list or Change the URI if the nodes change. Use this URI format if your driver supports it. If it doesn't, useconnection_strings.private_endpoint[n].connection_stringconnection_strings.private_endpoint.#.srv_shard_optimized_connection_string- Private endpoint-aware connection string optimized for sharded clusters that uses themongodb+srv://protocol to connect to MongoDB Cloud through a private endpoint. If the connection string uses this Uniform Resource Identifier (URI) format, you don't need to change the Uniform Resource Identifier (URI) if the nodes change. Use this Uniform Resource Identifier (URI) format if your application and Atlas cluster supports it. If it doesn't, use and consult the documentation for connectionStrings.privateEndpoint[n].srvConnectionString.connection_strings.private_endpoint.#.type- Type of MongoDB process that you connect to with the connection strings. Atlas returnsMONGODfor replica sets, orMONGOSfor sharded clusters.connection_strings.private_endpoint.#.endpoints- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[n].connection_stringorconnection_strings.private_endpoint[n].srv_connection_stringconnection_strings.private_endpoint.#.endpoints.#.endpoint_id- Unique identifier of the private endpoint.connection_strings.private_endpoint.#.endpoints.#.provider_name- Cloud provider to which you deployed the private endpoint. Atlas returnsAWSorAZURE.connection_strings.private_endpoint.#.endpoints.#.region- Region to which you deployed the private endpoint.
- private
Srv string - Network-peering-endpoint-aware mongodb+srv://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a network peering connection to this cluster.
- standard string
- Public mongodb:// connection string for this cluster.
- standard
Srv string - Public mongodb+srv:// connection string for this cluster. The mongodb+srv protocol tells the driver to look up the seed list of hosts in DNS. Atlas synchronizes this list with the nodes in a cluster. If the connection string uses this URI format, you don’t need to append the seed list or change the URI if the nodes change. Use this URI format if your driver supports it. If it doesn’t , use connectionStrings.standard.
- private str
- Network-peering-endpoint-aware mongodb://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a network peering connection to this cluster.
- private_
endpoints Sequence[AdvancedCluster Connection String Private Endpoint] - Private endpoint connection strings. Each object describes the connection strings you can use to connect to this cluster through a private endpoint. Atlas returns this parameter only if you deployed a private endpoint to all regions to which you deployed this cluster's nodes.
connection_strings.private_endpoint.#.connection_string- Private-endpoint-awaremongodb://connection string for this private endpoint.connection_strings.private_endpoint.#.srv_connection_string- Private-endpoint-awaremongodb+srv://connection string for this private endpoint. Themongodb+srvprotocol tells the driver to look up the seed list of hosts in DNS . Atlas synchronizes this list with the nodes in a cluster. If the connection string uses this URI format, you don't need to: Append the seed list or Change the URI if the nodes change. Use this URI format if your driver supports it. If it doesn't, useconnection_strings.private_endpoint[n].connection_stringconnection_strings.private_endpoint.#.srv_shard_optimized_connection_string- Private endpoint-aware connection string optimized for sharded clusters that uses themongodb+srv://protocol to connect to MongoDB Cloud through a private endpoint. If the connection string uses this Uniform Resource Identifier (URI) format, you don't need to change the Uniform Resource Identifier (URI) if the nodes change. Use this Uniform Resource Identifier (URI) format if your application and Atlas cluster supports it. If it doesn't, use and consult the documentation for connectionStrings.privateEndpoint[n].srvConnectionString.connection_strings.private_endpoint.#.type- Type of MongoDB process that you connect to with the connection strings. Atlas returnsMONGODfor replica sets, orMONGOSfor sharded clusters.connection_strings.private_endpoint.#.endpoints- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[n].connection_stringorconnection_strings.private_endpoint[n].srv_connection_stringconnection_strings.private_endpoint.#.endpoints.#.endpoint_id- Unique identifier of the private endpoint.connection_strings.private_endpoint.#.endpoints.#.provider_name- Cloud provider to which you deployed the private endpoint. Atlas returnsAWSorAZURE.connection_strings.private_endpoint.#.endpoints.#.region- Region to which you deployed the private endpoint.
- private_
srv str - Network-peering-endpoint-aware mongodb+srv://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a network peering connection to this cluster.
- standard str
- Public mongodb:// connection string for this cluster.
- standard_
srv str - Public mongodb+srv:// connection string for this cluster. The mongodb+srv protocol tells the driver to look up the seed list of hosts in DNS. Atlas synchronizes this list with the nodes in a cluster. If the connection string uses this URI format, you don’t need to append the seed list or change the URI if the nodes change. Use this URI format if your driver supports it. If it doesn’t , use connectionStrings.standard.
- private String
- Network-peering-endpoint-aware mongodb://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a network peering connection to this cluster.
- private
Endpoints List<Property Map> - Private endpoint connection strings. Each object describes the connection strings you can use to connect to this cluster through a private endpoint. Atlas returns this parameter only if you deployed a private endpoint to all regions to which you deployed this cluster's nodes.
connection_strings.private_endpoint.#.connection_string- Private-endpoint-awaremongodb://connection string for this private endpoint.connection_strings.private_endpoint.#.srv_connection_string- Private-endpoint-awaremongodb+srv://connection string for this private endpoint. Themongodb+srvprotocol tells the driver to look up the seed list of hosts in DNS . Atlas synchronizes this list with the nodes in a cluster. If the connection string uses this URI format, you don't need to: Append the seed list or Change the URI if the nodes change. Use this URI format if your driver supports it. If it doesn't, useconnection_strings.private_endpoint[n].connection_stringconnection_strings.private_endpoint.#.srv_shard_optimized_connection_string- Private endpoint-aware connection string optimized for sharded clusters that uses themongodb+srv://protocol to connect to MongoDB Cloud through a private endpoint. If the connection string uses this Uniform Resource Identifier (URI) format, you don't need to change the Uniform Resource Identifier (URI) if the nodes change. Use this Uniform Resource Identifier (URI) format if your application and Atlas cluster supports it. If it doesn't, use and consult the documentation for connectionStrings.privateEndpoint[n].srvConnectionString.connection_strings.private_endpoint.#.type- Type of MongoDB process that you connect to with the connection strings. Atlas returnsMONGODfor replica sets, orMONGOSfor sharded clusters.connection_strings.private_endpoint.#.endpoints- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[n].connection_stringorconnection_strings.private_endpoint[n].srv_connection_stringconnection_strings.private_endpoint.#.endpoints.#.endpoint_id- Unique identifier of the private endpoint.connection_strings.private_endpoint.#.endpoints.#.provider_name- Cloud provider to which you deployed the private endpoint. Atlas returnsAWSorAZURE.connection_strings.private_endpoint.#.endpoints.#.region- Region to which you deployed the private endpoint.
- private
Srv String - Network-peering-endpoint-aware mongodb+srv://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a network peering connection to this cluster.
- standard String
- Public mongodb:// connection string for this cluster.
- standard
Srv String - Public mongodb+srv:// connection string for this cluster. The mongodb+srv protocol tells the driver to look up the seed list of hosts in DNS. Atlas synchronizes this list with the nodes in a cluster. If the connection string uses this URI format, you don’t need to append the seed list or change the URI if the nodes change. Use this URI format if your driver supports it. If it doesn’t , use connectionStrings.standard.
AdvancedClusterConnectionStringPrivateEndpoint, AdvancedClusterConnectionStringPrivateEndpointArgs
- connection
String String - endpoints List<Property Map>
- srv
Connection StringString - srv
Shard StringOptimized Connection String - type String
AdvancedClusterConnectionStringPrivateEndpointEndpoint, AdvancedClusterConnectionStringPrivateEndpointEndpointArgs
- Endpoint
Id string - Provider
Name string - Region string
- Endpoint
Id string - Provider
Name string - Region string
- endpoint
Id String - provider
Name String - region String
- endpoint
Id string - provider
Name string - region string
- endpoint_
id str - provider_
name str - region str
- endpoint
Id String - provider
Name String - region String
AdvancedClusterLabel, AdvancedClusterLabelArgs
AdvancedClusterReplicationSpec, AdvancedClusterReplicationSpecArgs
- Region
Configs List<AdvancedCluster Replication Spec Region Config> - Configuration for the hardware specifications for nodes set for a given regionEach
region_configsobject describes the region's priority in elections and the number and type of MongoDB nodes that Atlas deploys to the region. Eachregion_configsobject must have either ananalytics_specsobject,electable_specsobject, orread_only_specsobject. See below - Container
Id Dictionary<string, string> - Id string
- Num
Shards int - Provide this value if you set a
cluster_typeof SHARDED or GEOSHARDED. Omit this value if you selected acluster_typeof REPLICASET. This API resource accepts 1 through 50, inclusive. This parameter defaults to 1. If you specify anum_shardsvalue of 1 and acluster_typeof SHARDED, Atlas deploys a single-shard sharded cluster. Don't create a sharded cluster with a single shard for production environments. Single-shard sharded clusters don't provide the same benefits as multi-shard configurations. If you are upgrading a replica set to a sharded cluster, you cannot increase the number of shards in the same update request. You should wait until after the cluster has completed upgrading to sharded and you have reconnected all application clients to the MongoDB router before adding additional shards. Otherwise, your data might become inconsistent once MongoDB Cloud begins distributing data across shards. To learn more, see Convert a replica set to a sharded cluster documentation and Convert a replica set to a sharded cluster tutorial. - Zone
Name string - Name for the zone in a Global Cluster.
- Region
Configs []AdvancedCluster Replication Spec Region Config - Configuration for the hardware specifications for nodes set for a given regionEach
region_configsobject describes the region's priority in elections and the number and type of MongoDB nodes that Atlas deploys to the region. Eachregion_configsobject must have either ananalytics_specsobject,electable_specsobject, orread_only_specsobject. See below - Container
Id map[string]string - Id string
- Num
Shards int - Provide this value if you set a
cluster_typeof SHARDED or GEOSHARDED. Omit this value if you selected acluster_typeof REPLICASET. This API resource accepts 1 through 50, inclusive. This parameter defaults to 1. If you specify anum_shardsvalue of 1 and acluster_typeof SHARDED, Atlas deploys a single-shard sharded cluster. Don't create a sharded cluster with a single shard for production environments. Single-shard sharded clusters don't provide the same benefits as multi-shard configurations. If you are upgrading a replica set to a sharded cluster, you cannot increase the number of shards in the same update request. You should wait until after the cluster has completed upgrading to sharded and you have reconnected all application clients to the MongoDB router before adding additional shards. Otherwise, your data might become inconsistent once MongoDB Cloud begins distributing data across shards. To learn more, see Convert a replica set to a sharded cluster documentation and Convert a replica set to a sharded cluster tutorial. - Zone
Name string - Name for the zone in a Global Cluster.
- region
Configs List<AdvancedCluster Replication Spec Region Config> - Configuration for the hardware specifications for nodes set for a given regionEach
region_configsobject describes the region's priority in elections and the number and type of MongoDB nodes that Atlas deploys to the region. Eachregion_configsobject must have either ananalytics_specsobject,electable_specsobject, orread_only_specsobject. See below - container
Id Map<String,String> - id String
- num
Shards Integer - Provide this value if you set a
cluster_typeof SHARDED or GEOSHARDED. Omit this value if you selected acluster_typeof REPLICASET. This API resource accepts 1 through 50, inclusive. This parameter defaults to 1. If you specify anum_shardsvalue of 1 and acluster_typeof SHARDED, Atlas deploys a single-shard sharded cluster. Don't create a sharded cluster with a single shard for production environments. Single-shard sharded clusters don't provide the same benefits as multi-shard configurations. If you are upgrading a replica set to a sharded cluster, you cannot increase the number of shards in the same update request. You should wait until after the cluster has completed upgrading to sharded and you have reconnected all application clients to the MongoDB router before adding additional shards. Otherwise, your data might become inconsistent once MongoDB Cloud begins distributing data across shards. To learn more, see Convert a replica set to a sharded cluster documentation and Convert a replica set to a sharded cluster tutorial. - zone
Name String - Name for the zone in a Global Cluster.
- region
Configs AdvancedCluster Replication Spec Region Config[] - Configuration for the hardware specifications for nodes set for a given regionEach
region_configsobject describes the region's priority in elections and the number and type of MongoDB nodes that Atlas deploys to the region. Eachregion_configsobject must have either ananalytics_specsobject,electable_specsobject, orread_only_specsobject. See below - container
Id {[key: string]: string} - id string
- num
Shards number - Provide this value if you set a
cluster_typeof SHARDED or GEOSHARDED. Omit this value if you selected acluster_typeof REPLICASET. This API resource accepts 1 through 50, inclusive. This parameter defaults to 1. If you specify anum_shardsvalue of 1 and acluster_typeof SHARDED, Atlas deploys a single-shard sharded cluster. Don't create a sharded cluster with a single shard for production environments. Single-shard sharded clusters don't provide the same benefits as multi-shard configurations. If you are upgrading a replica set to a sharded cluster, you cannot increase the number of shards in the same update request. You should wait until after the cluster has completed upgrading to sharded and you have reconnected all application clients to the MongoDB router before adding additional shards. Otherwise, your data might become inconsistent once MongoDB Cloud begins distributing data across shards. To learn more, see Convert a replica set to a sharded cluster documentation and Convert a replica set to a sharded cluster tutorial. - zone
Name string - Name for the zone in a Global Cluster.
- region_
configs Sequence[AdvancedCluster Replication Spec Region Config] - Configuration for the hardware specifications for nodes set for a given regionEach
region_configsobject describes the region's priority in elections and the number and type of MongoDB nodes that Atlas deploys to the region. Eachregion_configsobject must have either ananalytics_specsobject,electable_specsobject, orread_only_specsobject. See below - container_
id Mapping[str, str] - id str
- num_
shards int - Provide this value if you set a
cluster_typeof SHARDED or GEOSHARDED. Omit this value if you selected acluster_typeof REPLICASET. This API resource accepts 1 through 50, inclusive. This parameter defaults to 1. If you specify anum_shardsvalue of 1 and acluster_typeof SHARDED, Atlas deploys a single-shard sharded cluster. Don't create a sharded cluster with a single shard for production environments. Single-shard sharded clusters don't provide the same benefits as multi-shard configurations. If you are upgrading a replica set to a sharded cluster, you cannot increase the number of shards in the same update request. You should wait until after the cluster has completed upgrading to sharded and you have reconnected all application clients to the MongoDB router before adding additional shards. Otherwise, your data might become inconsistent once MongoDB Cloud begins distributing data across shards. To learn more, see Convert a replica set to a sharded cluster documentation and Convert a replica set to a sharded cluster tutorial. - zone_
name str - Name for the zone in a Global Cluster.
- region
Configs List<Property Map> - Configuration for the hardware specifications for nodes set for a given regionEach
region_configsobject describes the region's priority in elections and the number and type of MongoDB nodes that Atlas deploys to the region. Eachregion_configsobject must have either ananalytics_specsobject,electable_specsobject, orread_only_specsobject. See below - container
Id Map<String> - id String
- num
Shards Number - Provide this value if you set a
cluster_typeof SHARDED or GEOSHARDED. Omit this value if you selected acluster_typeof REPLICASET. This API resource accepts 1 through 50, inclusive. This parameter defaults to 1. If you specify anum_shardsvalue of 1 and acluster_typeof SHARDED, Atlas deploys a single-shard sharded cluster. Don't create a sharded cluster with a single shard for production environments. Single-shard sharded clusters don't provide the same benefits as multi-shard configurations. If you are upgrading a replica set to a sharded cluster, you cannot increase the number of shards in the same update request. You should wait until after the cluster has completed upgrading to sharded and you have reconnected all application clients to the MongoDB router before adding additional shards. Otherwise, your data might become inconsistent once MongoDB Cloud begins distributing data across shards. To learn more, see Convert a replica set to a sharded cluster documentation and Convert a replica set to a sharded cluster tutorial. - zone
Name String - Name for the zone in a Global Cluster.
AdvancedClusterReplicationSpecRegionConfig, AdvancedClusterReplicationSpecRegionConfigArgs
- Priority int
- Election priority of the region. For regions with only read-only nodes, set this value to 0.
- If you have multiple
region_configsobjects (your cluster is multi-region or multi-cloud), they must have priorities in descending order. The highest priority is 7. - If your region has set
region_configs.#.electable_specs.0.node_countto 1 or higher, it must have a priority of exactly one (1) less than another region in thereplication_specs.#.region_configs.#array. The highest-priority region must have a priority of 7. The lowest possible priority is 1.
- If you have multiple
- Provider
Name string - Cloud service provider on which the servers are provisioned.
The possible values are:
AWS- Amazon AWSGCP- Google Cloud PlatformAZURE- Microsoft AzureTENANT- M2 or M5 multi-tenant cluster. Usereplication_specs.#.region_configs.#.backing_provider_nameto set the cloud service provider.
- Region
Name string - Physical location of your MongoDB cluster. The region you choose can affect network latency for clients accessing your databases. Requires the Atlas region name, see the reference list for AWS, GCP, Azure.
- Analytics
Auto AdvancedScaling Cluster Replication Spec Region Config Analytics Auto Scaling - Configuration for the Collection of settings that configures analytics-auto-scaling information for the cluster. The values for the
analytics_auto_scalingparameter must be the same for every item in thereplication_specsarray. See below - Analytics
Specs AdvancedCluster Replication Spec Region Config Analytics Specs - Hardware specifications for analytics nodes needed in the region. Analytics nodes handle analytic data such as reporting queries from BI Connector for Atlas. Analytics nodes are read-only and can never become the primary. If you don't specify this parameter, no analytics nodes deploy to this region. See below
- Auto
Scaling AdvancedCluster Replication Spec Region Config Auto Scaling - Configuration for the Collection of settings that configures auto-scaling information for the cluster. The values for the
auto_scalingparameter must be the same for every item in thereplication_specsarray. See below - Backing
Provider stringName - Cloud service provider on which you provision the host for a multi-tenant cluster. Use this only when a
provider_nameisTENANTandinstance_sizeof a specs isM2orM5. - Electable
Specs AdvancedCluster Replication Spec Region Config Electable Specs - Hardware specifications for electable nodes in the region. Electable nodes can become the primary and can enable local reads. If you do not specify this option, no electable nodes are deployed to the region. See below
- Read
Only AdvancedSpecs Cluster Replication Spec Region Config Read Only Specs - Hardware specifications for read-only nodes in the region. Read-only nodes can become the primary and can enable local reads. If you don't specify this parameter, no read-only nodes are deployed to the region. See below
- Priority int
- Election priority of the region. For regions with only read-only nodes, set this value to 0.
- If you have multiple
region_configsobjects (your cluster is multi-region or multi-cloud), they must have priorities in descending order. The highest priority is 7. - If your region has set
region_configs.#.electable_specs.0.node_countto 1 or higher, it must have a priority of exactly one (1) less than another region in thereplication_specs.#.region_configs.#array. The highest-priority region must have a priority of 7. The lowest possible priority is 1.
- If you have multiple
- Provider
Name string - Cloud service provider on which the servers are provisioned.
The possible values are:
AWS- Amazon AWSGCP- Google Cloud PlatformAZURE- Microsoft AzureTENANT- M2 or M5 multi-tenant cluster. Usereplication_specs.#.region_configs.#.backing_provider_nameto set the cloud service provider.
- Region
Name string - Physical location of your MongoDB cluster. The region you choose can affect network latency for clients accessing your databases. Requires the Atlas region name, see the reference list for AWS, GCP, Azure.
- Analytics
Auto AdvancedScaling Cluster Replication Spec Region Config Analytics Auto Scaling - Configuration for the Collection of settings that configures analytics-auto-scaling information for the cluster. The values for the
analytics_auto_scalingparameter must be the same for every item in thereplication_specsarray. See below - Analytics
Specs AdvancedCluster Replication Spec Region Config Analytics Specs - Hardware specifications for analytics nodes needed in the region. Analytics nodes handle analytic data such as reporting queries from BI Connector for Atlas. Analytics nodes are read-only and can never become the primary. If you don't specify this parameter, no analytics nodes deploy to this region. See below
- Auto
Scaling AdvancedCluster Replication Spec Region Config Auto Scaling - Configuration for the Collection of settings that configures auto-scaling information for the cluster. The values for the
auto_scalingparameter must be the same for every item in thereplication_specsarray. See below - Backing
Provider stringName - Cloud service provider on which you provision the host for a multi-tenant cluster. Use this only when a
provider_nameisTENANTandinstance_sizeof a specs isM2orM5. - Electable
Specs AdvancedCluster Replication Spec Region Config Electable Specs - Hardware specifications for electable nodes in the region. Electable nodes can become the primary and can enable local reads. If you do not specify this option, no electable nodes are deployed to the region. See below
- Read
Only AdvancedSpecs Cluster Replication Spec Region Config Read Only Specs - Hardware specifications for read-only nodes in the region. Read-only nodes can become the primary and can enable local reads. If you don't specify this parameter, no read-only nodes are deployed to the region. See below
- priority Integer
- Election priority of the region. For regions with only read-only nodes, set this value to 0.
- If you have multiple
region_configsobjects (your cluster is multi-region or multi-cloud), they must have priorities in descending order. The highest priority is 7. - If your region has set
region_configs.#.electable_specs.0.node_countto 1 or higher, it must have a priority of exactly one (1) less than another region in thereplication_specs.#.region_configs.#array. The highest-priority region must have a priority of 7. The lowest possible priority is 1.
- If you have multiple
- provider
Name String - Cloud service provider on which the servers are provisioned.
The possible values are:
AWS- Amazon AWSGCP- Google Cloud PlatformAZURE- Microsoft AzureTENANT- M2 or M5 multi-tenant cluster. Usereplication_specs.#.region_configs.#.backing_provider_nameto set the cloud service provider.
- region
Name String - Physical location of your MongoDB cluster. The region you choose can affect network latency for clients accessing your databases. Requires the Atlas region name, see the reference list for AWS, GCP, Azure.
- analytics
Auto AdvancedScaling Cluster Replication Spec Region Config Analytics Auto Scaling - Configuration for the Collection of settings that configures analytics-auto-scaling information for the cluster. The values for the
analytics_auto_scalingparameter must be the same for every item in thereplication_specsarray. See below - analytics
Specs AdvancedCluster Replication Spec Region Config Analytics Specs - Hardware specifications for analytics nodes needed in the region. Analytics nodes handle analytic data such as reporting queries from BI Connector for Atlas. Analytics nodes are read-only and can never become the primary. If you don't specify this parameter, no analytics nodes deploy to this region. See below
- auto
Scaling AdvancedCluster Replication Spec Region Config Auto Scaling - Configuration for the Collection of settings that configures auto-scaling information for the cluster. The values for the
auto_scalingparameter must be the same for every item in thereplication_specsarray. See below - backing
Provider StringName - Cloud service provider on which you provision the host for a multi-tenant cluster. Use this only when a
provider_nameisTENANTandinstance_sizeof a specs isM2orM5. - electable
Specs AdvancedCluster Replication Spec Region Config Electable Specs - Hardware specifications for electable nodes in the region. Electable nodes can become the primary and can enable local reads. If you do not specify this option, no electable nodes are deployed to the region. See below
- read
Only AdvancedSpecs Cluster Replication Spec Region Config Read Only Specs - Hardware specifications for read-only nodes in the region. Read-only nodes can become the primary and can enable local reads. If you don't specify this parameter, no read-only nodes are deployed to the region. See below
- priority number
- Election priority of the region. For regions with only read-only nodes, set this value to 0.
- If you have multiple
region_configsobjects (your cluster is multi-region or multi-cloud), they must have priorities in descending order. The highest priority is 7. - If your region has set
region_configs.#.electable_specs.0.node_countto 1 or higher, it must have a priority of exactly one (1) less than another region in thereplication_specs.#.region_configs.#array. The highest-priority region must have a priority of 7. The lowest possible priority is 1.
- If you have multiple
- provider
Name string - Cloud service provider on which the servers are provisioned.
The possible values are:
AWS- Amazon AWSGCP- Google Cloud PlatformAZURE- Microsoft AzureTENANT- M2 or M5 multi-tenant cluster. Usereplication_specs.#.region_configs.#.backing_provider_nameto set the cloud service provider.
- region
Name string - Physical location of your MongoDB cluster. The region you choose can affect network latency for clients accessing your databases. Requires the Atlas region name, see the reference list for AWS, GCP, Azure.
- analytics
Auto AdvancedScaling Cluster Replication Spec Region Config Analytics Auto Scaling - Configuration for the Collection of settings that configures analytics-auto-scaling information for the cluster. The values for the
analytics_auto_scalingparameter must be the same for every item in thereplication_specsarray. See below - analytics
Specs AdvancedCluster Replication Spec Region Config Analytics Specs - Hardware specifications for analytics nodes needed in the region. Analytics nodes handle analytic data such as reporting queries from BI Connector for Atlas. Analytics nodes are read-only and can never become the primary. If you don't specify this parameter, no analytics nodes deploy to this region. See below
- auto
Scaling AdvancedCluster Replication Spec Region Config Auto Scaling - Configuration for the Collection of settings that configures auto-scaling information for the cluster. The values for the
auto_scalingparameter must be the same for every item in thereplication_specsarray. See below - backing
Provider stringName - Cloud service provider on which you provision the host for a multi-tenant cluster. Use this only when a
provider_nameisTENANTandinstance_sizeof a specs isM2orM5. - electable
Specs AdvancedCluster Replication Spec Region Config Electable Specs - Hardware specifications for electable nodes in the region. Electable nodes can become the primary and can enable local reads. If you do not specify this option, no electable nodes are deployed to the region. See below
- read
Only AdvancedSpecs Cluster Replication Spec Region Config Read Only Specs - Hardware specifications for read-only nodes in the region. Read-only nodes can become the primary and can enable local reads. If you don't specify this parameter, no read-only nodes are deployed to the region. See below
- priority int
- Election priority of the region. For regions with only read-only nodes, set this value to 0.
- If you have multiple
region_configsobjects (your cluster is multi-region or multi-cloud), they must have priorities in descending order. The highest priority is 7. - If your region has set
region_configs.#.electable_specs.0.node_countto 1 or higher, it must have a priority of exactly one (1) less than another region in thereplication_specs.#.region_configs.#array. The highest-priority region must have a priority of 7. The lowest possible priority is 1.
- If you have multiple
- provider_
name str - Cloud service provider on which the servers are provisioned.
The possible values are:
AWS- Amazon AWSGCP- Google Cloud PlatformAZURE- Microsoft AzureTENANT- M2 or M5 multi-tenant cluster. Usereplication_specs.#.region_configs.#.backing_provider_nameto set the cloud service provider.
- region_
name str - Physical location of your MongoDB cluster. The region you choose can affect network latency for clients accessing your databases. Requires the Atlas region name, see the reference list for AWS, GCP, Azure.
- analytics_
auto_ Advancedscaling Cluster Replication Spec Region Config Analytics Auto Scaling - Configuration for the Collection of settings that configures analytics-auto-scaling information for the cluster. The values for the
analytics_auto_scalingparameter must be the same for every item in thereplication_specsarray. See below - analytics_
specs AdvancedCluster Replication Spec Region Config Analytics Specs - Hardware specifications for analytics nodes needed in the region. Analytics nodes handle analytic data such as reporting queries from BI Connector for Atlas. Analytics nodes are read-only and can never become the primary. If you don't specify this parameter, no analytics nodes deploy to this region. See below
- auto_
scaling AdvancedCluster Replication Spec Region Config Auto Scaling - Configuration for the Collection of settings that configures auto-scaling information for the cluster. The values for the
auto_scalingparameter must be the same for every item in thereplication_specsarray. See below - backing_
provider_ strname - Cloud service provider on which you provision the host for a multi-tenant cluster. Use this only when a
provider_nameisTENANTandinstance_sizeof a specs isM2orM5. - electable_
specs AdvancedCluster Replication Spec Region Config Electable Specs - Hardware specifications for electable nodes in the region. Electable nodes can become the primary and can enable local reads. If you do not specify this option, no electable nodes are deployed to the region. See below
- read_
only_ Advancedspecs Cluster Replication Spec Region Config Read Only Specs - Hardware specifications for read-only nodes in the region. Read-only nodes can become the primary and can enable local reads. If you don't specify this parameter, no read-only nodes are deployed to the region. See below
- priority Number
- Election priority of the region. For regions with only read-only nodes, set this value to 0.
- If you have multiple
region_configsobjects (your cluster is multi-region or multi-cloud), they must have priorities in descending order. The highest priority is 7. - If your region has set
region_configs.#.electable_specs.0.node_countto 1 or higher, it must have a priority of exactly one (1) less than another region in thereplication_specs.#.region_configs.#array. The highest-priority region must have a priority of 7. The lowest possible priority is 1.
- If you have multiple
- provider
Name String - Cloud service provider on which the servers are provisioned.
The possible values are:
AWS- Amazon AWSGCP- Google Cloud PlatformAZURE- Microsoft AzureTENANT- M2 or M5 multi-tenant cluster. Usereplication_specs.#.region_configs.#.backing_provider_nameto set the cloud service provider.
- region
Name String - Physical location of your MongoDB cluster. The region you choose can affect network latency for clients accessing your databases. Requires the Atlas region name, see the reference list for AWS, GCP, Azure.
- analytics
Auto Property MapScaling - Configuration for the Collection of settings that configures analytics-auto-scaling information for the cluster. The values for the
analytics_auto_scalingparameter must be the same for every item in thereplication_specsarray. See below - analytics
Specs Property Map - Hardware specifications for analytics nodes needed in the region. Analytics nodes handle analytic data such as reporting queries from BI Connector for Atlas. Analytics nodes are read-only and can never become the primary. If you don't specify this parameter, no analytics nodes deploy to this region. See below
- auto
Scaling Property Map - Configuration for the Collection of settings that configures auto-scaling information for the cluster. The values for the
auto_scalingparameter must be the same for every item in thereplication_specsarray. See below - backing
Provider StringName - Cloud service provider on which you provision the host for a multi-tenant cluster. Use this only when a
provider_nameisTENANTandinstance_sizeof a specs isM2orM5. - electable
Specs Property Map - Hardware specifications for electable nodes in the region. Electable nodes can become the primary and can enable local reads. If you do not specify this option, no electable nodes are deployed to the region. See below
- read
Only Property MapSpecs - Hardware specifications for read-only nodes in the region. Read-only nodes can become the primary and can enable local reads. If you don't specify this parameter, no read-only nodes are deployed to the region. See below
AdvancedClusterReplicationSpecRegionConfigAnalyticsAutoScaling, AdvancedClusterReplicationSpecRegionConfigAnalyticsAutoScalingArgs
- Compute
Enabled bool - Compute
Max stringInstance Size - Maximum instance size to which your cluster can automatically scale (such as M40). Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_enabledis true. - Compute
Min stringInstance Size - Minimum instance size to which your cluster can automatically scale (such as M10). Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_scale_down_enabledis true. - Compute
Scale boolDown Enabled - Flag that indicates whether the instance size may scale down. Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_enabled: true. If you enable this option, specify a value forreplication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_min_instance_size. - Disk
Gb boolEnabled - Flag that indicates whether this cluster enables disk auto-scaling. This parameter defaults to true.
- Compute
Enabled bool - Compute
Max stringInstance Size - Maximum instance size to which your cluster can automatically scale (such as M40). Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_enabledis true. - Compute
Min stringInstance Size - Minimum instance size to which your cluster can automatically scale (such as M10). Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_scale_down_enabledis true. - Compute
Scale boolDown Enabled - Flag that indicates whether the instance size may scale down. Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_enabled: true. If you enable this option, specify a value forreplication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_min_instance_size. - Disk
Gb boolEnabled - Flag that indicates whether this cluster enables disk auto-scaling. This parameter defaults to true.
- compute
Enabled Boolean - compute
Max StringInstance Size - Maximum instance size to which your cluster can automatically scale (such as M40). Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_enabledis true. - compute
Min StringInstance Size - Minimum instance size to which your cluster can automatically scale (such as M10). Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_scale_down_enabledis true. - compute
Scale BooleanDown Enabled - Flag that indicates whether the instance size may scale down. Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_enabled: true. If you enable this option, specify a value forreplication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_min_instance_size. - disk
Gb BooleanEnabled - Flag that indicates whether this cluster enables disk auto-scaling. This parameter defaults to true.
- compute
Enabled boolean - compute
Max stringInstance Size - Maximum instance size to which your cluster can automatically scale (such as M40). Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_enabledis true. - compute
Min stringInstance Size - Minimum instance size to which your cluster can automatically scale (such as M10). Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_scale_down_enabledis true. - compute
Scale booleanDown Enabled - Flag that indicates whether the instance size may scale down. Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_enabled: true. If you enable this option, specify a value forreplication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_min_instance_size. - disk
Gb booleanEnabled - Flag that indicates whether this cluster enables disk auto-scaling. This parameter defaults to true.
- compute_
enabled bool - compute_
max_ strinstance_ size - Maximum instance size to which your cluster can automatically scale (such as M40). Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_enabledis true. - compute_
min_ strinstance_ size - Minimum instance size to which your cluster can automatically scale (such as M10). Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_scale_down_enabledis true. - compute_
scale_ booldown_ enabled - Flag that indicates whether the instance size may scale down. Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_enabled: true. If you enable this option, specify a value forreplication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_min_instance_size. - disk_
gb_ boolenabled - Flag that indicates whether this cluster enables disk auto-scaling. This parameter defaults to true.
- compute
Enabled Boolean - compute
Max StringInstance Size - Maximum instance size to which your cluster can automatically scale (such as M40). Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_enabledis true. - compute
Min StringInstance Size - Minimum instance size to which your cluster can automatically scale (such as M10). Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_scale_down_enabledis true. - compute
Scale BooleanDown Enabled - Flag that indicates whether the instance size may scale down. Atlas requires this parameter if
replication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_enabled: true. If you enable this option, specify a value forreplication_specs.#.region_configs.#.analytics_auto_scaling.0.compute_min_instance_size. - disk
Gb BooleanEnabled - Flag that indicates whether this cluster enables disk auto-scaling. This parameter defaults to true.
AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecs, AdvancedClusterReplicationSpecRegionConfigAnalyticsSpecsArgs
- Instance
Size string - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- Disk
Iops int - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- Ebs
Volume stringType - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- Node
Count int - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
- Instance
Size string - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- Disk
Iops int - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- Ebs
Volume stringType - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- Node
Count int - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
- instance
Size String - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- disk
Iops Integer - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- ebs
Volume StringType - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- node
Count Integer - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
- instance
Size string - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- disk
Iops number - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- ebs
Volume stringType - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- node
Count number - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
- instance_
size str - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- disk_
iops int - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- ebs_
volume_ strtype - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- node_
count int - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
- instance
Size String - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- disk
Iops Number - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- ebs
Volume StringType - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- node
Count Number - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
AdvancedClusterReplicationSpecRegionConfigAutoScaling, AdvancedClusterReplicationSpecRegionConfigAutoScalingArgs
- Compute
Enabled bool - Compute
Max stringInstance Size - Maximum instance size to which your cluster can automatically scale (such as M40). Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_enabledis true. - Compute
Min stringInstance Size - Minimum instance size to which your cluster can automatically scale (such as M10). Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_scale_down_enabledis true. - Compute
Scale boolDown Enabled - Flag that indicates whether the instance size may scale down. Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_enabled: true. If you enable this option, specify a value forreplication_specs.#.region_configs.#.auto_scaling.0.compute_min_instance_size. - Disk
Gb boolEnabled
- Compute
Enabled bool - Compute
Max stringInstance Size - Maximum instance size to which your cluster can automatically scale (such as M40). Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_enabledis true. - Compute
Min stringInstance Size - Minimum instance size to which your cluster can automatically scale (such as M10). Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_scale_down_enabledis true. - Compute
Scale boolDown Enabled - Flag that indicates whether the instance size may scale down. Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_enabled: true. If you enable this option, specify a value forreplication_specs.#.region_configs.#.auto_scaling.0.compute_min_instance_size. - Disk
Gb boolEnabled
- compute
Enabled Boolean - compute
Max StringInstance Size - Maximum instance size to which your cluster can automatically scale (such as M40). Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_enabledis true. - compute
Min StringInstance Size - Minimum instance size to which your cluster can automatically scale (such as M10). Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_scale_down_enabledis true. - compute
Scale BooleanDown Enabled - Flag that indicates whether the instance size may scale down. Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_enabled: true. If you enable this option, specify a value forreplication_specs.#.region_configs.#.auto_scaling.0.compute_min_instance_size. - disk
Gb BooleanEnabled
- compute
Enabled boolean - compute
Max stringInstance Size - Maximum instance size to which your cluster can automatically scale (such as M40). Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_enabledis true. - compute
Min stringInstance Size - Minimum instance size to which your cluster can automatically scale (such as M10). Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_scale_down_enabledis true. - compute
Scale booleanDown Enabled - Flag that indicates whether the instance size may scale down. Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_enabled: true. If you enable this option, specify a value forreplication_specs.#.region_configs.#.auto_scaling.0.compute_min_instance_size. - disk
Gb booleanEnabled
- compute_
enabled bool - compute_
max_ strinstance_ size - Maximum instance size to which your cluster can automatically scale (such as M40). Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_enabledis true. - compute_
min_ strinstance_ size - Minimum instance size to which your cluster can automatically scale (such as M10). Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_scale_down_enabledis true. - compute_
scale_ booldown_ enabled - Flag that indicates whether the instance size may scale down. Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_enabled: true. If you enable this option, specify a value forreplication_specs.#.region_configs.#.auto_scaling.0.compute_min_instance_size. - disk_
gb_ boolenabled
- compute
Enabled Boolean - compute
Max StringInstance Size - Maximum instance size to which your cluster can automatically scale (such as M40). Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_enabledis true. - compute
Min StringInstance Size - Minimum instance size to which your cluster can automatically scale (such as M10). Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_scale_down_enabledis true. - compute
Scale BooleanDown Enabled - Flag that indicates whether the instance size may scale down. Atlas requires this parameter if
replication_specs.#.region_configs.#.auto_scaling.0.compute_enabled: true. If you enable this option, specify a value forreplication_specs.#.region_configs.#.auto_scaling.0.compute_min_instance_size. - disk
Gb BooleanEnabled
AdvancedClusterReplicationSpecRegionConfigElectableSpecs, AdvancedClusterReplicationSpecRegionConfigElectableSpecsArgs
- Instance
Size string - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- Disk
Iops int - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- Ebs
Volume stringType - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- Node
Count int - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
- Instance
Size string - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- Disk
Iops int - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- Ebs
Volume stringType - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- Node
Count int - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
- instance
Size String - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- disk
Iops Integer - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- ebs
Volume StringType - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- node
Count Integer - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
- instance
Size string - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- disk
Iops number - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- ebs
Volume stringType - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- node
Count number - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
- instance_
size str - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- disk_
iops int - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- ebs_
volume_ strtype - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- node_
count int - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
- instance
Size String - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- disk
Iops Number - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- ebs
Volume StringType - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- node
Count Number - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
AdvancedClusterReplicationSpecRegionConfigReadOnlySpecs, AdvancedClusterReplicationSpecRegionConfigReadOnlySpecsArgs
- Instance
Size string - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- Disk
Iops int - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- Ebs
Volume stringType - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- Node
Count int - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
- Instance
Size string - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- Disk
Iops int - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- Ebs
Volume stringType - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- Node
Count int - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
- instance
Size String - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- disk
Iops Integer - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- ebs
Volume StringType - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- node
Count Integer - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
- instance
Size string - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- disk
Iops number - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- ebs
Volume stringType - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- node
Count number - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
- instance_
size str - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- disk_
iops int - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- ebs_
volume_ strtype - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- node_
count int - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
- instance
Size String - Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts in your instance size.
- disk
Iops Number - Target throughput (IOPS) desired for AWS storage attached to your cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster.
- ebs
Volume StringType - Type of storage you want to attach to your AWS-provisioned cluster. Set only if you selected AWS as your cloud service provider. You can't set this parameter for a multi-cloud cluster. Valid values are:
STANDARDvolume types can't exceed the default IOPS rate for the selected volume size.PROVISIONEDvolume types must fall within the allowable IOPS range for the selected volume size.
- node
Count Number - Number of nodes of the given type for MongoDB Atlas to deploy to the region.
AdvancedClusterTag, AdvancedClusterTagArgs
- Key string
- Constant that defines the set of the tag.
- Value string
Variable that belongs to the set of the tag.
To learn more, see Resource Tags.
- Key string
- Constant that defines the set of the tag.
- Value string
Variable that belongs to the set of the tag.
To learn more, see Resource Tags.
- key String
- Constant that defines the set of the tag.
- value String
Variable that belongs to the set of the tag.
To learn more, see Resource Tags.
- key string
- Constant that defines the set of the tag.
- value string
Variable that belongs to the set of the tag.
To learn more, see Resource Tags.
- key str
- Constant that defines the set of the tag.
- value str
Variable that belongs to the set of the tag.
To learn more, see Resource Tags.
- key String
- Constant that defines the set of the tag.
- value String
Variable that belongs to the set of the tag.
To learn more, see Resource Tags.
Package Details
- Repository
- MongoDB Atlas pulumi/pulumi-mongodbatlas
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
mongodbatlasTerraform Provider.