mongodbatlas.Cluster
Explore with Pulumi AI
Example Usage
Example AWS cluster
import * as pulumi from "@pulumi/pulumi";
import * as mongodbatlas from "@pulumi/mongodbatlas";
const cluster_test = new mongodbatlas.Cluster("cluster-test", {
projectId: "<YOUR-PROJECT-ID>",
name: "cluster-test",
clusterType: "REPLICASET",
replicationSpecs: [{
numShards: 1,
regionsConfigs: [{
regionName: "US_EAST_1",
electableNodes: 3,
priority: 7,
readOnlyNodes: 0,
}],
}],
cloudBackup: true,
autoScalingDiskGbEnabled: true,
mongoDbMajorVersion: "7.0",
providerName: "AWS",
providerInstanceSizeName: "M40",
});
import pulumi
import pulumi_mongodbatlas as mongodbatlas
cluster_test = mongodbatlas.Cluster("cluster-test",
project_id="<YOUR-PROJECT-ID>",
name="cluster-test",
cluster_type="REPLICASET",
replication_specs=[{
"num_shards": 1,
"regions_configs": [{
"region_name": "US_EAST_1",
"electable_nodes": 3,
"priority": 7,
"read_only_nodes": 0,
}],
}],
cloud_backup=True,
auto_scaling_disk_gb_enabled=True,
mongo_db_major_version="7.0",
provider_name="AWS",
provider_instance_size_name="M40")
package main
import (
"github.com/pulumi/pulumi-mongodbatlas/sdk/v3/go/mongodbatlas"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := mongodbatlas.NewCluster(ctx, "cluster-test", &mongodbatlas.ClusterArgs{
ProjectId: pulumi.String("<YOUR-PROJECT-ID>"),
Name: pulumi.String("cluster-test"),
ClusterType: pulumi.String("REPLICASET"),
ReplicationSpecs: mongodbatlas.ClusterReplicationSpecArray{
&mongodbatlas.ClusterReplicationSpecArgs{
NumShards: pulumi.Int(1),
RegionsConfigs: mongodbatlas.ClusterReplicationSpecRegionsConfigArray{
&mongodbatlas.ClusterReplicationSpecRegionsConfigArgs{
RegionName: pulumi.String("US_EAST_1"),
ElectableNodes: pulumi.Int(3),
Priority: pulumi.Int(7),
ReadOnlyNodes: pulumi.Int(0),
},
},
},
},
CloudBackup: pulumi.Bool(true),
AutoScalingDiskGbEnabled: pulumi.Bool(true),
MongoDbMajorVersion: pulumi.String("7.0"),
ProviderName: pulumi.String("AWS"),
ProviderInstanceSizeName: pulumi.String("M40"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Mongodbatlas = Pulumi.Mongodbatlas;
return await Deployment.RunAsync(() =>
{
var cluster_test = new Mongodbatlas.Cluster("cluster-test", new()
{
ProjectId = "<YOUR-PROJECT-ID>",
Name = "cluster-test",
ClusterType = "REPLICASET",
ReplicationSpecs = new[]
{
new Mongodbatlas.Inputs.ClusterReplicationSpecArgs
{
NumShards = 1,
RegionsConfigs = new[]
{
new Mongodbatlas.Inputs.ClusterReplicationSpecRegionsConfigArgs
{
RegionName = "US_EAST_1",
ElectableNodes = 3,
Priority = 7,
ReadOnlyNodes = 0,
},
},
},
},
CloudBackup = true,
AutoScalingDiskGbEnabled = true,
MongoDbMajorVersion = "7.0",
ProviderName = "AWS",
ProviderInstanceSizeName = "M40",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mongodbatlas.Cluster;
import com.pulumi.mongodbatlas.ClusterArgs;
import com.pulumi.mongodbatlas.inputs.ClusterReplicationSpecArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var cluster_test = new Cluster("cluster-test", ClusterArgs.builder()
.projectId("<YOUR-PROJECT-ID>")
.name("cluster-test")
.clusterType("REPLICASET")
.replicationSpecs(ClusterReplicationSpecArgs.builder()
.numShards(1)
.regionsConfigs(ClusterReplicationSpecRegionsConfigArgs.builder()
.regionName("US_EAST_1")
.electableNodes(3)
.priority(7)
.readOnlyNodes(0)
.build())
.build())
.cloudBackup(true)
.autoScalingDiskGbEnabled(true)
.mongoDbMajorVersion("7.0")
.providerName("AWS")
.providerInstanceSizeName("M40")
.build());
}
}
resources:
cluster-test:
type: mongodbatlas:Cluster
properties:
projectId: <YOUR-PROJECT-ID>
name: cluster-test
clusterType: REPLICASET
replicationSpecs:
- numShards: 1
regionsConfigs:
- regionName: US_EAST_1
electableNodes: 3
priority: 7
readOnlyNodes: 0
cloudBackup: true
autoScalingDiskGbEnabled: true
mongoDbMajorVersion: '7.0'
providerName: AWS
providerInstanceSizeName: M40
Example Azure cluster.
import * as pulumi from "@pulumi/pulumi";
import * as mongodbatlas from "@pulumi/mongodbatlas";
const test = new mongodbatlas.Cluster("test", {
projectId: "<YOUR-PROJECT-ID>",
name: "test",
clusterType: "REPLICASET",
replicationSpecs: [{
numShards: 1,
regionsConfigs: [{
regionName: "US_EAST",
electableNodes: 3,
priority: 7,
readOnlyNodes: 0,
}],
}],
cloudBackup: true,
autoScalingDiskGbEnabled: true,
mongoDbMajorVersion: "7.0",
providerName: "AZURE",
providerDiskTypeName: "P6",
providerInstanceSizeName: "M30",
});
import pulumi
import pulumi_mongodbatlas as mongodbatlas
test = mongodbatlas.Cluster("test",
project_id="<YOUR-PROJECT-ID>",
name="test",
cluster_type="REPLICASET",
replication_specs=[{
"num_shards": 1,
"regions_configs": [{
"region_name": "US_EAST",
"electable_nodes": 3,
"priority": 7,
"read_only_nodes": 0,
}],
}],
cloud_backup=True,
auto_scaling_disk_gb_enabled=True,
mongo_db_major_version="7.0",
provider_name="AZURE",
provider_disk_type_name="P6",
provider_instance_size_name="M30")
package main
import (
"github.com/pulumi/pulumi-mongodbatlas/sdk/v3/go/mongodbatlas"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := mongodbatlas.NewCluster(ctx, "test", &mongodbatlas.ClusterArgs{
ProjectId: pulumi.String("<YOUR-PROJECT-ID>"),
Name: pulumi.String("test"),
ClusterType: pulumi.String("REPLICASET"),
ReplicationSpecs: mongodbatlas.ClusterReplicationSpecArray{
&mongodbatlas.ClusterReplicationSpecArgs{
NumShards: pulumi.Int(1),
RegionsConfigs: mongodbatlas.ClusterReplicationSpecRegionsConfigArray{
&mongodbatlas.ClusterReplicationSpecRegionsConfigArgs{
RegionName: pulumi.String("US_EAST"),
ElectableNodes: pulumi.Int(3),
Priority: pulumi.Int(7),
ReadOnlyNodes: pulumi.Int(0),
},
},
},
},
CloudBackup: pulumi.Bool(true),
AutoScalingDiskGbEnabled: pulumi.Bool(true),
MongoDbMajorVersion: pulumi.String("7.0"),
ProviderName: pulumi.String("AZURE"),
ProviderDiskTypeName: pulumi.String("P6"),
ProviderInstanceSizeName: pulumi.String("M30"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Mongodbatlas = Pulumi.Mongodbatlas;
return await Deployment.RunAsync(() =>
{
var test = new Mongodbatlas.Cluster("test", new()
{
ProjectId = "<YOUR-PROJECT-ID>",
Name = "test",
ClusterType = "REPLICASET",
ReplicationSpecs = new[]
{
new Mongodbatlas.Inputs.ClusterReplicationSpecArgs
{
NumShards = 1,
RegionsConfigs = new[]
{
new Mongodbatlas.Inputs.ClusterReplicationSpecRegionsConfigArgs
{
RegionName = "US_EAST",
ElectableNodes = 3,
Priority = 7,
ReadOnlyNodes = 0,
},
},
},
},
CloudBackup = true,
AutoScalingDiskGbEnabled = true,
MongoDbMajorVersion = "7.0",
ProviderName = "AZURE",
ProviderDiskTypeName = "P6",
ProviderInstanceSizeName = "M30",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mongodbatlas.Cluster;
import com.pulumi.mongodbatlas.ClusterArgs;
import com.pulumi.mongodbatlas.inputs.ClusterReplicationSpecArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var test = new Cluster("test", ClusterArgs.builder()
.projectId("<YOUR-PROJECT-ID>")
.name("test")
.clusterType("REPLICASET")
.replicationSpecs(ClusterReplicationSpecArgs.builder()
.numShards(1)
.regionsConfigs(ClusterReplicationSpecRegionsConfigArgs.builder()
.regionName("US_EAST")
.electableNodes(3)
.priority(7)
.readOnlyNodes(0)
.build())
.build())
.cloudBackup(true)
.autoScalingDiskGbEnabled(true)
.mongoDbMajorVersion("7.0")
.providerName("AZURE")
.providerDiskTypeName("P6")
.providerInstanceSizeName("M30")
.build());
}
}
resources:
test:
type: mongodbatlas:Cluster
properties:
projectId: <YOUR-PROJECT-ID>
name: test
clusterType: REPLICASET
replicationSpecs:
- numShards: 1
regionsConfigs:
- regionName: US_EAST
electableNodes: 3
priority: 7
readOnlyNodes: 0
cloudBackup: true
autoScalingDiskGbEnabled: true
mongoDbMajorVersion: '7.0'
providerName: AZURE
providerDiskTypeName: P6
providerInstanceSizeName: M30
Example GCP cluster
import * as pulumi from "@pulumi/pulumi";
import * as mongodbatlas from "@pulumi/mongodbatlas";
const test = new mongodbatlas.Cluster("test", {
projectId: "<YOUR-PROJECT-ID>",
name: "test",
clusterType: "REPLICASET",
replicationSpecs: [{
numShards: 1,
regionsConfigs: [{
regionName: "EASTERN_US",
electableNodes: 3,
priority: 7,
readOnlyNodes: 0,
}],
}],
cloudBackup: true,
autoScalingDiskGbEnabled: true,
mongoDbMajorVersion: "7.0",
providerName: "GCP",
providerInstanceSizeName: "M30",
});
import pulumi
import pulumi_mongodbatlas as mongodbatlas
test = mongodbatlas.Cluster("test",
project_id="<YOUR-PROJECT-ID>",
name="test",
cluster_type="REPLICASET",
replication_specs=[{
"num_shards": 1,
"regions_configs": [{
"region_name": "EASTERN_US",
"electable_nodes": 3,
"priority": 7,
"read_only_nodes": 0,
}],
}],
cloud_backup=True,
auto_scaling_disk_gb_enabled=True,
mongo_db_major_version="7.0",
provider_name="GCP",
provider_instance_size_name="M30")
package main
import (
"github.com/pulumi/pulumi-mongodbatlas/sdk/v3/go/mongodbatlas"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := mongodbatlas.NewCluster(ctx, "test", &mongodbatlas.ClusterArgs{
ProjectId: pulumi.String("<YOUR-PROJECT-ID>"),
Name: pulumi.String("test"),
ClusterType: pulumi.String("REPLICASET"),
ReplicationSpecs: mongodbatlas.ClusterReplicationSpecArray{
&mongodbatlas.ClusterReplicationSpecArgs{
NumShards: pulumi.Int(1),
RegionsConfigs: mongodbatlas.ClusterReplicationSpecRegionsConfigArray{
&mongodbatlas.ClusterReplicationSpecRegionsConfigArgs{
RegionName: pulumi.String("EASTERN_US"),
ElectableNodes: pulumi.Int(3),
Priority: pulumi.Int(7),
ReadOnlyNodes: pulumi.Int(0),
},
},
},
},
CloudBackup: pulumi.Bool(true),
AutoScalingDiskGbEnabled: pulumi.Bool(true),
MongoDbMajorVersion: pulumi.String("7.0"),
ProviderName: pulumi.String("GCP"),
ProviderInstanceSizeName: pulumi.String("M30"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Mongodbatlas = Pulumi.Mongodbatlas;
return await Deployment.RunAsync(() =>
{
var test = new Mongodbatlas.Cluster("test", new()
{
ProjectId = "<YOUR-PROJECT-ID>",
Name = "test",
ClusterType = "REPLICASET",
ReplicationSpecs = new[]
{
new Mongodbatlas.Inputs.ClusterReplicationSpecArgs
{
NumShards = 1,
RegionsConfigs = new[]
{
new Mongodbatlas.Inputs.ClusterReplicationSpecRegionsConfigArgs
{
RegionName = "EASTERN_US",
ElectableNodes = 3,
Priority = 7,
ReadOnlyNodes = 0,
},
},
},
},
CloudBackup = true,
AutoScalingDiskGbEnabled = true,
MongoDbMajorVersion = "7.0",
ProviderName = "GCP",
ProviderInstanceSizeName = "M30",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mongodbatlas.Cluster;
import com.pulumi.mongodbatlas.ClusterArgs;
import com.pulumi.mongodbatlas.inputs.ClusterReplicationSpecArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var test = new Cluster("test", ClusterArgs.builder()
.projectId("<YOUR-PROJECT-ID>")
.name("test")
.clusterType("REPLICASET")
.replicationSpecs(ClusterReplicationSpecArgs.builder()
.numShards(1)
.regionsConfigs(ClusterReplicationSpecRegionsConfigArgs.builder()
.regionName("EASTERN_US")
.electableNodes(3)
.priority(7)
.readOnlyNodes(0)
.build())
.build())
.cloudBackup(true)
.autoScalingDiskGbEnabled(true)
.mongoDbMajorVersion("7.0")
.providerName("GCP")
.providerInstanceSizeName("M30")
.build());
}
}
resources:
test:
type: mongodbatlas:Cluster
properties:
projectId: <YOUR-PROJECT-ID>
name: test
clusterType: REPLICASET
replicationSpecs:
- numShards: 1
regionsConfigs:
- regionName: EASTERN_US
electableNodes: 3
priority: 7
readOnlyNodes: 0
cloudBackup: true
autoScalingDiskGbEnabled: true
mongoDbMajorVersion: '7.0'
providerName: GCP
providerInstanceSizeName: M30
Example Multi Region cluster
import * as pulumi from "@pulumi/pulumi";
import * as mongodbatlas from "@pulumi/mongodbatlas";
const cluster_test = new mongodbatlas.Cluster("cluster-test", {
projectId: "<YOUR-PROJECT-ID>",
name: "cluster-test-multi-region",
numShards: 1,
cloudBackup: true,
clusterType: "REPLICASET",
providerName: "AWS",
providerInstanceSizeName: "M10",
replicationSpecs: [{
numShards: 1,
regionsConfigs: [
{
regionName: "US_EAST_1",
electableNodes: 3,
priority: 7,
readOnlyNodes: 0,
},
{
regionName: "US_EAST_2",
electableNodes: 2,
priority: 6,
readOnlyNodes: 0,
},
{
regionName: "US_WEST_1",
electableNodes: 2,
priority: 5,
readOnlyNodes: 2,
},
],
}],
});
import pulumi
import pulumi_mongodbatlas as mongodbatlas
cluster_test = mongodbatlas.Cluster("cluster-test",
project_id="<YOUR-PROJECT-ID>",
name="cluster-test-multi-region",
num_shards=1,
cloud_backup=True,
cluster_type="REPLICASET",
provider_name="AWS",
provider_instance_size_name="M10",
replication_specs=[{
"num_shards": 1,
"regions_configs": [
{
"region_name": "US_EAST_1",
"electable_nodes": 3,
"priority": 7,
"read_only_nodes": 0,
},
{
"region_name": "US_EAST_2",
"electable_nodes": 2,
"priority": 6,
"read_only_nodes": 0,
},
{
"region_name": "US_WEST_1",
"electable_nodes": 2,
"priority": 5,
"read_only_nodes": 2,
},
],
}])
package main
import (
"github.com/pulumi/pulumi-mongodbatlas/sdk/v3/go/mongodbatlas"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := mongodbatlas.NewCluster(ctx, "cluster-test", &mongodbatlas.ClusterArgs{
ProjectId: pulumi.String("<YOUR-PROJECT-ID>"),
Name: pulumi.String("cluster-test-multi-region"),
NumShards: pulumi.Int(1),
CloudBackup: pulumi.Bool(true),
ClusterType: pulumi.String("REPLICASET"),
ProviderName: pulumi.String("AWS"),
ProviderInstanceSizeName: pulumi.String("M10"),
ReplicationSpecs: mongodbatlas.ClusterReplicationSpecArray{
&mongodbatlas.ClusterReplicationSpecArgs{
NumShards: pulumi.Int(1),
RegionsConfigs: mongodbatlas.ClusterReplicationSpecRegionsConfigArray{
&mongodbatlas.ClusterReplicationSpecRegionsConfigArgs{
RegionName: pulumi.String("US_EAST_1"),
ElectableNodes: pulumi.Int(3),
Priority: pulumi.Int(7),
ReadOnlyNodes: pulumi.Int(0),
},
&mongodbatlas.ClusterReplicationSpecRegionsConfigArgs{
RegionName: pulumi.String("US_EAST_2"),
ElectableNodes: pulumi.Int(2),
Priority: pulumi.Int(6),
ReadOnlyNodes: pulumi.Int(0),
},
&mongodbatlas.ClusterReplicationSpecRegionsConfigArgs{
RegionName: pulumi.String("US_WEST_1"),
ElectableNodes: pulumi.Int(2),
Priority: pulumi.Int(5),
ReadOnlyNodes: pulumi.Int(2),
},
},
},
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Mongodbatlas = Pulumi.Mongodbatlas;
return await Deployment.RunAsync(() =>
{
var cluster_test = new Mongodbatlas.Cluster("cluster-test", new()
{
ProjectId = "<YOUR-PROJECT-ID>",
Name = "cluster-test-multi-region",
NumShards = 1,
CloudBackup = true,
ClusterType = "REPLICASET",
ProviderName = "AWS",
ProviderInstanceSizeName = "M10",
ReplicationSpecs = new[]
{
new Mongodbatlas.Inputs.ClusterReplicationSpecArgs
{
NumShards = 1,
RegionsConfigs = new[]
{
new Mongodbatlas.Inputs.ClusterReplicationSpecRegionsConfigArgs
{
RegionName = "US_EAST_1",
ElectableNodes = 3,
Priority = 7,
ReadOnlyNodes = 0,
},
new Mongodbatlas.Inputs.ClusterReplicationSpecRegionsConfigArgs
{
RegionName = "US_EAST_2",
ElectableNodes = 2,
Priority = 6,
ReadOnlyNodes = 0,
},
new Mongodbatlas.Inputs.ClusterReplicationSpecRegionsConfigArgs
{
RegionName = "US_WEST_1",
ElectableNodes = 2,
Priority = 5,
ReadOnlyNodes = 2,
},
},
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mongodbatlas.Cluster;
import com.pulumi.mongodbatlas.ClusterArgs;
import com.pulumi.mongodbatlas.inputs.ClusterReplicationSpecArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var cluster_test = new Cluster("cluster-test", ClusterArgs.builder()
.projectId("<YOUR-PROJECT-ID>")
.name("cluster-test-multi-region")
.numShards(1)
.cloudBackup(true)
.clusterType("REPLICASET")
.providerName("AWS")
.providerInstanceSizeName("M10")
.replicationSpecs(ClusterReplicationSpecArgs.builder()
.numShards(1)
.regionsConfigs(
ClusterReplicationSpecRegionsConfigArgs.builder()
.regionName("US_EAST_1")
.electableNodes(3)
.priority(7)
.readOnlyNodes(0)
.build(),
ClusterReplicationSpecRegionsConfigArgs.builder()
.regionName("US_EAST_2")
.electableNodes(2)
.priority(6)
.readOnlyNodes(0)
.build(),
ClusterReplicationSpecRegionsConfigArgs.builder()
.regionName("US_WEST_1")
.electableNodes(2)
.priority(5)
.readOnlyNodes(2)
.build())
.build())
.build());
}
}
resources:
cluster-test:
type: mongodbatlas:Cluster
properties:
projectId: <YOUR-PROJECT-ID>
name: cluster-test-multi-region
numShards: 1
cloudBackup: true
clusterType: REPLICASET
providerName: AWS
providerInstanceSizeName: M10
replicationSpecs:
- numShards: 1
regionsConfigs:
- regionName: US_EAST_1
electableNodes: 3
priority: 7
readOnlyNodes: 0
- regionName: US_EAST_2
electableNodes: 2
priority: 6
readOnlyNodes: 0
- regionName: US_WEST_1
electableNodes: 2
priority: 5
readOnlyNodes: 2
Example Global cluster
import * as pulumi from "@pulumi/pulumi";
import * as mongodbatlas from "@pulumi/mongodbatlas";
const cluster_test = new mongodbatlas.Cluster("cluster-test", {
projectId: "<YOUR-PROJECT-ID>",
name: "cluster-test-global",
numShards: 1,
cloudBackup: true,
clusterType: "GEOSHARDED",
providerName: "AWS",
providerInstanceSizeName: "M30",
replicationSpecs: [
{
zoneName: "Zone 1",
numShards: 2,
regionsConfigs: [{
regionName: "US_EAST_1",
electableNodes: 3,
priority: 7,
readOnlyNodes: 0,
}],
},
{
zoneName: "Zone 2",
numShards: 2,
regionsConfigs: [{
regionName: "EU_CENTRAL_1",
electableNodes: 3,
priority: 7,
readOnlyNodes: 0,
}],
},
],
});
import pulumi
import pulumi_mongodbatlas as mongodbatlas
cluster_test = mongodbatlas.Cluster("cluster-test",
project_id="<YOUR-PROJECT-ID>",
name="cluster-test-global",
num_shards=1,
cloud_backup=True,
cluster_type="GEOSHARDED",
provider_name="AWS",
provider_instance_size_name="M30",
replication_specs=[
{
"zone_name": "Zone 1",
"num_shards": 2,
"regions_configs": [{
"region_name": "US_EAST_1",
"electable_nodes": 3,
"priority": 7,
"read_only_nodes": 0,
}],
},
{
"zone_name": "Zone 2",
"num_shards": 2,
"regions_configs": [{
"region_name": "EU_CENTRAL_1",
"electable_nodes": 3,
"priority": 7,
"read_only_nodes": 0,
}],
},
])
package main
import (
"github.com/pulumi/pulumi-mongodbatlas/sdk/v3/go/mongodbatlas"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := mongodbatlas.NewCluster(ctx, "cluster-test", &mongodbatlas.ClusterArgs{
ProjectId: pulumi.String("<YOUR-PROJECT-ID>"),
Name: pulumi.String("cluster-test-global"),
NumShards: pulumi.Int(1),
CloudBackup: pulumi.Bool(true),
ClusterType: pulumi.String("GEOSHARDED"),
ProviderName: pulumi.String("AWS"),
ProviderInstanceSizeName: pulumi.String("M30"),
ReplicationSpecs: mongodbatlas.ClusterReplicationSpecArray{
&mongodbatlas.ClusterReplicationSpecArgs{
ZoneName: pulumi.String("Zone 1"),
NumShards: pulumi.Int(2),
RegionsConfigs: mongodbatlas.ClusterReplicationSpecRegionsConfigArray{
&mongodbatlas.ClusterReplicationSpecRegionsConfigArgs{
RegionName: pulumi.String("US_EAST_1"),
ElectableNodes: pulumi.Int(3),
Priority: pulumi.Int(7),
ReadOnlyNodes: pulumi.Int(0),
},
},
},
&mongodbatlas.ClusterReplicationSpecArgs{
ZoneName: pulumi.String("Zone 2"),
NumShards: pulumi.Int(2),
RegionsConfigs: mongodbatlas.ClusterReplicationSpecRegionsConfigArray{
&mongodbatlas.ClusterReplicationSpecRegionsConfigArgs{
RegionName: pulumi.String("EU_CENTRAL_1"),
ElectableNodes: pulumi.Int(3),
Priority: pulumi.Int(7),
ReadOnlyNodes: pulumi.Int(0),
},
},
},
},
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Mongodbatlas = Pulumi.Mongodbatlas;
return await Deployment.RunAsync(() =>
{
var cluster_test = new Mongodbatlas.Cluster("cluster-test", new()
{
ProjectId = "<YOUR-PROJECT-ID>",
Name = "cluster-test-global",
NumShards = 1,
CloudBackup = true,
ClusterType = "GEOSHARDED",
ProviderName = "AWS",
ProviderInstanceSizeName = "M30",
ReplicationSpecs = new[]
{
new Mongodbatlas.Inputs.ClusterReplicationSpecArgs
{
ZoneName = "Zone 1",
NumShards = 2,
RegionsConfigs = new[]
{
new Mongodbatlas.Inputs.ClusterReplicationSpecRegionsConfigArgs
{
RegionName = "US_EAST_1",
ElectableNodes = 3,
Priority = 7,
ReadOnlyNodes = 0,
},
},
},
new Mongodbatlas.Inputs.ClusterReplicationSpecArgs
{
ZoneName = "Zone 2",
NumShards = 2,
RegionsConfigs = new[]
{
new Mongodbatlas.Inputs.ClusterReplicationSpecRegionsConfigArgs
{
RegionName = "EU_CENTRAL_1",
ElectableNodes = 3,
Priority = 7,
ReadOnlyNodes = 0,
},
},
},
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mongodbatlas.Cluster;
import com.pulumi.mongodbatlas.ClusterArgs;
import com.pulumi.mongodbatlas.inputs.ClusterReplicationSpecArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var cluster_test = new Cluster("cluster-test", ClusterArgs.builder()
.projectId("<YOUR-PROJECT-ID>")
.name("cluster-test-global")
.numShards(1)
.cloudBackup(true)
.clusterType("GEOSHARDED")
.providerName("AWS")
.providerInstanceSizeName("M30")
.replicationSpecs(
ClusterReplicationSpecArgs.builder()
.zoneName("Zone 1")
.numShards(2)
.regionsConfigs(ClusterReplicationSpecRegionsConfigArgs.builder()
.regionName("US_EAST_1")
.electableNodes(3)
.priority(7)
.readOnlyNodes(0)
.build())
.build(),
ClusterReplicationSpecArgs.builder()
.zoneName("Zone 2")
.numShards(2)
.regionsConfigs(ClusterReplicationSpecRegionsConfigArgs.builder()
.regionName("EU_CENTRAL_1")
.electableNodes(3)
.priority(7)
.readOnlyNodes(0)
.build())
.build())
.build());
}
}
resources:
cluster-test:
type: mongodbatlas:Cluster
properties:
projectId: <YOUR-PROJECT-ID>
name: cluster-test-global
numShards: 1
cloudBackup: true
clusterType: GEOSHARDED
providerName: AWS
providerInstanceSizeName: M30
replicationSpecs:
- zoneName: Zone 1
numShards: 2
regionsConfigs:
- regionName: US_EAST_1
electableNodes: 3
priority: 7
readOnlyNodes: 0
- zoneName: Zone 2
numShards: 2
regionsConfigs:
- regionName: EU_CENTRAL_1
electableNodes: 3
priority: 7
readOnlyNodes: 0
Example AWS Shared Tier (M2/M5) cluster
import * as pulumi from "@pulumi/pulumi";
import * as mongodbatlas from "@pulumi/mongodbatlas";
const cluster_test = new mongodbatlas.Cluster("cluster-test", {
projectId: "<YOUR-PROJECT-ID>",
name: "cluster-test-global",
providerName: "TENANT",
backingProviderName: "AWS",
providerRegionName: "US_EAST_1",
providerInstanceSizeName: "M2",
});
import pulumi
import pulumi_mongodbatlas as mongodbatlas
cluster_test = mongodbatlas.Cluster("cluster-test",
project_id="<YOUR-PROJECT-ID>",
name="cluster-test-global",
provider_name="TENANT",
backing_provider_name="AWS",
provider_region_name="US_EAST_1",
provider_instance_size_name="M2")
package main
import (
"github.com/pulumi/pulumi-mongodbatlas/sdk/v3/go/mongodbatlas"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := mongodbatlas.NewCluster(ctx, "cluster-test", &mongodbatlas.ClusterArgs{
ProjectId: pulumi.String("<YOUR-PROJECT-ID>"),
Name: pulumi.String("cluster-test-global"),
ProviderName: pulumi.String("TENANT"),
BackingProviderName: pulumi.String("AWS"),
ProviderRegionName: pulumi.String("US_EAST_1"),
ProviderInstanceSizeName: pulumi.String("M2"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Mongodbatlas = Pulumi.Mongodbatlas;
return await Deployment.RunAsync(() =>
{
var cluster_test = new Mongodbatlas.Cluster("cluster-test", new()
{
ProjectId = "<YOUR-PROJECT-ID>",
Name = "cluster-test-global",
ProviderName = "TENANT",
BackingProviderName = "AWS",
ProviderRegionName = "US_EAST_1",
ProviderInstanceSizeName = "M2",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mongodbatlas.Cluster;
import com.pulumi.mongodbatlas.ClusterArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var cluster_test = new Cluster("cluster-test", ClusterArgs.builder()
.projectId("<YOUR-PROJECT-ID>")
.name("cluster-test-global")
.providerName("TENANT")
.backingProviderName("AWS")
.providerRegionName("US_EAST_1")
.providerInstanceSizeName("M2")
.build());
}
}
resources:
cluster-test:
type: mongodbatlas:Cluster
properties:
projectId: <YOUR-PROJECT-ID>
name: cluster-test-global
providerName: TENANT
backingProviderName: AWS
providerRegionName: US_EAST_1
providerInstanceSizeName: M2
Example AWS Free Tier cluster
import * as pulumi from "@pulumi/pulumi";
import * as mongodbatlas from "@pulumi/mongodbatlas";
const cluster_test = new mongodbatlas.Cluster("cluster-test", {
projectId: "<YOUR-PROJECT-ID>",
name: "cluster-test-global",
providerName: "TENANT",
backingProviderName: "AWS",
providerRegionName: "US_EAST_1",
providerInstanceSizeName: "M0",
});
import pulumi
import pulumi_mongodbatlas as mongodbatlas
cluster_test = mongodbatlas.Cluster("cluster-test",
project_id="<YOUR-PROJECT-ID>",
name="cluster-test-global",
provider_name="TENANT",
backing_provider_name="AWS",
provider_region_name="US_EAST_1",
provider_instance_size_name="M0")
package main
import (
"github.com/pulumi/pulumi-mongodbatlas/sdk/v3/go/mongodbatlas"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := mongodbatlas.NewCluster(ctx, "cluster-test", &mongodbatlas.ClusterArgs{
ProjectId: pulumi.String("<YOUR-PROJECT-ID>"),
Name: pulumi.String("cluster-test-global"),
ProviderName: pulumi.String("TENANT"),
BackingProviderName: pulumi.String("AWS"),
ProviderRegionName: pulumi.String("US_EAST_1"),
ProviderInstanceSizeName: pulumi.String("M0"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Mongodbatlas = Pulumi.Mongodbatlas;
return await Deployment.RunAsync(() =>
{
var cluster_test = new Mongodbatlas.Cluster("cluster-test", new()
{
ProjectId = "<YOUR-PROJECT-ID>",
Name = "cluster-test-global",
ProviderName = "TENANT",
BackingProviderName = "AWS",
ProviderRegionName = "US_EAST_1",
ProviderInstanceSizeName = "M0",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mongodbatlas.Cluster;
import com.pulumi.mongodbatlas.ClusterArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var cluster_test = new Cluster("cluster-test", ClusterArgs.builder()
.projectId("<YOUR-PROJECT-ID>")
.name("cluster-test-global")
.providerName("TENANT")
.backingProviderName("AWS")
.providerRegionName("US_EAST_1")
.providerInstanceSizeName("M0")
.build());
}
}
resources:
cluster-test:
type: mongodbatlas:Cluster
properties:
projectId: <YOUR-PROJECT-ID>
name: cluster-test-global
providerName: TENANT
backingProviderName: AWS
providerRegionName: US_EAST_1
providerInstanceSizeName: M0
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/cluster:Cluster my_cluster 1112222b3bf99403840e8934-Cluster0
See detailed information for arguments and attributes: MongoDB API Clusters
Create Cluster Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Cluster(name: string, args: ClusterArgs, opts?: CustomResourceOptions);
@overload
def Cluster(resource_name: str,
args: ClusterArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Cluster(resource_name: str,
opts: Optional[ResourceOptions] = None,
project_id: Optional[str] = None,
provider_name: Optional[str] = None,
provider_instance_size_name: Optional[str] = None,
cloud_backup: Optional[bool] = None,
tags: Optional[Sequence[ClusterTagArgs]] = None,
backing_provider_name: Optional[str] = None,
backup_enabled: Optional[bool] = None,
bi_connector_config: Optional[ClusterBiConnectorConfigArgs] = None,
accept_data_risks_and_force_replica_set_reconfig: Optional[str] = None,
provider_auto_scaling_compute_max_instance_size: Optional[str] = None,
disk_size_gb: Optional[float] = None,
encryption_at_rest_provider: Optional[str] = None,
labels: Optional[Sequence[ClusterLabelArgs]] = None,
mongo_db_major_version: Optional[str] = None,
name: Optional[str] = None,
num_shards: Optional[int] = None,
paused: Optional[bool] = None,
version_release_system: Optional[str] = None,
auto_scaling_disk_gb_enabled: Optional[bool] = None,
cluster_type: Optional[str] = None,
provider_auto_scaling_compute_min_instance_size: Optional[str] = None,
provider_disk_iops: Optional[int] = None,
provider_disk_type_name: Optional[str] = None,
provider_encrypt_ebs_volume: Optional[bool] = None,
auto_scaling_compute_enabled: Optional[bool] = None,
advanced_configuration: Optional[ClusterAdvancedConfigurationArgs] = None,
provider_region_name: Optional[str] = None,
provider_volume_type: Optional[str] = None,
redact_client_log_data: Optional[bool] = None,
replication_factor: Optional[int] = None,
replication_specs: Optional[Sequence[ClusterReplicationSpecArgs]] = None,
retain_backups_enabled: Optional[bool] = None,
auto_scaling_compute_scale_down_enabled: Optional[bool] = None,
termination_protection_enabled: Optional[bool] = None,
pit_enabled: Optional[bool] = None)
func NewCluster(ctx *Context, name string, args ClusterArgs, opts ...ResourceOption) (*Cluster, error)
public Cluster(string name, ClusterArgs args, CustomResourceOptions? opts = null)
public Cluster(String name, ClusterArgs args)
public Cluster(String name, ClusterArgs args, CustomResourceOptions options)
type: mongodbatlas:Cluster
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 ClusterArgs
- 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 ClusterArgs
- 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 ClusterArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args ClusterArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args ClusterArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var clusterResource = new Mongodbatlas.Cluster("clusterResource", new()
{
ProjectId = "string",
ProviderName = "string",
ProviderInstanceSizeName = "string",
CloudBackup = false,
Tags = new[]
{
new Mongodbatlas.Inputs.ClusterTagArgs
{
Key = "string",
Value = "string",
},
},
BackingProviderName = "string",
BackupEnabled = false,
BiConnectorConfig = new Mongodbatlas.Inputs.ClusterBiConnectorConfigArgs
{
Enabled = false,
ReadPreference = "string",
},
AcceptDataRisksAndForceReplicaSetReconfig = "string",
ProviderAutoScalingComputeMaxInstanceSize = "string",
DiskSizeGb = 0,
EncryptionAtRestProvider = "string",
Labels = new[]
{
new Mongodbatlas.Inputs.ClusterLabelArgs
{
Key = "string",
Value = "string",
},
},
MongoDbMajorVersion = "string",
Name = "string",
NumShards = 0,
Paused = false,
VersionReleaseSystem = "string",
AutoScalingDiskGbEnabled = false,
ClusterType = "string",
ProviderAutoScalingComputeMinInstanceSize = "string",
ProviderDiskIops = 0,
ProviderDiskTypeName = "string",
AutoScalingComputeEnabled = false,
AdvancedConfiguration = new Mongodbatlas.Inputs.ClusterAdvancedConfigurationArgs
{
ChangeStreamOptionsPreAndPostImagesExpireAfterSeconds = 0,
DefaultWriteConcern = "string",
JavascriptEnabled = false,
MinimumEnabledTlsProtocol = "string",
NoTableScan = false,
OplogMinRetentionHours = 0,
OplogSizeMb = 0,
SampleRefreshIntervalBiConnector = 0,
SampleSizeBiConnector = 0,
TransactionLifetimeLimitSeconds = 0,
},
ProviderRegionName = "string",
ProviderVolumeType = "string",
RedactClientLogData = false,
ReplicationFactor = 0,
ReplicationSpecs = new[]
{
new Mongodbatlas.Inputs.ClusterReplicationSpecArgs
{
NumShards = 0,
Id = "string",
RegionsConfigs = new[]
{
new Mongodbatlas.Inputs.ClusterReplicationSpecRegionsConfigArgs
{
RegionName = "string",
AnalyticsNodes = 0,
ElectableNodes = 0,
Priority = 0,
ReadOnlyNodes = 0,
},
},
ZoneName = "string",
},
},
RetainBackupsEnabled = false,
AutoScalingComputeScaleDownEnabled = false,
TerminationProtectionEnabled = false,
PitEnabled = false,
});
example, err := mongodbatlas.NewCluster(ctx, "clusterResource", &mongodbatlas.ClusterArgs{
ProjectId: pulumi.String("string"),
ProviderName: pulumi.String("string"),
ProviderInstanceSizeName: pulumi.String("string"),
CloudBackup: pulumi.Bool(false),
Tags: mongodbatlas.ClusterTagArray{
&mongodbatlas.ClusterTagArgs{
Key: pulumi.String("string"),
Value: pulumi.String("string"),
},
},
BackingProviderName: pulumi.String("string"),
BackupEnabled: pulumi.Bool(false),
BiConnectorConfig: &mongodbatlas.ClusterBiConnectorConfigArgs{
Enabled: pulumi.Bool(false),
ReadPreference: pulumi.String("string"),
},
AcceptDataRisksAndForceReplicaSetReconfig: pulumi.String("string"),
ProviderAutoScalingComputeMaxInstanceSize: pulumi.String("string"),
DiskSizeGb: pulumi.Float64(0),
EncryptionAtRestProvider: pulumi.String("string"),
Labels: mongodbatlas.ClusterLabelArray{
&mongodbatlas.ClusterLabelArgs{
Key: pulumi.String("string"),
Value: pulumi.String("string"),
},
},
MongoDbMajorVersion: pulumi.String("string"),
Name: pulumi.String("string"),
NumShards: pulumi.Int(0),
Paused: pulumi.Bool(false),
VersionReleaseSystem: pulumi.String("string"),
AutoScalingDiskGbEnabled: pulumi.Bool(false),
ClusterType: pulumi.String("string"),
ProviderAutoScalingComputeMinInstanceSize: pulumi.String("string"),
ProviderDiskIops: pulumi.Int(0),
ProviderDiskTypeName: pulumi.String("string"),
AutoScalingComputeEnabled: pulumi.Bool(false),
AdvancedConfiguration: &mongodbatlas.ClusterAdvancedConfigurationArgs{
ChangeStreamOptionsPreAndPostImagesExpireAfterSeconds: pulumi.Int(0),
DefaultWriteConcern: pulumi.String("string"),
JavascriptEnabled: pulumi.Bool(false),
MinimumEnabledTlsProtocol: pulumi.String("string"),
NoTableScan: pulumi.Bool(false),
OplogMinRetentionHours: pulumi.Float64(0),
OplogSizeMb: pulumi.Int(0),
SampleRefreshIntervalBiConnector: pulumi.Int(0),
SampleSizeBiConnector: pulumi.Int(0),
TransactionLifetimeLimitSeconds: pulumi.Int(0),
},
ProviderRegionName: pulumi.String("string"),
ProviderVolumeType: pulumi.String("string"),
RedactClientLogData: pulumi.Bool(false),
ReplicationFactor: pulumi.Int(0),
ReplicationSpecs: mongodbatlas.ClusterReplicationSpecArray{
&mongodbatlas.ClusterReplicationSpecArgs{
NumShards: pulumi.Int(0),
Id: pulumi.String("string"),
RegionsConfigs: mongodbatlas.ClusterReplicationSpecRegionsConfigArray{
&mongodbatlas.ClusterReplicationSpecRegionsConfigArgs{
RegionName: pulumi.String("string"),
AnalyticsNodes: pulumi.Int(0),
ElectableNodes: pulumi.Int(0),
Priority: pulumi.Int(0),
ReadOnlyNodes: pulumi.Int(0),
},
},
ZoneName: pulumi.String("string"),
},
},
RetainBackupsEnabled: pulumi.Bool(false),
AutoScalingComputeScaleDownEnabled: pulumi.Bool(false),
TerminationProtectionEnabled: pulumi.Bool(false),
PitEnabled: pulumi.Bool(false),
})
var clusterResource = new Cluster("clusterResource", ClusterArgs.builder()
.projectId("string")
.providerName("string")
.providerInstanceSizeName("string")
.cloudBackup(false)
.tags(ClusterTagArgs.builder()
.key("string")
.value("string")
.build())
.backingProviderName("string")
.backupEnabled(false)
.biConnectorConfig(ClusterBiConnectorConfigArgs.builder()
.enabled(false)
.readPreference("string")
.build())
.acceptDataRisksAndForceReplicaSetReconfig("string")
.providerAutoScalingComputeMaxInstanceSize("string")
.diskSizeGb(0)
.encryptionAtRestProvider("string")
.labels(ClusterLabelArgs.builder()
.key("string")
.value("string")
.build())
.mongoDbMajorVersion("string")
.name("string")
.numShards(0)
.paused(false)
.versionReleaseSystem("string")
.autoScalingDiskGbEnabled(false)
.clusterType("string")
.providerAutoScalingComputeMinInstanceSize("string")
.providerDiskIops(0)
.providerDiskTypeName("string")
.autoScalingComputeEnabled(false)
.advancedConfiguration(ClusterAdvancedConfigurationArgs.builder()
.changeStreamOptionsPreAndPostImagesExpireAfterSeconds(0)
.defaultWriteConcern("string")
.javascriptEnabled(false)
.minimumEnabledTlsProtocol("string")
.noTableScan(false)
.oplogMinRetentionHours(0)
.oplogSizeMb(0)
.sampleRefreshIntervalBiConnector(0)
.sampleSizeBiConnector(0)
.transactionLifetimeLimitSeconds(0)
.build())
.providerRegionName("string")
.providerVolumeType("string")
.redactClientLogData(false)
.replicationFactor(0)
.replicationSpecs(ClusterReplicationSpecArgs.builder()
.numShards(0)
.id("string")
.regionsConfigs(ClusterReplicationSpecRegionsConfigArgs.builder()
.regionName("string")
.analyticsNodes(0)
.electableNodes(0)
.priority(0)
.readOnlyNodes(0)
.build())
.zoneName("string")
.build())
.retainBackupsEnabled(false)
.autoScalingComputeScaleDownEnabled(false)
.terminationProtectionEnabled(false)
.pitEnabled(false)
.build());
cluster_resource = mongodbatlas.Cluster("clusterResource",
project_id="string",
provider_name="string",
provider_instance_size_name="string",
cloud_backup=False,
tags=[{
"key": "string",
"value": "string",
}],
backing_provider_name="string",
backup_enabled=False,
bi_connector_config={
"enabled": False,
"read_preference": "string",
},
accept_data_risks_and_force_replica_set_reconfig="string",
provider_auto_scaling_compute_max_instance_size="string",
disk_size_gb=0,
encryption_at_rest_provider="string",
labels=[{
"key": "string",
"value": "string",
}],
mongo_db_major_version="string",
name="string",
num_shards=0,
paused=False,
version_release_system="string",
auto_scaling_disk_gb_enabled=False,
cluster_type="string",
provider_auto_scaling_compute_min_instance_size="string",
provider_disk_iops=0,
provider_disk_type_name="string",
auto_scaling_compute_enabled=False,
advanced_configuration={
"change_stream_options_pre_and_post_images_expire_after_seconds": 0,
"default_write_concern": "string",
"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,
},
provider_region_name="string",
provider_volume_type="string",
redact_client_log_data=False,
replication_factor=0,
replication_specs=[{
"num_shards": 0,
"id": "string",
"regions_configs": [{
"region_name": "string",
"analytics_nodes": 0,
"electable_nodes": 0,
"priority": 0,
"read_only_nodes": 0,
}],
"zone_name": "string",
}],
retain_backups_enabled=False,
auto_scaling_compute_scale_down_enabled=False,
termination_protection_enabled=False,
pit_enabled=False)
const clusterResource = new mongodbatlas.Cluster("clusterResource", {
projectId: "string",
providerName: "string",
providerInstanceSizeName: "string",
cloudBackup: false,
tags: [{
key: "string",
value: "string",
}],
backingProviderName: "string",
backupEnabled: false,
biConnectorConfig: {
enabled: false,
readPreference: "string",
},
acceptDataRisksAndForceReplicaSetReconfig: "string",
providerAutoScalingComputeMaxInstanceSize: "string",
diskSizeGb: 0,
encryptionAtRestProvider: "string",
labels: [{
key: "string",
value: "string",
}],
mongoDbMajorVersion: "string",
name: "string",
numShards: 0,
paused: false,
versionReleaseSystem: "string",
autoScalingDiskGbEnabled: false,
clusterType: "string",
providerAutoScalingComputeMinInstanceSize: "string",
providerDiskIops: 0,
providerDiskTypeName: "string",
autoScalingComputeEnabled: false,
advancedConfiguration: {
changeStreamOptionsPreAndPostImagesExpireAfterSeconds: 0,
defaultWriteConcern: "string",
javascriptEnabled: false,
minimumEnabledTlsProtocol: "string",
noTableScan: false,
oplogMinRetentionHours: 0,
oplogSizeMb: 0,
sampleRefreshIntervalBiConnector: 0,
sampleSizeBiConnector: 0,
transactionLifetimeLimitSeconds: 0,
},
providerRegionName: "string",
providerVolumeType: "string",
redactClientLogData: false,
replicationFactor: 0,
replicationSpecs: [{
numShards: 0,
id: "string",
regionsConfigs: [{
regionName: "string",
analyticsNodes: 0,
electableNodes: 0,
priority: 0,
readOnlyNodes: 0,
}],
zoneName: "string",
}],
retainBackupsEnabled: false,
autoScalingComputeScaleDownEnabled: false,
terminationProtectionEnabled: false,
pitEnabled: false,
});
type: mongodbatlas:Cluster
properties:
acceptDataRisksAndForceReplicaSetReconfig: string
advancedConfiguration:
changeStreamOptionsPreAndPostImagesExpireAfterSeconds: 0
defaultWriteConcern: string
javascriptEnabled: false
minimumEnabledTlsProtocol: string
noTableScan: false
oplogMinRetentionHours: 0
oplogSizeMb: 0
sampleRefreshIntervalBiConnector: 0
sampleSizeBiConnector: 0
transactionLifetimeLimitSeconds: 0
autoScalingComputeEnabled: false
autoScalingComputeScaleDownEnabled: false
autoScalingDiskGbEnabled: false
backingProviderName: string
backupEnabled: false
biConnectorConfig:
enabled: false
readPreference: string
cloudBackup: false
clusterType: string
diskSizeGb: 0
encryptionAtRestProvider: string
labels:
- key: string
value: string
mongoDbMajorVersion: string
name: string
numShards: 0
paused: false
pitEnabled: false
projectId: string
providerAutoScalingComputeMaxInstanceSize: string
providerAutoScalingComputeMinInstanceSize: string
providerDiskIops: 0
providerDiskTypeName: string
providerInstanceSizeName: string
providerName: string
providerRegionName: string
providerVolumeType: string
redactClientLogData: false
replicationFactor: 0
replicationSpecs:
- id: string
numShards: 0
regionsConfigs:
- analyticsNodes: 0
electableNodes: 0
priority: 0
readOnlyNodes: 0
regionName: string
zoneName: string
retainBackupsEnabled: false
tags:
- key: string
value: string
terminationProtectionEnabled: false
versionReleaseSystem: string
Cluster Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Cluster resource accepts the following input properties:
- Project
Id string - The unique ID for the project to create the database user.
- Provider
Instance stringSize Name - Atlas provides different instance sizes, each with a default storage capacity and RAM size. The instance size you select is used for all the data-bearing servers in your cluster. See Create a Cluster
providerSettings.instanceSizeName
for valid values and default resources. - Provider
Name string Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- 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_reconfig
to the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - Advanced
Configuration ClusterAdvanced Configuration - Auto
Scaling boolCompute Enabled - Auto
Scaling boolCompute Scale Down Enabled - Set to
true
to enable the cluster tier to scale down. This option is only available ifautoScaling.compute.enabled
istrue
.- If this option is enabled, you must specify a value for
providerSettings.autoScaling.compute.minInstanceSize
- If this option is enabled, you must specify a value for
- Auto
Scaling boolDisk Gb Enabled - Backing
Provider stringName Cloud service provider on which the server for a multi-tenant cluster is provisioned.
This setting is only valid when providerSetting.providerName is TENANT and providerSetting.instanceSizeName is M2 or M5.
The possible values are:
- AWS - Amazon AWS
- GCP - Google Cloud Platform
- AZURE - Microsoft Azure
- Backup
Enabled bool - Legacy Backup - Set to true to enable Atlas legacy backups for the cluster.
Important - MongoDB deprecated the Legacy Backup feature. Clusters that use Legacy Backup can continue to use it. MongoDB recommends using Cloud Backups.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
cloud_backup
, to enable Cloud Backup. If you create a new Atlas cluster and setbackup_enabled
to true, the Provider will respond with an error. This change doesn’t affect existing clusters that use legacy backups. - Setting this value to false to disable legacy backups for the cluster will let Atlas delete any stored snapshots. In order to preserve the legacy backups snapshots, disable the legacy backups and enable the cloud backups in the single pulumi up action.
backup_enabled = "false" cloud_backup = "true"
- The default value is false. M10 and above only.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
- Bi
Connector ClusterConfig Bi Connector Config - Specifies BI Connector for Atlas configuration on this cluster. BI Connector for Atlas is only available for M10+ clusters. See BI Connector below for more details.
- Cloud
Backup bool - Cluster
Type string Specifies the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
WHEN SHOULD YOU USE CLUSTERTYPE? When you set replication_specs, when you are deploying Global Clusters or when you are deploying non-Global replica sets and sharded clusters.
Accepted values include:
REPLICASET
Replica setSHARDED
Sharded clusterGEOSHARDED
Global Cluster
- 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 integer.
- The minimum disk size for dedicated clusters is 10GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value.
- Note: 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.
- Cannot be used with clusters with local NVMe SSDs
- Cannot be used with Azure clusters
- 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 complete documentation on configuring Encryption at Rest, see Encryption at Rest using Customer Key Management. Requires M10 or greater. and for legacy backups, backup_enabled, to be false or omitted. Note: Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default.
- Labels
List<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
tags
instead. - Mongo
Db stringMajor Version - Version of the cluster to deploy. Atlas supports all the MongoDB versions that have not reached End of Live for M10+ clusters. If omitted, Atlas deploys the cluster with the default version. For more details, see documentation. Atlas always deploys the cluster with the latest stable release of the specified version. See Release Notes for latest Current Stable Release.
- 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.
- Num
Shards int - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- Paused bool
- Pit
Enabled bool - Flag that indicates if the cluster uses Continuous Cloud Backup. If set to true, cloud_backup must also be set to true.
- Provider
Auto stringScaling Compute Max Instance Size - Maximum instance size to which your cluster can automatically scale (e.g., M40). Required if
autoScaling.compute.enabled
istrue
. - Provider
Auto stringScaling Compute Min Instance Size - Minimum instance size to which your cluster can automatically scale (e.g., M10). Required if
autoScaling.compute.scaleDownEnabled
istrue
. - Provider
Disk intIops - The maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected
provider_instance_size_name
anddisk_size_gb
. This setting requires thatprovider_instance_size_name
to be M30 or greater and cannot be used with clusters with local NVMe SSDs. The default value forprovider_disk_iops
is the same as the cluster tier's Standard IOPS value, as viewable in the Atlas console. It is used in cases where a higher number of IOPS is needed and possible. If a value is submitted that is lower or equal to the default IOPS value for the cluster tier Atlas ignores the requested value and uses the default. More details available under the providerSettings.diskIOPS parameter: MongoDB API Clusters- You do not need to configure IOPS for a STANDARD disk configuration but only for a PROVISIONED configuration.
- Provider
Disk stringType Name - Azure disk type of the server’s root volume. If omitted, Atlas uses the default disk type for the selected providerSettings.instanceSizeName. Example disk types and associated storage sizes: P4 - 32GB, P6 - 64GB, P10 - 128GB, P15 - 256GB, P20 - 512GB, P30 - 1024GB, P40 - 2048GB, P50 - 4095GB. More information and the most update to date disk types/storage sizes can be located at https://docs.atlas.mongodb.com/reference/api/clusters-create-one/.
- Provider
Encrypt boolEbs Volume - (Deprecated) The Flag is always true. Flag that indicates whether the Amazon EBS encryption feature encrypts the host's root volume for both data at rest within the volume and for data moving between the volume and the cluster. Note: This setting is always enabled for clusters with local NVMe SSDs. Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default..
- Provider
Region stringName - 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. Do not specify this field when creating a multi-region cluster using the replicationSpec document or a Global Cluster with the replicationSpecs array.
- Provider
Volume stringType The type of the volume. The possible values are:
STANDARD
andPROVISIONED
.PROVISIONED
is ONLY required if setting IOPS higher than the default instance IOPS.NOTE:
STANDARD
is not available for NVME clusters.- Redact
Client boolLog Data - Flag that enables or disables log redaction, see the manual for more info. Use this in conjunction with Encryption at Rest and TLS/SSL (Transport Encryption) to assist compliance with regulatory requirements. Note: Changing this setting on a cluster will trigger a rolling restart as soon as the cluster is updated. The log redaction field is updated via an Atlas API call after cluster creation. Consequently, there may be a brief period during resource creation when log redaction is not yet enabled. To ensure complete log redaction from the outset, use
mongodbatlas.AdvancedCluster
. - Replication
Factor int - Number of replica set members. Each member keeps a copy of your databases, providing high availability and data redundancy. The possible values are 3, 5, or 7. The default value is 3.
- Replication
Specs List<ClusterReplication Spec> - Configuration for cluster regions. See Replication Spec below for more details.
- Retain
Backups boolEnabled - Set to true to retain backup snapshots for the deleted cluster. M10 and above only.
- List<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_version
field. 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.
- Project
Id string - The unique ID for the project to create the database user.
- Provider
Instance stringSize Name - Atlas provides different instance sizes, each with a default storage capacity and RAM size. The instance size you select is used for all the data-bearing servers in your cluster. See Create a Cluster
providerSettings.instanceSizeName
for valid values and default resources. - Provider
Name string Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- 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_reconfig
to the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - Advanced
Configuration ClusterAdvanced Configuration Args - Auto
Scaling boolCompute Enabled - Auto
Scaling boolCompute Scale Down Enabled - Set to
true
to enable the cluster tier to scale down. This option is only available ifautoScaling.compute.enabled
istrue
.- If this option is enabled, you must specify a value for
providerSettings.autoScaling.compute.minInstanceSize
- If this option is enabled, you must specify a value for
- Auto
Scaling boolDisk Gb Enabled - Backing
Provider stringName Cloud service provider on which the server for a multi-tenant cluster is provisioned.
This setting is only valid when providerSetting.providerName is TENANT and providerSetting.instanceSizeName is M2 or M5.
The possible values are:
- AWS - Amazon AWS
- GCP - Google Cloud Platform
- AZURE - Microsoft Azure
- Backup
Enabled bool - Legacy Backup - Set to true to enable Atlas legacy backups for the cluster.
Important - MongoDB deprecated the Legacy Backup feature. Clusters that use Legacy Backup can continue to use it. MongoDB recommends using Cloud Backups.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
cloud_backup
, to enable Cloud Backup. If you create a new Atlas cluster and setbackup_enabled
to true, the Provider will respond with an error. This change doesn’t affect existing clusters that use legacy backups. - Setting this value to false to disable legacy backups for the cluster will let Atlas delete any stored snapshots. In order to preserve the legacy backups snapshots, disable the legacy backups and enable the cloud backups in the single pulumi up action.
backup_enabled = "false" cloud_backup = "true"
- The default value is false. M10 and above only.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
- Bi
Connector ClusterConfig Bi Connector Config Args - Specifies BI Connector for Atlas configuration on this cluster. BI Connector for Atlas is only available for M10+ clusters. See BI Connector below for more details.
- Cloud
Backup bool - Cluster
Type string Specifies the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
WHEN SHOULD YOU USE CLUSTERTYPE? When you set replication_specs, when you are deploying Global Clusters or when you are deploying non-Global replica sets and sharded clusters.
Accepted values include:
REPLICASET
Replica setSHARDED
Sharded clusterGEOSHARDED
Global Cluster
- 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 integer.
- The minimum disk size for dedicated clusters is 10GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value.
- Note: 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.
- Cannot be used with clusters with local NVMe SSDs
- Cannot be used with Azure clusters
- 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 complete documentation on configuring Encryption at Rest, see Encryption at Rest using Customer Key Management. Requires M10 or greater. and for legacy backups, backup_enabled, to be false or omitted. Note: Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default.
- Labels
[]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
tags
instead. - Mongo
Db stringMajor Version - Version of the cluster to deploy. Atlas supports all the MongoDB versions that have not reached End of Live for M10+ clusters. If omitted, Atlas deploys the cluster with the default version. For more details, see documentation. Atlas always deploys the cluster with the latest stable release of the specified version. See Release Notes for latest Current Stable Release.
- 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.
- Num
Shards int - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- Paused bool
- Pit
Enabled bool - Flag that indicates if the cluster uses Continuous Cloud Backup. If set to true, cloud_backup must also be set to true.
- Provider
Auto stringScaling Compute Max Instance Size - Maximum instance size to which your cluster can automatically scale (e.g., M40). Required if
autoScaling.compute.enabled
istrue
. - Provider
Auto stringScaling Compute Min Instance Size - Minimum instance size to which your cluster can automatically scale (e.g., M10). Required if
autoScaling.compute.scaleDownEnabled
istrue
. - Provider
Disk intIops - The maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected
provider_instance_size_name
anddisk_size_gb
. This setting requires thatprovider_instance_size_name
to be M30 or greater and cannot be used with clusters with local NVMe SSDs. The default value forprovider_disk_iops
is the same as the cluster tier's Standard IOPS value, as viewable in the Atlas console. It is used in cases where a higher number of IOPS is needed and possible. If a value is submitted that is lower or equal to the default IOPS value for the cluster tier Atlas ignores the requested value and uses the default. More details available under the providerSettings.diskIOPS parameter: MongoDB API Clusters- You do not need to configure IOPS for a STANDARD disk configuration but only for a PROVISIONED configuration.
- Provider
Disk stringType Name - Azure disk type of the server’s root volume. If omitted, Atlas uses the default disk type for the selected providerSettings.instanceSizeName. Example disk types and associated storage sizes: P4 - 32GB, P6 - 64GB, P10 - 128GB, P15 - 256GB, P20 - 512GB, P30 - 1024GB, P40 - 2048GB, P50 - 4095GB. More information and the most update to date disk types/storage sizes can be located at https://docs.atlas.mongodb.com/reference/api/clusters-create-one/.
- Provider
Encrypt boolEbs Volume - (Deprecated) The Flag is always true. Flag that indicates whether the Amazon EBS encryption feature encrypts the host's root volume for both data at rest within the volume and for data moving between the volume and the cluster. Note: This setting is always enabled for clusters with local NVMe SSDs. Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default..
- Provider
Region stringName - 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. Do not specify this field when creating a multi-region cluster using the replicationSpec document or a Global Cluster with the replicationSpecs array.
- Provider
Volume stringType The type of the volume. The possible values are:
STANDARD
andPROVISIONED
.PROVISIONED
is ONLY required if setting IOPS higher than the default instance IOPS.NOTE:
STANDARD
is not available for NVME clusters.- Redact
Client boolLog Data - Flag that enables or disables log redaction, see the manual for more info. Use this in conjunction with Encryption at Rest and TLS/SSL (Transport Encryption) to assist compliance with regulatory requirements. Note: Changing this setting on a cluster will trigger a rolling restart as soon as the cluster is updated. The log redaction field is updated via an Atlas API call after cluster creation. Consequently, there may be a brief period during resource creation when log redaction is not yet enabled. To ensure complete log redaction from the outset, use
mongodbatlas.AdvancedCluster
. - Replication
Factor int - Number of replica set members. Each member keeps a copy of your databases, providing high availability and data redundancy. The possible values are 3, 5, or 7. The default value is 3.
- Replication
Specs []ClusterReplication Spec Args - Configuration for cluster regions. See Replication Spec below for more details.
- Retain
Backups boolEnabled - Set to true to retain backup snapshots for the deleted cluster. M10 and above only.
- []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_version
field. 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.
- project
Id String - The unique ID for the project to create the database user.
- provider
Instance StringSize Name - Atlas provides different instance sizes, each with a default storage capacity and RAM size. The instance size you select is used for all the data-bearing servers in your cluster. See Create a Cluster
providerSettings.instanceSizeName
for valid values and default resources. - provider
Name String Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- 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_reconfig
to the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - advanced
Configuration ClusterAdvanced Configuration - auto
Scaling BooleanCompute Enabled - auto
Scaling BooleanCompute Scale Down Enabled - Set to
true
to enable the cluster tier to scale down. This option is only available ifautoScaling.compute.enabled
istrue
.- If this option is enabled, you must specify a value for
providerSettings.autoScaling.compute.minInstanceSize
- If this option is enabled, you must specify a value for
- auto
Scaling BooleanDisk Gb Enabled - backing
Provider StringName Cloud service provider on which the server for a multi-tenant cluster is provisioned.
This setting is only valid when providerSetting.providerName is TENANT and providerSetting.instanceSizeName is M2 or M5.
The possible values are:
- AWS - Amazon AWS
- GCP - Google Cloud Platform
- AZURE - Microsoft Azure
- backup
Enabled Boolean - Legacy Backup - Set to true to enable Atlas legacy backups for the cluster.
Important - MongoDB deprecated the Legacy Backup feature. Clusters that use Legacy Backup can continue to use it. MongoDB recommends using Cloud Backups.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
cloud_backup
, to enable Cloud Backup. If you create a new Atlas cluster and setbackup_enabled
to true, the Provider will respond with an error. This change doesn’t affect existing clusters that use legacy backups. - Setting this value to false to disable legacy backups for the cluster will let Atlas delete any stored snapshots. In order to preserve the legacy backups snapshots, disable the legacy backups and enable the cloud backups in the single pulumi up action.
backup_enabled = "false" cloud_backup = "true"
- The default value is false. M10 and above only.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
- bi
Connector ClusterConfig Bi Connector Config - Specifies BI Connector for Atlas configuration on this cluster. BI Connector for Atlas is only available for M10+ clusters. See BI Connector below for more details.
- cloud
Backup Boolean - cluster
Type String Specifies the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
WHEN SHOULD YOU USE CLUSTERTYPE? When you set replication_specs, when you are deploying Global Clusters or when you are deploying non-Global replica sets and sharded clusters.
Accepted values include:
REPLICASET
Replica setSHARDED
Sharded clusterGEOSHARDED
Global Cluster
- 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 integer.
- The minimum disk size for dedicated clusters is 10GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value.
- Note: 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.
- Cannot be used with clusters with local NVMe SSDs
- Cannot be used with Azure clusters
- 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 complete documentation on configuring Encryption at Rest, see Encryption at Rest using Customer Key Management. Requires M10 or greater. and for legacy backups, backup_enabled, to be false or omitted. Note: Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default.
- labels
List<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
tags
instead. - mongo
Db StringMajor Version - Version of the cluster to deploy. Atlas supports all the MongoDB versions that have not reached End of Live for M10+ clusters. If omitted, Atlas deploys the cluster with the default version. For more details, see documentation. Atlas always deploys the cluster with the latest stable release of the specified version. See Release Notes for latest Current Stable Release.
- 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.
- num
Shards Integer - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- paused Boolean
- pit
Enabled Boolean - Flag that indicates if the cluster uses Continuous Cloud Backup. If set to true, cloud_backup must also be set to true.
- provider
Auto StringScaling Compute Max Instance Size - Maximum instance size to which your cluster can automatically scale (e.g., M40). Required if
autoScaling.compute.enabled
istrue
. - provider
Auto StringScaling Compute Min Instance Size - Minimum instance size to which your cluster can automatically scale (e.g., M10). Required if
autoScaling.compute.scaleDownEnabled
istrue
. - provider
Disk IntegerIops - The maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected
provider_instance_size_name
anddisk_size_gb
. This setting requires thatprovider_instance_size_name
to be M30 or greater and cannot be used with clusters with local NVMe SSDs. The default value forprovider_disk_iops
is the same as the cluster tier's Standard IOPS value, as viewable in the Atlas console. It is used in cases where a higher number of IOPS is needed and possible. If a value is submitted that is lower or equal to the default IOPS value for the cluster tier Atlas ignores the requested value and uses the default. More details available under the providerSettings.diskIOPS parameter: MongoDB API Clusters- You do not need to configure IOPS for a STANDARD disk configuration but only for a PROVISIONED configuration.
- provider
Disk StringType Name - Azure disk type of the server’s root volume. If omitted, Atlas uses the default disk type for the selected providerSettings.instanceSizeName. Example disk types and associated storage sizes: P4 - 32GB, P6 - 64GB, P10 - 128GB, P15 - 256GB, P20 - 512GB, P30 - 1024GB, P40 - 2048GB, P50 - 4095GB. More information and the most update to date disk types/storage sizes can be located at https://docs.atlas.mongodb.com/reference/api/clusters-create-one/.
- provider
Encrypt BooleanEbs Volume - (Deprecated) The Flag is always true. Flag that indicates whether the Amazon EBS encryption feature encrypts the host's root volume for both data at rest within the volume and for data moving between the volume and the cluster. Note: This setting is always enabled for clusters with local NVMe SSDs. Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default..
- provider
Region StringName - 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. Do not specify this field when creating a multi-region cluster using the replicationSpec document or a Global Cluster with the replicationSpecs array.
- provider
Volume StringType The type of the volume. The possible values are:
STANDARD
andPROVISIONED
.PROVISIONED
is ONLY required if setting IOPS higher than the default instance IOPS.NOTE:
STANDARD
is not available for NVME clusters.- redact
Client BooleanLog Data - Flag that enables or disables log redaction, see the manual for more info. Use this in conjunction with Encryption at Rest and TLS/SSL (Transport Encryption) to assist compliance with regulatory requirements. Note: Changing this setting on a cluster will trigger a rolling restart as soon as the cluster is updated. The log redaction field is updated via an Atlas API call after cluster creation. Consequently, there may be a brief period during resource creation when log redaction is not yet enabled. To ensure complete log redaction from the outset, use
mongodbatlas.AdvancedCluster
. - replication
Factor Integer - Number of replica set members. Each member keeps a copy of your databases, providing high availability and data redundancy. The possible values are 3, 5, or 7. The default value is 3.
- replication
Specs List<ClusterReplication Spec> - Configuration for cluster regions. See Replication Spec below for more details.
- retain
Backups BooleanEnabled - Set to true to retain backup snapshots for the deleted cluster. M10 and above only.
- List<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_version
field. 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.
- project
Id string - The unique ID for the project to create the database user.
- provider
Instance stringSize Name - Atlas provides different instance sizes, each with a default storage capacity and RAM size. The instance size you select is used for all the data-bearing servers in your cluster. See Create a Cluster
providerSettings.instanceSizeName
for valid values and default resources. - provider
Name string Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- 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_reconfig
to the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - advanced
Configuration ClusterAdvanced Configuration - auto
Scaling booleanCompute Enabled - auto
Scaling booleanCompute Scale Down Enabled - Set to
true
to enable the cluster tier to scale down. This option is only available ifautoScaling.compute.enabled
istrue
.- If this option is enabled, you must specify a value for
providerSettings.autoScaling.compute.minInstanceSize
- If this option is enabled, you must specify a value for
- auto
Scaling booleanDisk Gb Enabled - backing
Provider stringName Cloud service provider on which the server for a multi-tenant cluster is provisioned.
This setting is only valid when providerSetting.providerName is TENANT and providerSetting.instanceSizeName is M2 or M5.
The possible values are:
- AWS - Amazon AWS
- GCP - Google Cloud Platform
- AZURE - Microsoft Azure
- backup
Enabled boolean - Legacy Backup - Set to true to enable Atlas legacy backups for the cluster.
Important - MongoDB deprecated the Legacy Backup feature. Clusters that use Legacy Backup can continue to use it. MongoDB recommends using Cloud Backups.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
cloud_backup
, to enable Cloud Backup. If you create a new Atlas cluster and setbackup_enabled
to true, the Provider will respond with an error. This change doesn’t affect existing clusters that use legacy backups. - Setting this value to false to disable legacy backups for the cluster will let Atlas delete any stored snapshots. In order to preserve the legacy backups snapshots, disable the legacy backups and enable the cloud backups in the single pulumi up action.
backup_enabled = "false" cloud_backup = "true"
- The default value is false. M10 and above only.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
- bi
Connector ClusterConfig Bi Connector Config - Specifies BI Connector for Atlas configuration on this cluster. BI Connector for Atlas is only available for M10+ clusters. See BI Connector below for more details.
- cloud
Backup boolean - cluster
Type string Specifies the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
WHEN SHOULD YOU USE CLUSTERTYPE? When you set replication_specs, when you are deploying Global Clusters or when you are deploying non-Global replica sets and sharded clusters.
Accepted values include:
REPLICASET
Replica setSHARDED
Sharded clusterGEOSHARDED
Global Cluster
- 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 integer.
- The minimum disk size for dedicated clusters is 10GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value.
- Note: 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.
- Cannot be used with clusters with local NVMe SSDs
- Cannot be used with Azure clusters
- 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 complete documentation on configuring Encryption at Rest, see Encryption at Rest using Customer Key Management. Requires M10 or greater. and for legacy backups, backup_enabled, to be false or omitted. Note: Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default.
- labels
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
tags
instead. - mongo
Db stringMajor Version - Version of the cluster to deploy. Atlas supports all the MongoDB versions that have not reached End of Live for M10+ clusters. If omitted, Atlas deploys the cluster with the default version. For more details, see documentation. Atlas always deploys the cluster with the latest stable release of the specified version. See Release Notes for latest Current Stable Release.
- 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.
- num
Shards number - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- paused boolean
- pit
Enabled boolean - Flag that indicates if the cluster uses Continuous Cloud Backup. If set to true, cloud_backup must also be set to true.
- provider
Auto stringScaling Compute Max Instance Size - Maximum instance size to which your cluster can automatically scale (e.g., M40). Required if
autoScaling.compute.enabled
istrue
. - provider
Auto stringScaling Compute Min Instance Size - Minimum instance size to which your cluster can automatically scale (e.g., M10). Required if
autoScaling.compute.scaleDownEnabled
istrue
. - provider
Disk numberIops - The maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected
provider_instance_size_name
anddisk_size_gb
. This setting requires thatprovider_instance_size_name
to be M30 or greater and cannot be used with clusters with local NVMe SSDs. The default value forprovider_disk_iops
is the same as the cluster tier's Standard IOPS value, as viewable in the Atlas console. It is used in cases where a higher number of IOPS is needed and possible. If a value is submitted that is lower or equal to the default IOPS value for the cluster tier Atlas ignores the requested value and uses the default. More details available under the providerSettings.diskIOPS parameter: MongoDB API Clusters- You do not need to configure IOPS for a STANDARD disk configuration but only for a PROVISIONED configuration.
- provider
Disk stringType Name - Azure disk type of the server’s root volume. If omitted, Atlas uses the default disk type for the selected providerSettings.instanceSizeName. Example disk types and associated storage sizes: P4 - 32GB, P6 - 64GB, P10 - 128GB, P15 - 256GB, P20 - 512GB, P30 - 1024GB, P40 - 2048GB, P50 - 4095GB. More information and the most update to date disk types/storage sizes can be located at https://docs.atlas.mongodb.com/reference/api/clusters-create-one/.
- provider
Encrypt booleanEbs Volume - (Deprecated) The Flag is always true. Flag that indicates whether the Amazon EBS encryption feature encrypts the host's root volume for both data at rest within the volume and for data moving between the volume and the cluster. Note: This setting is always enabled for clusters with local NVMe SSDs. Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default..
- provider
Region stringName - 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. Do not specify this field when creating a multi-region cluster using the replicationSpec document or a Global Cluster with the replicationSpecs array.
- provider
Volume stringType The type of the volume. The possible values are:
STANDARD
andPROVISIONED
.PROVISIONED
is ONLY required if setting IOPS higher than the default instance IOPS.NOTE:
STANDARD
is not available for NVME clusters.- redact
Client booleanLog Data - Flag that enables or disables log redaction, see the manual for more info. Use this in conjunction with Encryption at Rest and TLS/SSL (Transport Encryption) to assist compliance with regulatory requirements. Note: Changing this setting on a cluster will trigger a rolling restart as soon as the cluster is updated. The log redaction field is updated via an Atlas API call after cluster creation. Consequently, there may be a brief period during resource creation when log redaction is not yet enabled. To ensure complete log redaction from the outset, use
mongodbatlas.AdvancedCluster
. - replication
Factor number - Number of replica set members. Each member keeps a copy of your databases, providing high availability and data redundancy. The possible values are 3, 5, or 7. The default value is 3.
- replication
Specs ClusterReplication Spec[] - Configuration for cluster regions. See Replication Spec below for more details.
- retain
Backups booleanEnabled - Set to true to retain backup snapshots for the deleted cluster. M10 and above only.
- 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_version
field. 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.
- project_
id str - The unique ID for the project to create the database user.
- provider_
instance_ strsize_ name - Atlas provides different instance sizes, each with a default storage capacity and RAM size. The instance size you select is used for all the data-bearing servers in your cluster. See Create a Cluster
providerSettings.instanceSizeName
for valid values and default resources. - provider_
name str Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- 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_reconfig
to the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - advanced_
configuration ClusterAdvanced Configuration Args - auto_
scaling_ boolcompute_ enabled - auto_
scaling_ boolcompute_ scale_ down_ enabled - Set to
true
to enable the cluster tier to scale down. This option is only available ifautoScaling.compute.enabled
istrue
.- If this option is enabled, you must specify a value for
providerSettings.autoScaling.compute.minInstanceSize
- If this option is enabled, you must specify a value for
- auto_
scaling_ booldisk_ gb_ enabled - backing_
provider_ strname Cloud service provider on which the server for a multi-tenant cluster is provisioned.
This setting is only valid when providerSetting.providerName is TENANT and providerSetting.instanceSizeName is M2 or M5.
The possible values are:
- AWS - Amazon AWS
- GCP - Google Cloud Platform
- AZURE - Microsoft Azure
- backup_
enabled bool - Legacy Backup - Set to true to enable Atlas legacy backups for the cluster.
Important - MongoDB deprecated the Legacy Backup feature. Clusters that use Legacy Backup can continue to use it. MongoDB recommends using Cloud Backups.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
cloud_backup
, to enable Cloud Backup. If you create a new Atlas cluster and setbackup_enabled
to true, the Provider will respond with an error. This change doesn’t affect existing clusters that use legacy backups. - Setting this value to false to disable legacy backups for the cluster will let Atlas delete any stored snapshots. In order to preserve the legacy backups snapshots, disable the legacy backups and enable the cloud backups in the single pulumi up action.
backup_enabled = "false" cloud_backup = "true"
- The default value is false. M10 and above only.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
- bi_
connector_ Clusterconfig Bi Connector Config Args - Specifies BI Connector for Atlas configuration on this cluster. BI Connector for Atlas is only available for M10+ clusters. See BI Connector below for more details.
- cloud_
backup bool - cluster_
type str Specifies the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
WHEN SHOULD YOU USE CLUSTERTYPE? When you set replication_specs, when you are deploying Global Clusters or when you are deploying non-Global replica sets and sharded clusters.
Accepted values include:
REPLICASET
Replica setSHARDED
Sharded clusterGEOSHARDED
Global Cluster
- 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 integer.
- The minimum disk size for dedicated clusters is 10GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value.
- Note: 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.
- Cannot be used with clusters with local NVMe SSDs
- Cannot be used with Azure clusters
- 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 complete documentation on configuring Encryption at Rest, see Encryption at Rest using Customer Key Management. Requires M10 or greater. and for legacy backups, backup_enabled, to be false or omitted. Note: Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default.
- labels
Sequence[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
tags
instead. - mongo_
db_ strmajor_ version - Version of the cluster to deploy. Atlas supports all the MongoDB versions that have not reached End of Live for M10+ clusters. If omitted, Atlas deploys the cluster with the default version. For more details, see documentation. Atlas always deploys the cluster with the latest stable release of the specified version. See Release Notes for latest Current Stable Release.
- 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.
- num_
shards int - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- paused bool
- pit_
enabled bool - Flag that indicates if the cluster uses Continuous Cloud Backup. If set to true, cloud_backup must also be set to true.
- provider_
auto_ strscaling_ compute_ max_ instance_ size - Maximum instance size to which your cluster can automatically scale (e.g., M40). Required if
autoScaling.compute.enabled
istrue
. - provider_
auto_ strscaling_ compute_ min_ instance_ size - Minimum instance size to which your cluster can automatically scale (e.g., M10). Required if
autoScaling.compute.scaleDownEnabled
istrue
. - provider_
disk_ intiops - The maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected
provider_instance_size_name
anddisk_size_gb
. This setting requires thatprovider_instance_size_name
to be M30 or greater and cannot be used with clusters with local NVMe SSDs. The default value forprovider_disk_iops
is the same as the cluster tier's Standard IOPS value, as viewable in the Atlas console. It is used in cases where a higher number of IOPS is needed and possible. If a value is submitted that is lower or equal to the default IOPS value for the cluster tier Atlas ignores the requested value and uses the default. More details available under the providerSettings.diskIOPS parameter: MongoDB API Clusters- You do not need to configure IOPS for a STANDARD disk configuration but only for a PROVISIONED configuration.
- provider_
disk_ strtype_ name - Azure disk type of the server’s root volume. If omitted, Atlas uses the default disk type for the selected providerSettings.instanceSizeName. Example disk types and associated storage sizes: P4 - 32GB, P6 - 64GB, P10 - 128GB, P15 - 256GB, P20 - 512GB, P30 - 1024GB, P40 - 2048GB, P50 - 4095GB. More information and the most update to date disk types/storage sizes can be located at https://docs.atlas.mongodb.com/reference/api/clusters-create-one/.
- provider_
encrypt_ boolebs_ volume - (Deprecated) The Flag is always true. Flag that indicates whether the Amazon EBS encryption feature encrypts the host's root volume for both data at rest within the volume and for data moving between the volume and the cluster. Note: This setting is always enabled for clusters with local NVMe SSDs. Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default..
- provider_
region_ strname - 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. Do not specify this field when creating a multi-region cluster using the replicationSpec document or a Global Cluster with the replicationSpecs array.
- provider_
volume_ strtype The type of the volume. The possible values are:
STANDARD
andPROVISIONED
.PROVISIONED
is ONLY required if setting IOPS higher than the default instance IOPS.NOTE:
STANDARD
is not available for NVME clusters.- redact_
client_ boollog_ data - Flag that enables or disables log redaction, see the manual for more info. Use this in conjunction with Encryption at Rest and TLS/SSL (Transport Encryption) to assist compliance with regulatory requirements. Note: Changing this setting on a cluster will trigger a rolling restart as soon as the cluster is updated. The log redaction field is updated via an Atlas API call after cluster creation. Consequently, there may be a brief period during resource creation when log redaction is not yet enabled. To ensure complete log redaction from the outset, use
mongodbatlas.AdvancedCluster
. - replication_
factor int - Number of replica set members. Each member keeps a copy of your databases, providing high availability and data redundancy. The possible values are 3, 5, or 7. The default value is 3.
- replication_
specs Sequence[ClusterReplication Spec Args] - Configuration for cluster regions. See Replication Spec below for more details.
- retain_
backups_ boolenabled - Set to true to retain backup snapshots for the deleted cluster. M10 and above only.
- Sequence[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_version
field. 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.
- project
Id String - The unique ID for the project to create the database user.
- provider
Instance StringSize Name - Atlas provides different instance sizes, each with a default storage capacity and RAM size. The instance size you select is used for all the data-bearing servers in your cluster. See Create a Cluster
providerSettings.instanceSizeName
for valid values and default resources. - provider
Name String Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- 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_reconfig
to the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - advanced
Configuration Property Map - auto
Scaling BooleanCompute Enabled - auto
Scaling BooleanCompute Scale Down Enabled - Set to
true
to enable the cluster tier to scale down. This option is only available ifautoScaling.compute.enabled
istrue
.- If this option is enabled, you must specify a value for
providerSettings.autoScaling.compute.minInstanceSize
- If this option is enabled, you must specify a value for
- auto
Scaling BooleanDisk Gb Enabled - backing
Provider StringName Cloud service provider on which the server for a multi-tenant cluster is provisioned.
This setting is only valid when providerSetting.providerName is TENANT and providerSetting.instanceSizeName is M2 or M5.
The possible values are:
- AWS - Amazon AWS
- GCP - Google Cloud Platform
- AZURE - Microsoft Azure
- backup
Enabled Boolean - Legacy Backup - Set to true to enable Atlas legacy backups for the cluster.
Important - MongoDB deprecated the Legacy Backup feature. Clusters that use Legacy Backup can continue to use it. MongoDB recommends using Cloud Backups.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
cloud_backup
, to enable Cloud Backup. If you create a new Atlas cluster and setbackup_enabled
to true, the Provider will respond with an error. This change doesn’t affect existing clusters that use legacy backups. - Setting this value to false to disable legacy backups for the cluster will let Atlas delete any stored snapshots. In order to preserve the legacy backups snapshots, disable the legacy backups and enable the cloud backups in the single pulumi up action.
backup_enabled = "false" cloud_backup = "true"
- The default value is false. M10 and above only.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
- bi
Connector Property MapConfig - Specifies BI Connector for Atlas configuration on this cluster. BI Connector for Atlas is only available for M10+ clusters. See BI Connector below for more details.
- cloud
Backup Boolean - cluster
Type String Specifies the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
WHEN SHOULD YOU USE CLUSTERTYPE? When you set replication_specs, when you are deploying Global Clusters or when you are deploying non-Global replica sets and sharded clusters.
Accepted values include:
REPLICASET
Replica setSHARDED
Sharded clusterGEOSHARDED
Global Cluster
- 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 integer.
- The minimum disk size for dedicated clusters is 10GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value.
- Note: 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.
- Cannot be used with clusters with local NVMe SSDs
- Cannot be used with Azure clusters
- 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 complete documentation on configuring Encryption at Rest, see Encryption at Rest using Customer Key Management. Requires M10 or greater. and for legacy backups, backup_enabled, to be false or omitted. Note: Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default.
- 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
tags
instead. - mongo
Db StringMajor Version - Version of the cluster to deploy. Atlas supports all the MongoDB versions that have not reached End of Live for M10+ clusters. If omitted, Atlas deploys the cluster with the default version. For more details, see documentation. Atlas always deploys the cluster with the latest stable release of the specified version. See Release Notes for latest Current Stable Release.
- 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.
- num
Shards Number - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- paused Boolean
- pit
Enabled Boolean - Flag that indicates if the cluster uses Continuous Cloud Backup. If set to true, cloud_backup must also be set to true.
- provider
Auto StringScaling Compute Max Instance Size - Maximum instance size to which your cluster can automatically scale (e.g., M40). Required if
autoScaling.compute.enabled
istrue
. - provider
Auto StringScaling Compute Min Instance Size - Minimum instance size to which your cluster can automatically scale (e.g., M10). Required if
autoScaling.compute.scaleDownEnabled
istrue
. - provider
Disk NumberIops - The maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected
provider_instance_size_name
anddisk_size_gb
. This setting requires thatprovider_instance_size_name
to be M30 or greater and cannot be used with clusters with local NVMe SSDs. The default value forprovider_disk_iops
is the same as the cluster tier's Standard IOPS value, as viewable in the Atlas console. It is used in cases where a higher number of IOPS is needed and possible. If a value is submitted that is lower or equal to the default IOPS value for the cluster tier Atlas ignores the requested value and uses the default. More details available under the providerSettings.diskIOPS parameter: MongoDB API Clusters- You do not need to configure IOPS for a STANDARD disk configuration but only for a PROVISIONED configuration.
- provider
Disk StringType Name - Azure disk type of the server’s root volume. If omitted, Atlas uses the default disk type for the selected providerSettings.instanceSizeName. Example disk types and associated storage sizes: P4 - 32GB, P6 - 64GB, P10 - 128GB, P15 - 256GB, P20 - 512GB, P30 - 1024GB, P40 - 2048GB, P50 - 4095GB. More information and the most update to date disk types/storage sizes can be located at https://docs.atlas.mongodb.com/reference/api/clusters-create-one/.
- provider
Encrypt BooleanEbs Volume - (Deprecated) The Flag is always true. Flag that indicates whether the Amazon EBS encryption feature encrypts the host's root volume for both data at rest within the volume and for data moving between the volume and the cluster. Note: This setting is always enabled for clusters with local NVMe SSDs. Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default..
- provider
Region StringName - 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. Do not specify this field when creating a multi-region cluster using the replicationSpec document or a Global Cluster with the replicationSpecs array.
- provider
Volume StringType The type of the volume. The possible values are:
STANDARD
andPROVISIONED
.PROVISIONED
is ONLY required if setting IOPS higher than the default instance IOPS.NOTE:
STANDARD
is not available for NVME clusters.- redact
Client BooleanLog Data - Flag that enables or disables log redaction, see the manual for more info. Use this in conjunction with Encryption at Rest and TLS/SSL (Transport Encryption) to assist compliance with regulatory requirements. Note: Changing this setting on a cluster will trigger a rolling restart as soon as the cluster is updated. The log redaction field is updated via an Atlas API call after cluster creation. Consequently, there may be a brief period during resource creation when log redaction is not yet enabled. To ensure complete log redaction from the outset, use
mongodbatlas.AdvancedCluster
. - replication
Factor Number - Number of replica set members. Each member keeps a copy of your databases, providing high availability and data redundancy. The possible values are 3, 5, or 7. The default value is 3.
- replication
Specs List<Property Map> - Configuration for cluster regions. See Replication Spec below for more details.
- retain
Backups BooleanEnabled - Set to true to retain backup snapshots for the deleted cluster. M10 and above only.
- 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_version
field. 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 Cluster resource produces the following output properties:
- Cluster
Id string - The cluster ID.
- Connection
Strings List<ClusterConnection 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.
- Container
Id string - The Container ID is the id of the container created when the first cluster in the region (AWS/Azure) or project (GCP) was created.
- Id string
- The provider-assigned unique ID for this managed resource.
- Mongo
Db stringVersion - Version of MongoDB the cluster runs, in
major-version
.minor-version
format. - Mongo
Uri string - Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.
- Mongo
Uri stringUpdated - Lists when the connection string was last updated. The connection string changes, for example, if you change a replica set to a sharded cluster.
- Mongo
Uri stringWith Options - connection string for connecting to the Atlas cluster. Includes the replicaSet, ssl, and authSource query parameters in the connection string with values appropriate for the cluster.
- Provider
Encrypt boolEbs Volume Flag - Snapshot
Backup List<ClusterPolicies Snapshot Backup Policy> - current snapshot schedule and retention settings for the cluster.
- Srv
Address string - Connection string for connecting to the Atlas cluster. The +srv modifier forces the connection to use TLS/SSL. See the mongoURI for additional options.
- 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 []ClusterConnection 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.
- Container
Id string - The Container ID is the id of the container created when the first cluster in the region (AWS/Azure) or project (GCP) was created.
- Id string
- The provider-assigned unique ID for this managed resource.
- Mongo
Db stringVersion - Version of MongoDB the cluster runs, in
major-version
.minor-version
format. - Mongo
Uri string - Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.
- Mongo
Uri stringUpdated - Lists when the connection string was last updated. The connection string changes, for example, if you change a replica set to a sharded cluster.
- Mongo
Uri stringWith Options - connection string for connecting to the Atlas cluster. Includes the replicaSet, ssl, and authSource query parameters in the connection string with values appropriate for the cluster.
- Provider
Encrypt boolEbs Volume Flag - Snapshot
Backup []ClusterPolicies Snapshot Backup Policy - current snapshot schedule and retention settings for the cluster.
- Srv
Address string - Connection string for connecting to the Atlas cluster. The +srv modifier forces the connection to use TLS/SSL. See the mongoURI for additional options.
- 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<ClusterConnection 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.
- container
Id String - The Container ID is the id of the container created when the first cluster in the region (AWS/Azure) or project (GCP) was created.
- id String
- The provider-assigned unique ID for this managed resource.
- mongo
Db StringVersion - Version of MongoDB the cluster runs, in
major-version
.minor-version
format. - mongo
Uri String - Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.
- mongo
Uri StringUpdated - Lists when the connection string was last updated. The connection string changes, for example, if you change a replica set to a sharded cluster.
- mongo
Uri StringWith Options - connection string for connecting to the Atlas cluster. Includes the replicaSet, ssl, and authSource query parameters in the connection string with values appropriate for the cluster.
- provider
Encrypt BooleanEbs Volume Flag - snapshot
Backup List<ClusterPolicies Snapshot Backup Policy> - current snapshot schedule and retention settings for the cluster.
- srv
Address String - Connection string for connecting to the Atlas cluster. The +srv modifier forces the connection to use TLS/SSL. See the mongoURI for additional options.
- 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 ClusterConnection 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.
- container
Id string - The Container ID is the id of the container created when the first cluster in the region (AWS/Azure) or project (GCP) was created.
- id string
- The provider-assigned unique ID for this managed resource.
- mongo
Db stringVersion - Version of MongoDB the cluster runs, in
major-version
.minor-version
format. - mongo
Uri string - Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.
- mongo
Uri stringUpdated - Lists when the connection string was last updated. The connection string changes, for example, if you change a replica set to a sharded cluster.
- mongo
Uri stringWith Options - connection string for connecting to the Atlas cluster. Includes the replicaSet, ssl, and authSource query parameters in the connection string with values appropriate for the cluster.
- provider
Encrypt booleanEbs Volume Flag - snapshot
Backup ClusterPolicies Snapshot Backup Policy[] - current snapshot schedule and retention settings for the cluster.
- srv
Address string - Connection string for connecting to the Atlas cluster. The +srv modifier forces the connection to use TLS/SSL. See the mongoURI for additional options.
- 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[ClusterConnection 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.
- container_
id str - The Container ID is the id of the container created when the first cluster in the region (AWS/Azure) or project (GCP) was created.
- id str
- The provider-assigned unique ID for this managed resource.
- mongo_
db_ strversion - Version of MongoDB the cluster runs, in
major-version
.minor-version
format. - mongo_
uri str - Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.
- mongo_
uri_ strupdated - Lists when the connection string was last updated. The connection string changes, for example, if you change a replica set to a sharded cluster.
- mongo_
uri_ strwith_ options - connection string for connecting to the Atlas cluster. Includes the replicaSet, ssl, and authSource query parameters in the connection string with values appropriate for the cluster.
- provider_
encrypt_ boolebs_ volume_ flag - snapshot_
backup_ Sequence[Clusterpolicies Snapshot Backup Policy] - current snapshot schedule and retention settings for the cluster.
- srv_
address str - Connection string for connecting to the Atlas cluster. The +srv modifier forces the connection to use TLS/SSL. See the mongoURI for additional options.
- 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.
- container
Id String - The Container ID is the id of the container created when the first cluster in the region (AWS/Azure) or project (GCP) was created.
- id String
- The provider-assigned unique ID for this managed resource.
- mongo
Db StringVersion - Version of MongoDB the cluster runs, in
major-version
.minor-version
format. - mongo
Uri String - Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.
- mongo
Uri StringUpdated - Lists when the connection string was last updated. The connection string changes, for example, if you change a replica set to a sharded cluster.
- mongo
Uri StringWith Options - connection string for connecting to the Atlas cluster. Includes the replicaSet, ssl, and authSource query parameters in the connection string with values appropriate for the cluster.
- provider
Encrypt BooleanEbs Volume Flag - snapshot
Backup List<Property Map>Policies - current snapshot schedule and retention settings for the cluster.
- srv
Address String - Connection string for connecting to the Atlas cluster. The +srv modifier forces the connection to use TLS/SSL. See the mongoURI for additional options.
- state
Name String - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
Look up Existing Cluster Resource
Get an existing Cluster 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?: ClusterState, opts?: CustomResourceOptions): Cluster
@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[ClusterAdvancedConfigurationArgs] = None,
auto_scaling_compute_enabled: Optional[bool] = None,
auto_scaling_compute_scale_down_enabled: Optional[bool] = None,
auto_scaling_disk_gb_enabled: Optional[bool] = None,
backing_provider_name: Optional[str] = None,
backup_enabled: Optional[bool] = None,
bi_connector_config: Optional[ClusterBiConnectorConfigArgs] = None,
cloud_backup: Optional[bool] = None,
cluster_id: Optional[str] = None,
cluster_type: Optional[str] = None,
connection_strings: Optional[Sequence[ClusterConnectionStringArgs]] = None,
container_id: Optional[str] = None,
disk_size_gb: Optional[float] = None,
encryption_at_rest_provider: Optional[str] = None,
labels: Optional[Sequence[ClusterLabelArgs]] = None,
mongo_db_major_version: Optional[str] = None,
mongo_db_version: Optional[str] = None,
mongo_uri: Optional[str] = None,
mongo_uri_updated: Optional[str] = None,
mongo_uri_with_options: Optional[str] = None,
name: Optional[str] = None,
num_shards: Optional[int] = None,
paused: Optional[bool] = None,
pit_enabled: Optional[bool] = None,
project_id: Optional[str] = None,
provider_auto_scaling_compute_max_instance_size: Optional[str] = None,
provider_auto_scaling_compute_min_instance_size: Optional[str] = None,
provider_disk_iops: Optional[int] = None,
provider_disk_type_name: Optional[str] = None,
provider_encrypt_ebs_volume: Optional[bool] = None,
provider_encrypt_ebs_volume_flag: Optional[bool] = None,
provider_instance_size_name: Optional[str] = None,
provider_name: Optional[str] = None,
provider_region_name: Optional[str] = None,
provider_volume_type: Optional[str] = None,
redact_client_log_data: Optional[bool] = None,
replication_factor: Optional[int] = None,
replication_specs: Optional[Sequence[ClusterReplicationSpecArgs]] = None,
retain_backups_enabled: Optional[bool] = None,
snapshot_backup_policies: Optional[Sequence[ClusterSnapshotBackupPolicyArgs]] = None,
srv_address: Optional[str] = None,
state_name: Optional[str] = None,
tags: Optional[Sequence[ClusterTagArgs]] = None,
termination_protection_enabled: Optional[bool] = None,
version_release_system: Optional[str] = None) -> Cluster
func GetCluster(ctx *Context, name string, id IDInput, state *ClusterState, opts ...ResourceOption) (*Cluster, error)
public static Cluster Get(string name, Input<string> id, ClusterState? state, CustomResourceOptions? opts = null)
public static Cluster get(String name, Output<String> id, ClusterState 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_reconfig
to the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - Advanced
Configuration ClusterAdvanced Configuration - Auto
Scaling boolCompute Enabled - Auto
Scaling boolCompute Scale Down Enabled - Set to
true
to enable the cluster tier to scale down. This option is only available ifautoScaling.compute.enabled
istrue
.- If this option is enabled, you must specify a value for
providerSettings.autoScaling.compute.minInstanceSize
- If this option is enabled, you must specify a value for
- Auto
Scaling boolDisk Gb Enabled - Backing
Provider stringName Cloud service provider on which the server for a multi-tenant cluster is provisioned.
This setting is only valid when providerSetting.providerName is TENANT and providerSetting.instanceSizeName is M2 or M5.
The possible values are:
- AWS - Amazon AWS
- GCP - Google Cloud Platform
- AZURE - Microsoft Azure
- Backup
Enabled bool - Legacy Backup - Set to true to enable Atlas legacy backups for the cluster.
Important - MongoDB deprecated the Legacy Backup feature. Clusters that use Legacy Backup can continue to use it. MongoDB recommends using Cloud Backups.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
cloud_backup
, to enable Cloud Backup. If you create a new Atlas cluster and setbackup_enabled
to true, the Provider will respond with an error. This change doesn’t affect existing clusters that use legacy backups. - Setting this value to false to disable legacy backups for the cluster will let Atlas delete any stored snapshots. In order to preserve the legacy backups snapshots, disable the legacy backups and enable the cloud backups in the single pulumi up action.
backup_enabled = "false" cloud_backup = "true"
- The default value is false. M10 and above only.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
- Bi
Connector ClusterConfig Bi Connector Config - Specifies BI Connector for Atlas configuration on this cluster. BI Connector for Atlas is only available for M10+ clusters. See BI Connector below for more details.
- Cloud
Backup bool - Cluster
Id string - The cluster ID.
- Cluster
Type string Specifies the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
WHEN SHOULD YOU USE CLUSTERTYPE? When you set replication_specs, when you are deploying Global Clusters or when you are deploying non-Global replica sets and sharded clusters.
Accepted values include:
REPLICASET
Replica setSHARDED
Sharded clusterGEOSHARDED
Global Cluster
- Connection
Strings List<ClusterConnection 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.
- Container
Id string - The Container ID is the id of the container created when the first cluster in the region (AWS/Azure) or project (GCP) was created.
- 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 integer.
- The minimum disk size for dedicated clusters is 10GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value.
- Note: 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.
- Cannot be used with clusters with local NVMe SSDs
- Cannot be used with Azure clusters
- 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 complete documentation on configuring Encryption at Rest, see Encryption at Rest using Customer Key Management. Requires M10 or greater. and for legacy backups, backup_enabled, to be false or omitted. Note: Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default.
- Labels
List<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
tags
instead. - Mongo
Db stringMajor Version - Version of the cluster to deploy. Atlas supports all the MongoDB versions that have not reached End of Live for M10+ clusters. If omitted, Atlas deploys the cluster with the default version. For more details, see documentation. Atlas always deploys the cluster with the latest stable release of the specified version. See Release Notes for latest Current Stable Release.
- Mongo
Db stringVersion - Version of MongoDB the cluster runs, in
major-version
.minor-version
format. - Mongo
Uri string - Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.
- Mongo
Uri stringUpdated - Lists when the connection string was last updated. The connection string changes, for example, if you change a replica set to a sharded cluster.
- Mongo
Uri stringWith Options - connection string for connecting to the Atlas cluster. Includes the replicaSet, ssl, and authSource query parameters in the connection string with values appropriate for the cluster.
- 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.
- Num
Shards int - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- Paused bool
- Pit
Enabled bool - Flag that indicates if the cluster uses Continuous Cloud Backup. If set to true, cloud_backup must also be set to true.
- Project
Id string - The unique ID for the project to create the database user.
- Provider
Auto stringScaling Compute Max Instance Size - Maximum instance size to which your cluster can automatically scale (e.g., M40). Required if
autoScaling.compute.enabled
istrue
. - Provider
Auto stringScaling Compute Min Instance Size - Minimum instance size to which your cluster can automatically scale (e.g., M10). Required if
autoScaling.compute.scaleDownEnabled
istrue
. - Provider
Disk intIops - The maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected
provider_instance_size_name
anddisk_size_gb
. This setting requires thatprovider_instance_size_name
to be M30 or greater and cannot be used with clusters with local NVMe SSDs. The default value forprovider_disk_iops
is the same as the cluster tier's Standard IOPS value, as viewable in the Atlas console. It is used in cases where a higher number of IOPS is needed and possible. If a value is submitted that is lower or equal to the default IOPS value for the cluster tier Atlas ignores the requested value and uses the default. More details available under the providerSettings.diskIOPS parameter: MongoDB API Clusters- You do not need to configure IOPS for a STANDARD disk configuration but only for a PROVISIONED configuration.
- Provider
Disk stringType Name - Azure disk type of the server’s root volume. If omitted, Atlas uses the default disk type for the selected providerSettings.instanceSizeName. Example disk types and associated storage sizes: P4 - 32GB, P6 - 64GB, P10 - 128GB, P15 - 256GB, P20 - 512GB, P30 - 1024GB, P40 - 2048GB, P50 - 4095GB. More information and the most update to date disk types/storage sizes can be located at https://docs.atlas.mongodb.com/reference/api/clusters-create-one/.
- Provider
Encrypt boolEbs Volume - (Deprecated) The Flag is always true. Flag that indicates whether the Amazon EBS encryption feature encrypts the host's root volume for both data at rest within the volume and for data moving between the volume and the cluster. Note: This setting is always enabled for clusters with local NVMe SSDs. Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default..
- Provider
Encrypt boolEbs Volume Flag - Provider
Instance stringSize Name - Atlas provides different instance sizes, each with a default storage capacity and RAM size. The instance size you select is used for all the data-bearing servers in your cluster. See Create a Cluster
providerSettings.instanceSizeName
for valid values and default resources. - Provider
Name string Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- Provider
Region stringName - 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. Do not specify this field when creating a multi-region cluster using the replicationSpec document or a Global Cluster with the replicationSpecs array.
- Provider
Volume stringType The type of the volume. The possible values are:
STANDARD
andPROVISIONED
.PROVISIONED
is ONLY required if setting IOPS higher than the default instance IOPS.NOTE:
STANDARD
is not available for NVME clusters.- Redact
Client boolLog Data - Flag that enables or disables log redaction, see the manual for more info. Use this in conjunction with Encryption at Rest and TLS/SSL (Transport Encryption) to assist compliance with regulatory requirements. Note: Changing this setting on a cluster will trigger a rolling restart as soon as the cluster is updated. The log redaction field is updated via an Atlas API call after cluster creation. Consequently, there may be a brief period during resource creation when log redaction is not yet enabled. To ensure complete log redaction from the outset, use
mongodbatlas.AdvancedCluster
. - Replication
Factor int - Number of replica set members. Each member keeps a copy of your databases, providing high availability and data redundancy. The possible values are 3, 5, or 7. The default value is 3.
- Replication
Specs List<ClusterReplication Spec> - Configuration for cluster regions. See Replication Spec below for more details.
- Retain
Backups boolEnabled - Set to true to retain backup snapshots for the deleted cluster. M10 and above only.
- Snapshot
Backup List<ClusterPolicies Snapshot Backup Policy> - current snapshot schedule and retention settings for the cluster.
- Srv
Address string - Connection string for connecting to the Atlas cluster. The +srv modifier forces the connection to use TLS/SSL. See the mongoURI for additional options.
- State
Name string - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
- List<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_version
field. 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_reconfig
to the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - Advanced
Configuration ClusterAdvanced Configuration Args - Auto
Scaling boolCompute Enabled - Auto
Scaling boolCompute Scale Down Enabled - Set to
true
to enable the cluster tier to scale down. This option is only available ifautoScaling.compute.enabled
istrue
.- If this option is enabled, you must specify a value for
providerSettings.autoScaling.compute.minInstanceSize
- If this option is enabled, you must specify a value for
- Auto
Scaling boolDisk Gb Enabled - Backing
Provider stringName Cloud service provider on which the server for a multi-tenant cluster is provisioned.
This setting is only valid when providerSetting.providerName is TENANT and providerSetting.instanceSizeName is M2 or M5.
The possible values are:
- AWS - Amazon AWS
- GCP - Google Cloud Platform
- AZURE - Microsoft Azure
- Backup
Enabled bool - Legacy Backup - Set to true to enable Atlas legacy backups for the cluster.
Important - MongoDB deprecated the Legacy Backup feature. Clusters that use Legacy Backup can continue to use it. MongoDB recommends using Cloud Backups.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
cloud_backup
, to enable Cloud Backup. If you create a new Atlas cluster and setbackup_enabled
to true, the Provider will respond with an error. This change doesn’t affect existing clusters that use legacy backups. - Setting this value to false to disable legacy backups for the cluster will let Atlas delete any stored snapshots. In order to preserve the legacy backups snapshots, disable the legacy backups and enable the cloud backups in the single pulumi up action.
backup_enabled = "false" cloud_backup = "true"
- The default value is false. M10 and above only.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
- Bi
Connector ClusterConfig Bi Connector Config Args - Specifies BI Connector for Atlas configuration on this cluster. BI Connector for Atlas is only available for M10+ clusters. See BI Connector below for more details.
- Cloud
Backup bool - Cluster
Id string - The cluster ID.
- Cluster
Type string Specifies the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
WHEN SHOULD YOU USE CLUSTERTYPE? When you set replication_specs, when you are deploying Global Clusters or when you are deploying non-Global replica sets and sharded clusters.
Accepted values include:
REPLICASET
Replica setSHARDED
Sharded clusterGEOSHARDED
Global Cluster
- Connection
Strings []ClusterConnection 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.
- Container
Id string - The Container ID is the id of the container created when the first cluster in the region (AWS/Azure) or project (GCP) was created.
- 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 integer.
- The minimum disk size for dedicated clusters is 10GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value.
- Note: 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.
- Cannot be used with clusters with local NVMe SSDs
- Cannot be used with Azure clusters
- 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 complete documentation on configuring Encryption at Rest, see Encryption at Rest using Customer Key Management. Requires M10 or greater. and for legacy backups, backup_enabled, to be false or omitted. Note: Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default.
- Labels
[]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
tags
instead. - Mongo
Db stringMajor Version - Version of the cluster to deploy. Atlas supports all the MongoDB versions that have not reached End of Live for M10+ clusters. If omitted, Atlas deploys the cluster with the default version. For more details, see documentation. Atlas always deploys the cluster with the latest stable release of the specified version. See Release Notes for latest Current Stable Release.
- Mongo
Db stringVersion - Version of MongoDB the cluster runs, in
major-version
.minor-version
format. - Mongo
Uri string - Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.
- Mongo
Uri stringUpdated - Lists when the connection string was last updated. The connection string changes, for example, if you change a replica set to a sharded cluster.
- Mongo
Uri stringWith Options - connection string for connecting to the Atlas cluster. Includes the replicaSet, ssl, and authSource query parameters in the connection string with values appropriate for the cluster.
- 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.
- Num
Shards int - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- Paused bool
- Pit
Enabled bool - Flag that indicates if the cluster uses Continuous Cloud Backup. If set to true, cloud_backup must also be set to true.
- Project
Id string - The unique ID for the project to create the database user.
- Provider
Auto stringScaling Compute Max Instance Size - Maximum instance size to which your cluster can automatically scale (e.g., M40). Required if
autoScaling.compute.enabled
istrue
. - Provider
Auto stringScaling Compute Min Instance Size - Minimum instance size to which your cluster can automatically scale (e.g., M10). Required if
autoScaling.compute.scaleDownEnabled
istrue
. - Provider
Disk intIops - The maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected
provider_instance_size_name
anddisk_size_gb
. This setting requires thatprovider_instance_size_name
to be M30 or greater and cannot be used with clusters with local NVMe SSDs. The default value forprovider_disk_iops
is the same as the cluster tier's Standard IOPS value, as viewable in the Atlas console. It is used in cases where a higher number of IOPS is needed and possible. If a value is submitted that is lower or equal to the default IOPS value for the cluster tier Atlas ignores the requested value and uses the default. More details available under the providerSettings.diskIOPS parameter: MongoDB API Clusters- You do not need to configure IOPS for a STANDARD disk configuration but only for a PROVISIONED configuration.
- Provider
Disk stringType Name - Azure disk type of the server’s root volume. If omitted, Atlas uses the default disk type for the selected providerSettings.instanceSizeName. Example disk types and associated storage sizes: P4 - 32GB, P6 - 64GB, P10 - 128GB, P15 - 256GB, P20 - 512GB, P30 - 1024GB, P40 - 2048GB, P50 - 4095GB. More information and the most update to date disk types/storage sizes can be located at https://docs.atlas.mongodb.com/reference/api/clusters-create-one/.
- Provider
Encrypt boolEbs Volume - (Deprecated) The Flag is always true. Flag that indicates whether the Amazon EBS encryption feature encrypts the host's root volume for both data at rest within the volume and for data moving between the volume and the cluster. Note: This setting is always enabled for clusters with local NVMe SSDs. Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default..
- Provider
Encrypt boolEbs Volume Flag - Provider
Instance stringSize Name - Atlas provides different instance sizes, each with a default storage capacity and RAM size. The instance size you select is used for all the data-bearing servers in your cluster. See Create a Cluster
providerSettings.instanceSizeName
for valid values and default resources. - Provider
Name string Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- Provider
Region stringName - 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. Do not specify this field when creating a multi-region cluster using the replicationSpec document or a Global Cluster with the replicationSpecs array.
- Provider
Volume stringType The type of the volume. The possible values are:
STANDARD
andPROVISIONED
.PROVISIONED
is ONLY required if setting IOPS higher than the default instance IOPS.NOTE:
STANDARD
is not available for NVME clusters.- Redact
Client boolLog Data - Flag that enables or disables log redaction, see the manual for more info. Use this in conjunction with Encryption at Rest and TLS/SSL (Transport Encryption) to assist compliance with regulatory requirements. Note: Changing this setting on a cluster will trigger a rolling restart as soon as the cluster is updated. The log redaction field is updated via an Atlas API call after cluster creation. Consequently, there may be a brief period during resource creation when log redaction is not yet enabled. To ensure complete log redaction from the outset, use
mongodbatlas.AdvancedCluster
. - Replication
Factor int - Number of replica set members. Each member keeps a copy of your databases, providing high availability and data redundancy. The possible values are 3, 5, or 7. The default value is 3.
- Replication
Specs []ClusterReplication Spec Args - Configuration for cluster regions. See Replication Spec below for more details.
- Retain
Backups boolEnabled - Set to true to retain backup snapshots for the deleted cluster. M10 and above only.
- Snapshot
Backup []ClusterPolicies Snapshot Backup Policy Args - current snapshot schedule and retention settings for the cluster.
- Srv
Address string - Connection string for connecting to the Atlas cluster. The +srv modifier forces the connection to use TLS/SSL. See the mongoURI for additional options.
- State
Name string - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
- []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_version
field. 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_reconfig
to the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - advanced
Configuration ClusterAdvanced Configuration - auto
Scaling BooleanCompute Enabled - auto
Scaling BooleanCompute Scale Down Enabled - Set to
true
to enable the cluster tier to scale down. This option is only available ifautoScaling.compute.enabled
istrue
.- If this option is enabled, you must specify a value for
providerSettings.autoScaling.compute.minInstanceSize
- If this option is enabled, you must specify a value for
- auto
Scaling BooleanDisk Gb Enabled - backing
Provider StringName Cloud service provider on which the server for a multi-tenant cluster is provisioned.
This setting is only valid when providerSetting.providerName is TENANT and providerSetting.instanceSizeName is M2 or M5.
The possible values are:
- AWS - Amazon AWS
- GCP - Google Cloud Platform
- AZURE - Microsoft Azure
- backup
Enabled Boolean - Legacy Backup - Set to true to enable Atlas legacy backups for the cluster.
Important - MongoDB deprecated the Legacy Backup feature. Clusters that use Legacy Backup can continue to use it. MongoDB recommends using Cloud Backups.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
cloud_backup
, to enable Cloud Backup. If you create a new Atlas cluster and setbackup_enabled
to true, the Provider will respond with an error. This change doesn’t affect existing clusters that use legacy backups. - Setting this value to false to disable legacy backups for the cluster will let Atlas delete any stored snapshots. In order to preserve the legacy backups snapshots, disable the legacy backups and enable the cloud backups in the single pulumi up action.
backup_enabled = "false" cloud_backup = "true"
- The default value is false. M10 and above only.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
- bi
Connector ClusterConfig Bi Connector Config - Specifies BI Connector for Atlas configuration on this cluster. BI Connector for Atlas is only available for M10+ clusters. See BI Connector below for more details.
- cloud
Backup Boolean - cluster
Id String - The cluster ID.
- cluster
Type String Specifies the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
WHEN SHOULD YOU USE CLUSTERTYPE? When you set replication_specs, when you are deploying Global Clusters or when you are deploying non-Global replica sets and sharded clusters.
Accepted values include:
REPLICASET
Replica setSHARDED
Sharded clusterGEOSHARDED
Global Cluster
- connection
Strings List<ClusterConnection 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.
- container
Id String - The Container ID is the id of the container created when the first cluster in the region (AWS/Azure) or project (GCP) was created.
- 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 integer.
- The minimum disk size for dedicated clusters is 10GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value.
- Note: 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.
- Cannot be used with clusters with local NVMe SSDs
- Cannot be used with Azure clusters
- 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 complete documentation on configuring Encryption at Rest, see Encryption at Rest using Customer Key Management. Requires M10 or greater. and for legacy backups, backup_enabled, to be false or omitted. Note: Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default.
- labels
List<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
tags
instead. - mongo
Db StringMajor Version - Version of the cluster to deploy. Atlas supports all the MongoDB versions that have not reached End of Live for M10+ clusters. If omitted, Atlas deploys the cluster with the default version. For more details, see documentation. Atlas always deploys the cluster with the latest stable release of the specified version. See Release Notes for latest Current Stable Release.
- mongo
Db StringVersion - Version of MongoDB the cluster runs, in
major-version
.minor-version
format. - mongo
Uri String - Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.
- mongo
Uri StringUpdated - Lists when the connection string was last updated. The connection string changes, for example, if you change a replica set to a sharded cluster.
- mongo
Uri StringWith Options - connection string for connecting to the Atlas cluster. Includes the replicaSet, ssl, and authSource query parameters in the connection string with values appropriate for the cluster.
- 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.
- num
Shards Integer - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- paused Boolean
- pit
Enabled Boolean - Flag that indicates if the cluster uses Continuous Cloud Backup. If set to true, cloud_backup must also be set to true.
- project
Id String - The unique ID for the project to create the database user.
- provider
Auto StringScaling Compute Max Instance Size - Maximum instance size to which your cluster can automatically scale (e.g., M40). Required if
autoScaling.compute.enabled
istrue
. - provider
Auto StringScaling Compute Min Instance Size - Minimum instance size to which your cluster can automatically scale (e.g., M10). Required if
autoScaling.compute.scaleDownEnabled
istrue
. - provider
Disk IntegerIops - The maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected
provider_instance_size_name
anddisk_size_gb
. This setting requires thatprovider_instance_size_name
to be M30 or greater and cannot be used with clusters with local NVMe SSDs. The default value forprovider_disk_iops
is the same as the cluster tier's Standard IOPS value, as viewable in the Atlas console. It is used in cases where a higher number of IOPS is needed and possible. If a value is submitted that is lower or equal to the default IOPS value for the cluster tier Atlas ignores the requested value and uses the default. More details available under the providerSettings.diskIOPS parameter: MongoDB API Clusters- You do not need to configure IOPS for a STANDARD disk configuration but only for a PROVISIONED configuration.
- provider
Disk StringType Name - Azure disk type of the server’s root volume. If omitted, Atlas uses the default disk type for the selected providerSettings.instanceSizeName. Example disk types and associated storage sizes: P4 - 32GB, P6 - 64GB, P10 - 128GB, P15 - 256GB, P20 - 512GB, P30 - 1024GB, P40 - 2048GB, P50 - 4095GB. More information and the most update to date disk types/storage sizes can be located at https://docs.atlas.mongodb.com/reference/api/clusters-create-one/.
- provider
Encrypt BooleanEbs Volume - (Deprecated) The Flag is always true. Flag that indicates whether the Amazon EBS encryption feature encrypts the host's root volume for both data at rest within the volume and for data moving between the volume and the cluster. Note: This setting is always enabled for clusters with local NVMe SSDs. Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default..
- provider
Encrypt BooleanEbs Volume Flag - provider
Instance StringSize Name - Atlas provides different instance sizes, each with a default storage capacity and RAM size. The instance size you select is used for all the data-bearing servers in your cluster. See Create a Cluster
providerSettings.instanceSizeName
for valid values and default resources. - provider
Name String Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- provider
Region StringName - 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. Do not specify this field when creating a multi-region cluster using the replicationSpec document or a Global Cluster with the replicationSpecs array.
- provider
Volume StringType The type of the volume. The possible values are:
STANDARD
andPROVISIONED
.PROVISIONED
is ONLY required if setting IOPS higher than the default instance IOPS.NOTE:
STANDARD
is not available for NVME clusters.- redact
Client BooleanLog Data - Flag that enables or disables log redaction, see the manual for more info. Use this in conjunction with Encryption at Rest and TLS/SSL (Transport Encryption) to assist compliance with regulatory requirements. Note: Changing this setting on a cluster will trigger a rolling restart as soon as the cluster is updated. The log redaction field is updated via an Atlas API call after cluster creation. Consequently, there may be a brief period during resource creation when log redaction is not yet enabled. To ensure complete log redaction from the outset, use
mongodbatlas.AdvancedCluster
. - replication
Factor Integer - Number of replica set members. Each member keeps a copy of your databases, providing high availability and data redundancy. The possible values are 3, 5, or 7. The default value is 3.
- replication
Specs List<ClusterReplication Spec> - Configuration for cluster regions. See Replication Spec below for more details.
- retain
Backups BooleanEnabled - Set to true to retain backup snapshots for the deleted cluster. M10 and above only.
- snapshot
Backup List<ClusterPolicies Snapshot Backup Policy> - current snapshot schedule and retention settings for the cluster.
- srv
Address String - Connection string for connecting to the Atlas cluster. The +srv modifier forces the connection to use TLS/SSL. See the mongoURI for additional options.
- state
Name String - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
- List<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_version
field. 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_reconfig
to the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - advanced
Configuration ClusterAdvanced Configuration - auto
Scaling booleanCompute Enabled - auto
Scaling booleanCompute Scale Down Enabled - Set to
true
to enable the cluster tier to scale down. This option is only available ifautoScaling.compute.enabled
istrue
.- If this option is enabled, you must specify a value for
providerSettings.autoScaling.compute.minInstanceSize
- If this option is enabled, you must specify a value for
- auto
Scaling booleanDisk Gb Enabled - backing
Provider stringName Cloud service provider on which the server for a multi-tenant cluster is provisioned.
This setting is only valid when providerSetting.providerName is TENANT and providerSetting.instanceSizeName is M2 or M5.
The possible values are:
- AWS - Amazon AWS
- GCP - Google Cloud Platform
- AZURE - Microsoft Azure
- backup
Enabled boolean - Legacy Backup - Set to true to enable Atlas legacy backups for the cluster.
Important - MongoDB deprecated the Legacy Backup feature. Clusters that use Legacy Backup can continue to use it. MongoDB recommends using Cloud Backups.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
cloud_backup
, to enable Cloud Backup. If you create a new Atlas cluster and setbackup_enabled
to true, the Provider will respond with an error. This change doesn’t affect existing clusters that use legacy backups. - Setting this value to false to disable legacy backups for the cluster will let Atlas delete any stored snapshots. In order to preserve the legacy backups snapshots, disable the legacy backups and enable the cloud backups in the single pulumi up action.
backup_enabled = "false" cloud_backup = "true"
- The default value is false. M10 and above only.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
- bi
Connector ClusterConfig Bi Connector Config - Specifies BI Connector for Atlas configuration on this cluster. BI Connector for Atlas is only available for M10+ clusters. See BI Connector below for more details.
- cloud
Backup boolean - cluster
Id string - The cluster ID.
- cluster
Type string Specifies the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
WHEN SHOULD YOU USE CLUSTERTYPE? When you set replication_specs, when you are deploying Global Clusters or when you are deploying non-Global replica sets and sharded clusters.
Accepted values include:
REPLICASET
Replica setSHARDED
Sharded clusterGEOSHARDED
Global Cluster
- connection
Strings ClusterConnection 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.
- container
Id string - The Container ID is the id of the container created when the first cluster in the region (AWS/Azure) or project (GCP) was created.
- 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 integer.
- The minimum disk size for dedicated clusters is 10GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value.
- Note: 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.
- Cannot be used with clusters with local NVMe SSDs
- Cannot be used with Azure clusters
- 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 complete documentation on configuring Encryption at Rest, see Encryption at Rest using Customer Key Management. Requires M10 or greater. and for legacy backups, backup_enabled, to be false or omitted. Note: Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default.
- labels
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
tags
instead. - mongo
Db stringMajor Version - Version of the cluster to deploy. Atlas supports all the MongoDB versions that have not reached End of Live for M10+ clusters. If omitted, Atlas deploys the cluster with the default version. For more details, see documentation. Atlas always deploys the cluster with the latest stable release of the specified version. See Release Notes for latest Current Stable Release.
- mongo
Db stringVersion - Version of MongoDB the cluster runs, in
major-version
.minor-version
format. - mongo
Uri string - Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.
- mongo
Uri stringUpdated - Lists when the connection string was last updated. The connection string changes, for example, if you change a replica set to a sharded cluster.
- mongo
Uri stringWith Options - connection string for connecting to the Atlas cluster. Includes the replicaSet, ssl, and authSource query parameters in the connection string with values appropriate for the cluster.
- 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.
- num
Shards number - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- paused boolean
- pit
Enabled boolean - Flag that indicates if the cluster uses Continuous Cloud Backup. If set to true, cloud_backup must also be set to true.
- project
Id string - The unique ID for the project to create the database user.
- provider
Auto stringScaling Compute Max Instance Size - Maximum instance size to which your cluster can automatically scale (e.g., M40). Required if
autoScaling.compute.enabled
istrue
. - provider
Auto stringScaling Compute Min Instance Size - Minimum instance size to which your cluster can automatically scale (e.g., M10). Required if
autoScaling.compute.scaleDownEnabled
istrue
. - provider
Disk numberIops - The maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected
provider_instance_size_name
anddisk_size_gb
. This setting requires thatprovider_instance_size_name
to be M30 or greater and cannot be used with clusters with local NVMe SSDs. The default value forprovider_disk_iops
is the same as the cluster tier's Standard IOPS value, as viewable in the Atlas console. It is used in cases where a higher number of IOPS is needed and possible. If a value is submitted that is lower or equal to the default IOPS value for the cluster tier Atlas ignores the requested value and uses the default. More details available under the providerSettings.diskIOPS parameter: MongoDB API Clusters- You do not need to configure IOPS for a STANDARD disk configuration but only for a PROVISIONED configuration.
- provider
Disk stringType Name - Azure disk type of the server’s root volume. If omitted, Atlas uses the default disk type for the selected providerSettings.instanceSizeName. Example disk types and associated storage sizes: P4 - 32GB, P6 - 64GB, P10 - 128GB, P15 - 256GB, P20 - 512GB, P30 - 1024GB, P40 - 2048GB, P50 - 4095GB. More information and the most update to date disk types/storage sizes can be located at https://docs.atlas.mongodb.com/reference/api/clusters-create-one/.
- provider
Encrypt booleanEbs Volume - (Deprecated) The Flag is always true. Flag that indicates whether the Amazon EBS encryption feature encrypts the host's root volume for both data at rest within the volume and for data moving between the volume and the cluster. Note: This setting is always enabled for clusters with local NVMe SSDs. Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default..
- provider
Encrypt booleanEbs Volume Flag - provider
Instance stringSize Name - Atlas provides different instance sizes, each with a default storage capacity and RAM size. The instance size you select is used for all the data-bearing servers in your cluster. See Create a Cluster
providerSettings.instanceSizeName
for valid values and default resources. - provider
Name string Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- provider
Region stringName - 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. Do not specify this field when creating a multi-region cluster using the replicationSpec document or a Global Cluster with the replicationSpecs array.
- provider
Volume stringType The type of the volume. The possible values are:
STANDARD
andPROVISIONED
.PROVISIONED
is ONLY required if setting IOPS higher than the default instance IOPS.NOTE:
STANDARD
is not available for NVME clusters.- redact
Client booleanLog Data - Flag that enables or disables log redaction, see the manual for more info. Use this in conjunction with Encryption at Rest and TLS/SSL (Transport Encryption) to assist compliance with regulatory requirements. Note: Changing this setting on a cluster will trigger a rolling restart as soon as the cluster is updated. The log redaction field is updated via an Atlas API call after cluster creation. Consequently, there may be a brief period during resource creation when log redaction is not yet enabled. To ensure complete log redaction from the outset, use
mongodbatlas.AdvancedCluster
. - replication
Factor number - Number of replica set members. Each member keeps a copy of your databases, providing high availability and data redundancy. The possible values are 3, 5, or 7. The default value is 3.
- replication
Specs ClusterReplication Spec[] - Configuration for cluster regions. See Replication Spec below for more details.
- retain
Backups booleanEnabled - Set to true to retain backup snapshots for the deleted cluster. M10 and above only.
- snapshot
Backup ClusterPolicies Snapshot Backup Policy[] - current snapshot schedule and retention settings for the cluster.
- srv
Address string - Connection string for connecting to the Atlas cluster. The +srv modifier forces the connection to use TLS/SSL. See the mongoURI for additional options.
- state
Name string - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
- 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_version
field. 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_reconfig
to the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - advanced_
configuration ClusterAdvanced Configuration Args - auto_
scaling_ boolcompute_ enabled - auto_
scaling_ boolcompute_ scale_ down_ enabled - Set to
true
to enable the cluster tier to scale down. This option is only available ifautoScaling.compute.enabled
istrue
.- If this option is enabled, you must specify a value for
providerSettings.autoScaling.compute.minInstanceSize
- If this option is enabled, you must specify a value for
- auto_
scaling_ booldisk_ gb_ enabled - backing_
provider_ strname Cloud service provider on which the server for a multi-tenant cluster is provisioned.
This setting is only valid when providerSetting.providerName is TENANT and providerSetting.instanceSizeName is M2 or M5.
The possible values are:
- AWS - Amazon AWS
- GCP - Google Cloud Platform
- AZURE - Microsoft Azure
- backup_
enabled bool - Legacy Backup - Set to true to enable Atlas legacy backups for the cluster.
Important - MongoDB deprecated the Legacy Backup feature. Clusters that use Legacy Backup can continue to use it. MongoDB recommends using Cloud Backups.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
cloud_backup
, to enable Cloud Backup. If you create a new Atlas cluster and setbackup_enabled
to true, the Provider will respond with an error. This change doesn’t affect existing clusters that use legacy backups. - Setting this value to false to disable legacy backups for the cluster will let Atlas delete any stored snapshots. In order to preserve the legacy backups snapshots, disable the legacy backups and enable the cloud backups in the single pulumi up action.
backup_enabled = "false" cloud_backup = "true"
- The default value is false. M10 and above only.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
- bi_
connector_ Clusterconfig Bi Connector Config Args - Specifies BI Connector for Atlas configuration on this cluster. BI Connector for Atlas is only available for M10+ clusters. See BI Connector below for more details.
- cloud_
backup bool - cluster_
id str - The cluster ID.
- cluster_
type str Specifies the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
WHEN SHOULD YOU USE CLUSTERTYPE? When you set replication_specs, when you are deploying Global Clusters or when you are deploying non-Global replica sets and sharded clusters.
Accepted values include:
REPLICASET
Replica setSHARDED
Sharded clusterGEOSHARDED
Global Cluster
- connection_
strings Sequence[ClusterConnection 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.
- container_
id str - The Container ID is the id of the container created when the first cluster in the region (AWS/Azure) or project (GCP) was created.
- 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 integer.
- The minimum disk size for dedicated clusters is 10GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value.
- Note: 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.
- Cannot be used with clusters with local NVMe SSDs
- Cannot be used with Azure clusters
- 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 complete documentation on configuring Encryption at Rest, see Encryption at Rest using Customer Key Management. Requires M10 or greater. and for legacy backups, backup_enabled, to be false or omitted. Note: Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default.
- labels
Sequence[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
tags
instead. - mongo_
db_ strmajor_ version - Version of the cluster to deploy. Atlas supports all the MongoDB versions that have not reached End of Live for M10+ clusters. If omitted, Atlas deploys the cluster with the default version. For more details, see documentation. Atlas always deploys the cluster with the latest stable release of the specified version. See Release Notes for latest Current Stable Release.
- mongo_
db_ strversion - Version of MongoDB the cluster runs, in
major-version
.minor-version
format. - mongo_
uri str - Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.
- mongo_
uri_ strupdated - Lists when the connection string was last updated. The connection string changes, for example, if you change a replica set to a sharded cluster.
- mongo_
uri_ strwith_ options - connection string for connecting to the Atlas cluster. Includes the replicaSet, ssl, and authSource query parameters in the connection string with values appropriate for the cluster.
- 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.
- num_
shards int - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- paused bool
- pit_
enabled bool - Flag that indicates if the cluster uses Continuous Cloud Backup. If set to true, cloud_backup must also be set to true.
- project_
id str - The unique ID for the project to create the database user.
- provider_
auto_ strscaling_ compute_ max_ instance_ size - Maximum instance size to which your cluster can automatically scale (e.g., M40). Required if
autoScaling.compute.enabled
istrue
. - provider_
auto_ strscaling_ compute_ min_ instance_ size - Minimum instance size to which your cluster can automatically scale (e.g., M10). Required if
autoScaling.compute.scaleDownEnabled
istrue
. - provider_
disk_ intiops - The maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected
provider_instance_size_name
anddisk_size_gb
. This setting requires thatprovider_instance_size_name
to be M30 or greater and cannot be used with clusters with local NVMe SSDs. The default value forprovider_disk_iops
is the same as the cluster tier's Standard IOPS value, as viewable in the Atlas console. It is used in cases where a higher number of IOPS is needed and possible. If a value is submitted that is lower or equal to the default IOPS value for the cluster tier Atlas ignores the requested value and uses the default. More details available under the providerSettings.diskIOPS parameter: MongoDB API Clusters- You do not need to configure IOPS for a STANDARD disk configuration but only for a PROVISIONED configuration.
- provider_
disk_ strtype_ name - Azure disk type of the server’s root volume. If omitted, Atlas uses the default disk type for the selected providerSettings.instanceSizeName. Example disk types and associated storage sizes: P4 - 32GB, P6 - 64GB, P10 - 128GB, P15 - 256GB, P20 - 512GB, P30 - 1024GB, P40 - 2048GB, P50 - 4095GB. More information and the most update to date disk types/storage sizes can be located at https://docs.atlas.mongodb.com/reference/api/clusters-create-one/.
- provider_
encrypt_ boolebs_ volume - (Deprecated) The Flag is always true. Flag that indicates whether the Amazon EBS encryption feature encrypts the host's root volume for both data at rest within the volume and for data moving between the volume and the cluster. Note: This setting is always enabled for clusters with local NVMe SSDs. Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default..
- provider_
encrypt_ boolebs_ volume_ flag - provider_
instance_ strsize_ name - Atlas provides different instance sizes, each with a default storage capacity and RAM size. The instance size you select is used for all the data-bearing servers in your cluster. See Create a Cluster
providerSettings.instanceSizeName
for valid values and default resources. - provider_
name str Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- provider_
region_ strname - 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. Do not specify this field when creating a multi-region cluster using the replicationSpec document or a Global Cluster with the replicationSpecs array.
- provider_
volume_ strtype The type of the volume. The possible values are:
STANDARD
andPROVISIONED
.PROVISIONED
is ONLY required if setting IOPS higher than the default instance IOPS.NOTE:
STANDARD
is not available for NVME clusters.- redact_
client_ boollog_ data - Flag that enables or disables log redaction, see the manual for more info. Use this in conjunction with Encryption at Rest and TLS/SSL (Transport Encryption) to assist compliance with regulatory requirements. Note: Changing this setting on a cluster will trigger a rolling restart as soon as the cluster is updated. The log redaction field is updated via an Atlas API call after cluster creation. Consequently, there may be a brief period during resource creation when log redaction is not yet enabled. To ensure complete log redaction from the outset, use
mongodbatlas.AdvancedCluster
. - replication_
factor int - Number of replica set members. Each member keeps a copy of your databases, providing high availability and data redundancy. The possible values are 3, 5, or 7. The default value is 3.
- replication_
specs Sequence[ClusterReplication Spec Args] - Configuration for cluster regions. See Replication Spec below for more details.
- retain_
backups_ boolenabled - Set to true to retain backup snapshots for the deleted cluster. M10 and above only.
- snapshot_
backup_ Sequence[Clusterpolicies Snapshot Backup Policy Args] - current snapshot schedule and retention settings for the cluster.
- srv_
address str - Connection string for connecting to the Atlas cluster. The +srv modifier forces the connection to use TLS/SSL. See the mongoURI for additional options.
- state_
name str - Current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
- Sequence[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_version
field. 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_reconfig
to the current date. Learn more about Reconfiguring a Replica Set during a regional outage here. - advanced
Configuration Property Map - auto
Scaling BooleanCompute Enabled - auto
Scaling BooleanCompute Scale Down Enabled - Set to
true
to enable the cluster tier to scale down. This option is only available ifautoScaling.compute.enabled
istrue
.- If this option is enabled, you must specify a value for
providerSettings.autoScaling.compute.minInstanceSize
- If this option is enabled, you must specify a value for
- auto
Scaling BooleanDisk Gb Enabled - backing
Provider StringName Cloud service provider on which the server for a multi-tenant cluster is provisioned.
This setting is only valid when providerSetting.providerName is TENANT and providerSetting.instanceSizeName is M2 or M5.
The possible values are:
- AWS - Amazon AWS
- GCP - Google Cloud Platform
- AZURE - Microsoft Azure
- backup
Enabled Boolean - Legacy Backup - Set to true to enable Atlas legacy backups for the cluster.
Important - MongoDB deprecated the Legacy Backup feature. Clusters that use Legacy Backup can continue to use it. MongoDB recommends using Cloud Backups.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
cloud_backup
, to enable Cloud Backup. If you create a new Atlas cluster and setbackup_enabled
to true, the Provider will respond with an error. This change doesn’t affect existing clusters that use legacy backups. - Setting this value to false to disable legacy backups for the cluster will let Atlas delete any stored snapshots. In order to preserve the legacy backups snapshots, disable the legacy backups and enable the cloud backups in the single pulumi up action.
backup_enabled = "false" cloud_backup = "true"
- The default value is false. M10 and above only.
- New Atlas clusters of any type do not support this parameter. These clusters must use Cloud Backup,
- bi
Connector Property MapConfig - Specifies BI Connector for Atlas configuration on this cluster. BI Connector for Atlas is only available for M10+ clusters. See BI Connector below for more details.
- cloud
Backup Boolean - cluster
Id String - The cluster ID.
- cluster
Type String Specifies the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
WHEN SHOULD YOU USE CLUSTERTYPE? When you set replication_specs, when you are deploying Global Clusters or when you are deploying non-Global replica sets and sharded clusters.
Accepted values include:
REPLICASET
Replica setSHARDED
Sharded clusterGEOSHARDED
Global 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.
- container
Id String - The Container ID is the id of the container created when the first cluster in the region (AWS/Azure) or project (GCP) was created.
- 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 integer.
- The minimum disk size for dedicated clusters is 10GB for AWS and GCP. If you specify diskSizeGB with a lower disk size, Atlas defaults to the minimum disk size value.
- Note: 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.
- Cannot be used with clusters with local NVMe SSDs
- Cannot be used with Azure clusters
- 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 complete documentation on configuring Encryption at Rest, see Encryption at Rest using Customer Key Management. Requires M10 or greater. and for legacy backups, backup_enabled, to be false or omitted. Note: Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default.
- 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
tags
instead. - mongo
Db StringMajor Version - Version of the cluster to deploy. Atlas supports all the MongoDB versions that have not reached End of Live for M10+ clusters. If omitted, Atlas deploys the cluster with the default version. For more details, see documentation. Atlas always deploys the cluster with the latest stable release of the specified version. See Release Notes for latest Current Stable Release.
- mongo
Db StringVersion - Version of MongoDB the cluster runs, in
major-version
.minor-version
format. - mongo
Uri String - Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.
- mongo
Uri StringUpdated - Lists when the connection string was last updated. The connection string changes, for example, if you change a replica set to a sharded cluster.
- mongo
Uri StringWith Options - connection string for connecting to the Atlas cluster. Includes the replicaSet, ssl, and authSource query parameters in the connection string with values appropriate for the cluster.
- 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.
- num
Shards Number - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- paused Boolean
- pit
Enabled Boolean - Flag that indicates if the cluster uses Continuous Cloud Backup. If set to true, cloud_backup must also be set to true.
- project
Id String - The unique ID for the project to create the database user.
- provider
Auto StringScaling Compute Max Instance Size - Maximum instance size to which your cluster can automatically scale (e.g., M40). Required if
autoScaling.compute.enabled
istrue
. - provider
Auto StringScaling Compute Min Instance Size - Minimum instance size to which your cluster can automatically scale (e.g., M10). Required if
autoScaling.compute.scaleDownEnabled
istrue
. - provider
Disk NumberIops - The maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected
provider_instance_size_name
anddisk_size_gb
. This setting requires thatprovider_instance_size_name
to be M30 or greater and cannot be used with clusters with local NVMe SSDs. The default value forprovider_disk_iops
is the same as the cluster tier's Standard IOPS value, as viewable in the Atlas console. It is used in cases where a higher number of IOPS is needed and possible. If a value is submitted that is lower or equal to the default IOPS value for the cluster tier Atlas ignores the requested value and uses the default. More details available under the providerSettings.diskIOPS parameter: MongoDB API Clusters- You do not need to configure IOPS for a STANDARD disk configuration but only for a PROVISIONED configuration.
- provider
Disk StringType Name - Azure disk type of the server’s root volume. If omitted, Atlas uses the default disk type for the selected providerSettings.instanceSizeName. Example disk types and associated storage sizes: P4 - 32GB, P6 - 64GB, P10 - 128GB, P15 - 256GB, P20 - 512GB, P30 - 1024GB, P40 - 2048GB, P50 - 4095GB. More information and the most update to date disk types/storage sizes can be located at https://docs.atlas.mongodb.com/reference/api/clusters-create-one/.
- provider
Encrypt BooleanEbs Volume - (Deprecated) The Flag is always true. Flag that indicates whether the Amazon EBS encryption feature encrypts the host's root volume for both data at rest within the volume and for data moving between the volume and the cluster. Note: This setting is always enabled for clusters with local NVMe SSDs. Atlas encrypts all cluster storage and snapshot volumes, securing all cluster data on disk: a concept known as encryption at rest, by default..
- provider
Encrypt BooleanEbs Volume Flag - provider
Instance StringSize Name - Atlas provides different instance sizes, each with a default storage capacity and RAM size. The instance size you select is used for all the data-bearing servers in your cluster. See Create a Cluster
providerSettings.instanceSizeName
for valid values and default resources. - provider
Name String Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- provider
Region StringName - 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. Do not specify this field when creating a multi-region cluster using the replicationSpec document or a Global Cluster with the replicationSpecs array.
- provider
Volume StringType The type of the volume. The possible values are:
STANDARD
andPROVISIONED
.PROVISIONED
is ONLY required if setting IOPS higher than the default instance IOPS.NOTE:
STANDARD
is not available for NVME clusters.- redact
Client BooleanLog Data - Flag that enables or disables log redaction, see the manual for more info. Use this in conjunction with Encryption at Rest and TLS/SSL (Transport Encryption) to assist compliance with regulatory requirements. Note: Changing this setting on a cluster will trigger a rolling restart as soon as the cluster is updated. The log redaction field is updated via an Atlas API call after cluster creation. Consequently, there may be a brief period during resource creation when log redaction is not yet enabled. To ensure complete log redaction from the outset, use
mongodbatlas.AdvancedCluster
. - replication
Factor Number - Number of replica set members. Each member keeps a copy of your databases, providing high availability and data redundancy. The possible values are 3, 5, or 7. The default value is 3.
- replication
Specs List<Property Map> - Configuration for cluster regions. See Replication Spec below for more details.
- retain
Backups BooleanEnabled - Set to true to retain backup snapshots for the deleted cluster. M10 and above only.
- snapshot
Backup List<Property Map>Policies - current snapshot schedule and retention settings for the cluster.
- srv
Address String - Connection string for connecting to the Atlas cluster. The +srv modifier forces the connection to use TLS/SSL. See the mongoURI for additional options.
- 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_version
field. 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
ClusterAdvancedConfiguration, ClusterAdvancedConfigurationArgs
- Change
Stream intOptions Pre And Post Images Expire After Seconds - The minimum pre- and post-image retention time in seconds. This option corresponds to the
changeStreamOptions.preAndPostImages.expireAfterSeconds
cluster parameter. Defaults to-1
(off). This setting controls the retention policy of change stream pre- and post-images. Pre- and post-images are the versions of a document before and after document modification, respectively.expireAfterSeconds
controls how long MongoDB retains pre- and post-images. When set to -1 (off), MongoDB uses the default retention policy: pre- and post-images are retained until the corresponding change stream events are removed from the oplog. To set the minimum pre- and post-image retention time, specify an integer value greater than zero. Setting this too low could increase the risk of interrupting Realm sync or triggers processing. This parameter is only supported for MongoDB version 6.0 and above. - Default
Read stringConcern - Default level of acknowledgment requested from MongoDB for read operations set for this cluster. MongoDB 4.4 clusters default to available.
- Default
Write stringConcern - Default level of acknowledgment requested from MongoDB for write operations set for this cluster. MongoDB 4.4 clusters default to 1.
- Fail
Index boolKey Too Long - When true, documents can only be updated or inserted if, for all indexed fields on the target collection, the corresponding index entries do not exceed 1024 bytes. When false, mongod writes documents that exceed the limit but does not index them.
- Javascript
Enabled bool - When true, the cluster allows execution of operations that perform server-side executions of JavaScript. When false, the cluster disables execution of those operations.
- Minimum
Enabled stringTls Protocol - Sets the minimum Transport Layer Security (TLS) version the cluster accepts for incoming connections.Valid values are:
- TLS1_0
- TLS1_1
- TLS1_2
- No
Table boolScan - When true, the cluster disables the execution of any query that requires a collection scan to return results. When false, the cluster allows the execution of those operations.
- Oplog
Min doubleRetention Hours - Minimum retention window for cluster's oplog expressed in hours. A value of null indicates that the cluster uses the default minimum oplog window that MongoDB Cloud calculates.
- Note A minimum oplog retention is required when seeking to change a cluster's class to Local NVMe SSD. To learn more and for latest guidance see
oplogMinRetentionHours
- Note A minimum oplog retention is required when seeking to change a cluster's class to Local NVMe SSD. To learn more and for latest guidance see
- Oplog
Size intMb - The custom oplog size of the cluster. Without a value that indicates that the cluster uses the default oplog size calculated by Atlas.
- Sample
Refresh intInterval Bi Connector - Interval in seconds at which the mongosqld process re-samples data to create its relational schema. The default value is 300. The specified value must be a positive integer. Available only for Atlas deployments in which BI Connector for Atlas is enabled.
- Sample
Size intBi Connector - Number of documents per database to sample when gathering schema information. Defaults to 100. Available only for Atlas deployments in which BI Connector for Atlas is enabled.
- Transaction
Lifetime intLimit Seconds - Lifetime, in seconds, of multi-document transactions. Defaults to 60 seconds.
- Change
Stream intOptions Pre And Post Images Expire After Seconds - The minimum pre- and post-image retention time in seconds. This option corresponds to the
changeStreamOptions.preAndPostImages.expireAfterSeconds
cluster parameter. Defaults to-1
(off). This setting controls the retention policy of change stream pre- and post-images. Pre- and post-images are the versions of a document before and after document modification, respectively.expireAfterSeconds
controls how long MongoDB retains pre- and post-images. When set to -1 (off), MongoDB uses the default retention policy: pre- and post-images are retained until the corresponding change stream events are removed from the oplog. To set the minimum pre- and post-image retention time, specify an integer value greater than zero. Setting this too low could increase the risk of interrupting Realm sync or triggers processing. This parameter is only supported for MongoDB version 6.0 and above. - Default
Read stringConcern - Default level of acknowledgment requested from MongoDB for read operations set for this cluster. MongoDB 4.4 clusters default to available.
- Default
Write stringConcern - Default level of acknowledgment requested from MongoDB for write operations set for this cluster. MongoDB 4.4 clusters default to 1.
- Fail
Index boolKey Too Long - When true, documents can only be updated or inserted if, for all indexed fields on the target collection, the corresponding index entries do not exceed 1024 bytes. When false, mongod writes documents that exceed the limit but does not index them.
- Javascript
Enabled bool - When true, the cluster allows execution of operations that perform server-side executions of JavaScript. When false, the cluster disables execution of those operations.
- Minimum
Enabled stringTls Protocol - Sets the minimum Transport Layer Security (TLS) version the cluster accepts for incoming connections.Valid values are:
- TLS1_0
- TLS1_1
- TLS1_2
- No
Table boolScan - When true, the cluster disables the execution of any query that requires a collection scan to return results. When false, the cluster allows the execution of those operations.
- Oplog
Min float64Retention Hours - Minimum retention window for cluster's oplog expressed in hours. A value of null indicates that the cluster uses the default minimum oplog window that MongoDB Cloud calculates.
- Note A minimum oplog retention is required when seeking to change a cluster's class to Local NVMe SSD. To learn more and for latest guidance see
oplogMinRetentionHours
- Note A minimum oplog retention is required when seeking to change a cluster's class to Local NVMe SSD. To learn more and for latest guidance see
- Oplog
Size intMb - The custom oplog size of the cluster. Without a value that indicates that the cluster uses the default oplog size calculated by Atlas.
- Sample
Refresh intInterval Bi Connector - Interval in seconds at which the mongosqld process re-samples data to create its relational schema. The default value is 300. The specified value must be a positive integer. Available only for Atlas deployments in which BI Connector for Atlas is enabled.
- Sample
Size intBi Connector - Number of documents per database to sample when gathering schema information. Defaults to 100. Available only for Atlas deployments in which BI Connector for Atlas is enabled.
- Transaction
Lifetime intLimit Seconds - Lifetime, in seconds, of multi-document transactions. Defaults to 60 seconds.
- change
Stream IntegerOptions Pre And Post Images Expire After Seconds - The minimum pre- and post-image retention time in seconds. This option corresponds to the
changeStreamOptions.preAndPostImages.expireAfterSeconds
cluster parameter. Defaults to-1
(off). This setting controls the retention policy of change stream pre- and post-images. Pre- and post-images are the versions of a document before and after document modification, respectively.expireAfterSeconds
controls how long MongoDB retains pre- and post-images. When set to -1 (off), MongoDB uses the default retention policy: pre- and post-images are retained until the corresponding change stream events are removed from the oplog. To set the minimum pre- and post-image retention time, specify an integer value greater than zero. Setting this too low could increase the risk of interrupting Realm sync or triggers processing. This parameter is only supported for MongoDB version 6.0 and above. - default
Read StringConcern - Default level of acknowledgment requested from MongoDB for read operations set for this cluster. MongoDB 4.4 clusters default to available.
- default
Write StringConcern - Default level of acknowledgment requested from MongoDB for write operations set for this cluster. MongoDB 4.4 clusters default to 1.
- fail
Index BooleanKey Too Long - When true, documents can only be updated or inserted if, for all indexed fields on the target collection, the corresponding index entries do not exceed 1024 bytes. When false, mongod writes documents that exceed the limit but does not index them.
- javascript
Enabled Boolean - When true, the cluster allows execution of operations that perform server-side executions of JavaScript. When false, the cluster disables execution of those operations.
- minimum
Enabled StringTls Protocol - Sets the minimum Transport Layer Security (TLS) version the cluster accepts for incoming connections.Valid values are:
- TLS1_0
- TLS1_1
- TLS1_2
- no
Table BooleanScan - When true, the cluster disables the execution of any query that requires a collection scan to return results. When false, the cluster allows the execution of those operations.
- oplog
Min DoubleRetention Hours - Minimum retention window for cluster's oplog expressed in hours. A value of null indicates that the cluster uses the default minimum oplog window that MongoDB Cloud calculates.
- Note A minimum oplog retention is required when seeking to change a cluster's class to Local NVMe SSD. To learn more and for latest guidance see
oplogMinRetentionHours
- Note A minimum oplog retention is required when seeking to change a cluster's class to Local NVMe SSD. To learn more and for latest guidance see
- oplog
Size IntegerMb - The custom oplog size of the cluster. Without a value that indicates that the cluster uses the default oplog size calculated by Atlas.
- sample
Refresh IntegerInterval Bi Connector - Interval in seconds at which the mongosqld process re-samples data to create its relational schema. The default value is 300. The specified value must be a positive integer. Available only for Atlas deployments in which BI Connector for Atlas is enabled.
- sample
Size IntegerBi Connector - Number of documents per database to sample when gathering schema information. Defaults to 100. Available only for Atlas deployments in which BI Connector for Atlas is enabled.
- transaction
Lifetime IntegerLimit Seconds - Lifetime, in seconds, of multi-document transactions. Defaults to 60 seconds.
- change
Stream numberOptions Pre And Post Images Expire After Seconds - The minimum pre- and post-image retention time in seconds. This option corresponds to the
changeStreamOptions.preAndPostImages.expireAfterSeconds
cluster parameter. Defaults to-1
(off). This setting controls the retention policy of change stream pre- and post-images. Pre- and post-images are the versions of a document before and after document modification, respectively.expireAfterSeconds
controls how long MongoDB retains pre- and post-images. When set to -1 (off), MongoDB uses the default retention policy: pre- and post-images are retained until the corresponding change stream events are removed from the oplog. To set the minimum pre- and post-image retention time, specify an integer value greater than zero. Setting this too low could increase the risk of interrupting Realm sync or triggers processing. This parameter is only supported for MongoDB version 6.0 and above. - default
Read stringConcern - Default level of acknowledgment requested from MongoDB for read operations set for this cluster. MongoDB 4.4 clusters default to available.
- default
Write stringConcern - Default level of acknowledgment requested from MongoDB for write operations set for this cluster. MongoDB 4.4 clusters default to 1.
- fail
Index booleanKey Too Long - When true, documents can only be updated or inserted if, for all indexed fields on the target collection, the corresponding index entries do not exceed 1024 bytes. When false, mongod writes documents that exceed the limit but does not index them.
- javascript
Enabled boolean - When true, the cluster allows execution of operations that perform server-side executions of JavaScript. When false, the cluster disables execution of those operations.
- minimum
Enabled stringTls Protocol - Sets the minimum Transport Layer Security (TLS) version the cluster accepts for incoming connections.Valid values are:
- TLS1_0
- TLS1_1
- TLS1_2
- no
Table booleanScan - When true, the cluster disables the execution of any query that requires a collection scan to return results. When false, the cluster allows the execution of those operations.
- oplog
Min numberRetention Hours - Minimum retention window for cluster's oplog expressed in hours. A value of null indicates that the cluster uses the default minimum oplog window that MongoDB Cloud calculates.
- Note A minimum oplog retention is required when seeking to change a cluster's class to Local NVMe SSD. To learn more and for latest guidance see
oplogMinRetentionHours
- Note A minimum oplog retention is required when seeking to change a cluster's class to Local NVMe SSD. To learn more and for latest guidance see
- oplog
Size numberMb - The custom oplog size of the cluster. Without a value that indicates that the cluster uses the default oplog size calculated by Atlas.
- sample
Refresh numberInterval Bi Connector - Interval in seconds at which the mongosqld process re-samples data to create its relational schema. The default value is 300. The specified value must be a positive integer. Available only for Atlas deployments in which BI Connector for Atlas is enabled.
- sample
Size numberBi Connector - Number of documents per database to sample when gathering schema information. Defaults to 100. Available only for Atlas deployments in which BI Connector for Atlas is enabled.
- transaction
Lifetime numberLimit Seconds - Lifetime, in seconds, of multi-document transactions. Defaults to 60 seconds.
- change_
stream_ intoptions_ pre_ and_ post_ images_ expire_ after_ seconds - The minimum pre- and post-image retention time in seconds. This option corresponds to the
changeStreamOptions.preAndPostImages.expireAfterSeconds
cluster parameter. Defaults to-1
(off). This setting controls the retention policy of change stream pre- and post-images. Pre- and post-images are the versions of a document before and after document modification, respectively.expireAfterSeconds
controls how long MongoDB retains pre- and post-images. When set to -1 (off), MongoDB uses the default retention policy: pre- and post-images are retained until the corresponding change stream events are removed from the oplog. To set the minimum pre- and post-image retention time, specify an integer value greater than zero. Setting this too low could increase the risk of interrupting Realm sync or triggers processing. This parameter is only supported for MongoDB version 6.0 and above. - default_
read_ strconcern - Default level of acknowledgment requested from MongoDB for read operations set for this cluster. MongoDB 4.4 clusters default to available.
- default_
write_ strconcern - Default level of acknowledgment requested from MongoDB for write operations set for this cluster. MongoDB 4.4 clusters default to 1.
- fail_
index_ boolkey_ too_ long - When true, documents can only be updated or inserted if, for all indexed fields on the target collection, the corresponding index entries do not exceed 1024 bytes. When false, mongod writes documents that exceed the limit but does not index them.
- javascript_
enabled bool - When true, the cluster allows execution of operations that perform server-side executions of JavaScript. When false, the cluster disables execution of those operations.
- minimum_
enabled_ strtls_ protocol - Sets the minimum Transport Layer Security (TLS) version the cluster accepts for incoming connections.Valid values are:
- TLS1_0
- TLS1_1
- TLS1_2
- no_
table_ boolscan - When true, the cluster disables the execution of any query that requires a collection scan to return results. When false, the cluster allows the execution of those operations.
- oplog_
min_ floatretention_ hours - Minimum retention window for cluster's oplog expressed in hours. A value of null indicates that the cluster uses the default minimum oplog window that MongoDB Cloud calculates.
- Note A minimum oplog retention is required when seeking to change a cluster's class to Local NVMe SSD. To learn more and for latest guidance see
oplogMinRetentionHours
- Note A minimum oplog retention is required when seeking to change a cluster's class to Local NVMe SSD. To learn more and for latest guidance see
- oplog_
size_ intmb - The custom oplog size of the cluster. Without a value that indicates that the cluster uses the default oplog size calculated by Atlas.
- sample_
refresh_ intinterval_ bi_ connector - Interval in seconds at which the mongosqld process re-samples data to create its relational schema. The default value is 300. The specified value must be a positive integer. Available only for Atlas deployments in which BI Connector for Atlas is enabled.
- sample_
size_ intbi_ connector - Number of documents per database to sample when gathering schema information. Defaults to 100. Available only for Atlas deployments in which BI Connector for Atlas is enabled.
- transaction_
lifetime_ intlimit_ seconds - Lifetime, in seconds, of multi-document transactions. Defaults to 60 seconds.
- change
Stream NumberOptions Pre And Post Images Expire After Seconds - The minimum pre- and post-image retention time in seconds. This option corresponds to the
changeStreamOptions.preAndPostImages.expireAfterSeconds
cluster parameter. Defaults to-1
(off). This setting controls the retention policy of change stream pre- and post-images. Pre- and post-images are the versions of a document before and after document modification, respectively.expireAfterSeconds
controls how long MongoDB retains pre- and post-images. When set to -1 (off), MongoDB uses the default retention policy: pre- and post-images are retained until the corresponding change stream events are removed from the oplog. To set the minimum pre- and post-image retention time, specify an integer value greater than zero. Setting this too low could increase the risk of interrupting Realm sync or triggers processing. This parameter is only supported for MongoDB version 6.0 and above. - default
Read StringConcern - Default level of acknowledgment requested from MongoDB for read operations set for this cluster. MongoDB 4.4 clusters default to available.
- default
Write StringConcern - Default level of acknowledgment requested from MongoDB for write operations set for this cluster. MongoDB 4.4 clusters default to 1.
- fail
Index BooleanKey Too Long - When true, documents can only be updated or inserted if, for all indexed fields on the target collection, the corresponding index entries do not exceed 1024 bytes. When false, mongod writes documents that exceed the limit but does not index them.
- javascript
Enabled Boolean - When true, the cluster allows execution of operations that perform server-side executions of JavaScript. When false, the cluster disables execution of those operations.
- minimum
Enabled StringTls Protocol - Sets the minimum Transport Layer Security (TLS) version the cluster accepts for incoming connections.Valid values are:
- TLS1_0
- TLS1_1
- TLS1_2
- no
Table BooleanScan - When true, the cluster disables the execution of any query that requires a collection scan to return results. When false, the cluster allows the execution of those operations.
- oplog
Min NumberRetention Hours - Minimum retention window for cluster's oplog expressed in hours. A value of null indicates that the cluster uses the default minimum oplog window that MongoDB Cloud calculates.
- Note A minimum oplog retention is required when seeking to change a cluster's class to Local NVMe SSD. To learn more and for latest guidance see
oplogMinRetentionHours
- Note A minimum oplog retention is required when seeking to change a cluster's class to Local NVMe SSD. To learn more and for latest guidance see
- oplog
Size NumberMb - The custom oplog size of the cluster. Without a value that indicates that the cluster uses the default oplog size calculated by Atlas.
- sample
Refresh NumberInterval Bi Connector - Interval in seconds at which the mongosqld process re-samples data to create its relational schema. The default value is 300. The specified value must be a positive integer. Available only for Atlas deployments in which BI Connector for Atlas is enabled.
- sample
Size NumberBi Connector - Number of documents per database to sample when gathering schema information. Defaults to 100. Available only for Atlas deployments in which BI Connector for Atlas is enabled.
- transaction
Lifetime NumberLimit Seconds - Lifetime, in seconds, of multi-document transactions. Defaults to 60 seconds.
ClusterBiConnectorConfig, ClusterBiConnectorConfigArgs
- Enabled bool
- Specifies whether or not BI Connector for Atlas is enabled on the cluster.l
*
- Set to
true
to enable BI Connector for Atlas. - Set to
false
to 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
true
to enable BI Connector for Atlas. - Set to
false
to 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
true
to enable BI Connector for Atlas. - Set to
false
to 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
true
to enable BI Connector for Atlas. - Set to
false
to 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
true
to enable BI Connector for Atlas. - Set to
false
to 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
true
to enable BI Connector for Atlas. - Set to
false
to 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.
ClusterConnectionString, ClusterConnectionStringArgs
- 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<ClusterConnection 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+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, useconnection_strings.private_endpoint[n].connection_string
connection_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 returnsMONGOD
for replica sets, orMONGOS
for sharded clusters.connection_strings.private_endpoint.#.endpoints
- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[n].connection_string
orconnection_strings.private_endpoint[n].srv_connection_string
connection_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 returnsAWS
orAZURE
.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 []ClusterConnection 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+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, useconnection_strings.private_endpoint[n].connection_string
connection_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 returnsMONGOD
for replica sets, orMONGOS
for sharded clusters.connection_strings.private_endpoint.#.endpoints
- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[n].connection_string
orconnection_strings.private_endpoint[n].srv_connection_string
connection_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 returnsAWS
orAZURE
.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<ClusterConnection 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+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, useconnection_strings.private_endpoint[n].connection_string
connection_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 returnsMONGOD
for replica sets, orMONGOS
for sharded clusters.connection_strings.private_endpoint.#.endpoints
- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[n].connection_string
orconnection_strings.private_endpoint[n].srv_connection_string
connection_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 returnsAWS
orAZURE
.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 ClusterConnection 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+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, useconnection_strings.private_endpoint[n].connection_string
connection_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 returnsMONGOD
for replica sets, orMONGOS
for sharded clusters.connection_strings.private_endpoint.#.endpoints
- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[n].connection_string
orconnection_strings.private_endpoint[n].srv_connection_string
connection_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 returnsAWS
orAZURE
.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[ClusterConnection 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+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, useconnection_strings.private_endpoint[n].connection_string
connection_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 returnsMONGOD
for replica sets, orMONGOS
for sharded clusters.connection_strings.private_endpoint.#.endpoints
- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[n].connection_string
orconnection_strings.private_endpoint[n].srv_connection_string
connection_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 returnsAWS
orAZURE
.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+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, useconnection_strings.private_endpoint[n].connection_string
connection_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 returnsMONGOD
for replica sets, orMONGOS
for sharded clusters.connection_strings.private_endpoint.#.endpoints
- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[n].connection_string
orconnection_strings.private_endpoint[n].srv_connection_string
connection_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 returnsAWS
orAZURE
.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.
ClusterConnectionStringPrivateEndpoint, ClusterConnectionStringPrivateEndpointArgs
- connection
String String - endpoints List<Property Map>
- srv
Connection StringString - srv
Shard StringOptimized Connection String - type String
ClusterConnectionStringPrivateEndpointEndpoint, ClusterConnectionStringPrivateEndpointEndpointArgs
- Endpoint
Id string - Provider
Name string Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- Region string
- Endpoint
Id string - Provider
Name string Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- Region string
- endpoint
Id String - provider
Name String Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- region String
- endpoint
Id string - provider
Name string Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- region string
- endpoint_
id str - provider_
name str Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- region str
- endpoint
Id String - provider
Name String Cloud service provider on which the servers are provisioned.
The possible values are:
AWS
- Amazon AWSGCP
- Google Cloud PlatformAZURE
- Microsoft AzureTENANT
- A multi-tenant deployment on one of the supported cloud service providers. Only valid when providerSettings.instanceSizeName is either M2 or M5.
- region String
ClusterLabel, ClusterLabelArgs
ClusterReplicationSpec, ClusterReplicationSpecArgs
- Num
Shards int - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- Id string
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- Regions
Configs List<ClusterReplication Spec Regions Config> - Physical location of the region. Each regionsConfig document describes the region’s priority in elections and the number and type of MongoDB nodes Atlas deploys to the region. You must order each regionsConfigs document by regionsConfig.priority, descending. See Region Config below for more details.
- Zone
Name string Name for the zone in a Global Cluster.
Region Config
- Num
Shards int - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- Id string
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- Regions
Configs []ClusterReplication Spec Regions Config - Physical location of the region. Each regionsConfig document describes the region’s priority in elections and the number and type of MongoDB nodes Atlas deploys to the region. You must order each regionsConfigs document by regionsConfig.priority, descending. See Region Config below for more details.
- Zone
Name string Name for the zone in a Global Cluster.
Region Config
- num
Shards Integer - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- id String
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- regions
Configs List<ClusterReplication Spec Regions Config> - Physical location of the region. Each regionsConfig document describes the region’s priority in elections and the number and type of MongoDB nodes Atlas deploys to the region. You must order each regionsConfigs document by regionsConfig.priority, descending. See Region Config below for more details.
- zone
Name String Name for the zone in a Global Cluster.
Region Config
- num
Shards number - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- id string
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- regions
Configs ClusterReplication Spec Regions Config[] - Physical location of the region. Each regionsConfig document describes the region’s priority in elections and the number and type of MongoDB nodes Atlas deploys to the region. You must order each regionsConfigs document by regionsConfig.priority, descending. See Region Config below for more details.
- zone
Name string Name for the zone in a Global Cluster.
Region Config
- num_
shards int - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- id str
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- regions_
configs Sequence[ClusterReplication Spec Regions Config] - Physical location of the region. Each regionsConfig document describes the region’s priority in elections and the number and type of MongoDB nodes Atlas deploys to the region. You must order each regionsConfigs document by regionsConfig.priority, descending. See Region Config below for more details.
- zone_
name str Name for the zone in a Global Cluster.
Region Config
- num
Shards Number - Selects whether the cluster is a replica set or a sharded cluster. If you use the replicationSpecs parameter, you must set num_shards.
- id String
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- regions
Configs List<Property Map> - Physical location of the region. Each regionsConfig document describes the region’s priority in elections and the number and type of MongoDB nodes Atlas deploys to the region. You must order each regionsConfigs document by regionsConfig.priority, descending. See Region Config below for more details.
- zone
Name String Name for the zone in a Global Cluster.
Region Config
ClusterReplicationSpecRegionsConfig, ClusterReplicationSpecRegionsConfigArgs
- 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
Nodes int - The number of analytics nodes for Atlas to deploy to the region. Analytics nodes are useful for handling analytic data such as reporting queries from BI Connector for Atlas. Analytics nodes are read-only, and can never become the primary. If you do not specify this option, no analytics nodes are deployed to the region.
- Electable
Nodes int - Number of electable nodes for Atlas to deploy to the region. Electable nodes can become the primary and can facilitate local reads.
- The total number of electableNodes across all replication spec regions must total 3, 5, or 7.
- Specify 0 if you do not want any electable nodes in the region.
- You cannot create electable nodes in a region if
priority
is 0.
- Priority int
- Election priority of the region. For regions with only read-only nodes, set this value to 0.
- For regions where
electable_nodes
is at least 1, each region must have a priority of exactly one (1) less than the previous region. The first region must have a priority of 7. The lowest possible priority is 1. - The priority 7 region identifies the Preferred Region of the cluster. Atlas places the primary node in the Preferred Region. Priorities 1 through 7 are exclusive - no more than one region per cluster can be assigned a given priority.
- Example: If you have three regions, their priorities would be 7, 6, and 5 respectively. If you added two more regions for supporting electable nodes, the priorities of those regions would be 4 and 3 respectively.
- For regions where
- Read
Only intNodes - Number of read-only nodes for Atlas to deploy to the region. Read-only nodes can never become the primary, but can facilitate local-reads. Specify 0 if you do not want any read-only nodes in the region.
- 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
Nodes int - The number of analytics nodes for Atlas to deploy to the region. Analytics nodes are useful for handling analytic data such as reporting queries from BI Connector for Atlas. Analytics nodes are read-only, and can never become the primary. If you do not specify this option, no analytics nodes are deployed to the region.
- Electable
Nodes int - Number of electable nodes for Atlas to deploy to the region. Electable nodes can become the primary and can facilitate local reads.
- The total number of electableNodes across all replication spec regions must total 3, 5, or 7.
- Specify 0 if you do not want any electable nodes in the region.
- You cannot create electable nodes in a region if
priority
is 0.
- Priority int
- Election priority of the region. For regions with only read-only nodes, set this value to 0.
- For regions where
electable_nodes
is at least 1, each region must have a priority of exactly one (1) less than the previous region. The first region must have a priority of 7. The lowest possible priority is 1. - The priority 7 region identifies the Preferred Region of the cluster. Atlas places the primary node in the Preferred Region. Priorities 1 through 7 are exclusive - no more than one region per cluster can be assigned a given priority.
- Example: If you have three regions, their priorities would be 7, 6, and 5 respectively. If you added two more regions for supporting electable nodes, the priorities of those regions would be 4 and 3 respectively.
- For regions where
- Read
Only intNodes - Number of read-only nodes for Atlas to deploy to the region. Read-only nodes can never become the primary, but can facilitate local-reads. Specify 0 if you do not want any read-only nodes in the region.
- 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
Nodes Integer - The number of analytics nodes for Atlas to deploy to the region. Analytics nodes are useful for handling analytic data such as reporting queries from BI Connector for Atlas. Analytics nodes are read-only, and can never become the primary. If you do not specify this option, no analytics nodes are deployed to the region.
- electable
Nodes Integer - Number of electable nodes for Atlas to deploy to the region. Electable nodes can become the primary and can facilitate local reads.
- The total number of electableNodes across all replication spec regions must total 3, 5, or 7.
- Specify 0 if you do not want any electable nodes in the region.
- You cannot create electable nodes in a region if
priority
is 0.
- priority Integer
- Election priority of the region. For regions with only read-only nodes, set this value to 0.
- For regions where
electable_nodes
is at least 1, each region must have a priority of exactly one (1) less than the previous region. The first region must have a priority of 7. The lowest possible priority is 1. - The priority 7 region identifies the Preferred Region of the cluster. Atlas places the primary node in the Preferred Region. Priorities 1 through 7 are exclusive - no more than one region per cluster can be assigned a given priority.
- Example: If you have three regions, their priorities would be 7, 6, and 5 respectively. If you added two more regions for supporting electable nodes, the priorities of those regions would be 4 and 3 respectively.
- For regions where
- read
Only IntegerNodes - Number of read-only nodes for Atlas to deploy to the region. Read-only nodes can never become the primary, but can facilitate local-reads. Specify 0 if you do not want any read-only nodes in the region.
- 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
Nodes number - The number of analytics nodes for Atlas to deploy to the region. Analytics nodes are useful for handling analytic data such as reporting queries from BI Connector for Atlas. Analytics nodes are read-only, and can never become the primary. If you do not specify this option, no analytics nodes are deployed to the region.
- electable
Nodes number - Number of electable nodes for Atlas to deploy to the region. Electable nodes can become the primary and can facilitate local reads.
- The total number of electableNodes across all replication spec regions must total 3, 5, or 7.
- Specify 0 if you do not want any electable nodes in the region.
- You cannot create electable nodes in a region if
priority
is 0.
- priority number
- Election priority of the region. For regions with only read-only nodes, set this value to 0.
- For regions where
electable_nodes
is at least 1, each region must have a priority of exactly one (1) less than the previous region. The first region must have a priority of 7. The lowest possible priority is 1. - The priority 7 region identifies the Preferred Region of the cluster. Atlas places the primary node in the Preferred Region. Priorities 1 through 7 are exclusive - no more than one region per cluster can be assigned a given priority.
- Example: If you have three regions, their priorities would be 7, 6, and 5 respectively. If you added two more regions for supporting electable nodes, the priorities of those regions would be 4 and 3 respectively.
- For regions where
- read
Only numberNodes - Number of read-only nodes for Atlas to deploy to the region. Read-only nodes can never become the primary, but can facilitate local-reads. Specify 0 if you do not want any read-only nodes in the region.
- 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_
nodes int - The number of analytics nodes for Atlas to deploy to the region. Analytics nodes are useful for handling analytic data such as reporting queries from BI Connector for Atlas. Analytics nodes are read-only, and can never become the primary. If you do not specify this option, no analytics nodes are deployed to the region.
- electable_
nodes int - Number of electable nodes for Atlas to deploy to the region. Electable nodes can become the primary and can facilitate local reads.
- The total number of electableNodes across all replication spec regions must total 3, 5, or 7.
- Specify 0 if you do not want any electable nodes in the region.
- You cannot create electable nodes in a region if
priority
is 0.
- priority int
- Election priority of the region. For regions with only read-only nodes, set this value to 0.
- For regions where
electable_nodes
is at least 1, each region must have a priority of exactly one (1) less than the previous region. The first region must have a priority of 7. The lowest possible priority is 1. - The priority 7 region identifies the Preferred Region of the cluster. Atlas places the primary node in the Preferred Region. Priorities 1 through 7 are exclusive - no more than one region per cluster can be assigned a given priority.
- Example: If you have three regions, their priorities would be 7, 6, and 5 respectively. If you added two more regions for supporting electable nodes, the priorities of those regions would be 4 and 3 respectively.
- For regions where
- read_
only_ intnodes - Number of read-only nodes for Atlas to deploy to the region. Read-only nodes can never become the primary, but can facilitate local-reads. Specify 0 if you do not want any read-only nodes in the region.
- 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
Nodes Number - The number of analytics nodes for Atlas to deploy to the region. Analytics nodes are useful for handling analytic data such as reporting queries from BI Connector for Atlas. Analytics nodes are read-only, and can never become the primary. If you do not specify this option, no analytics nodes are deployed to the region.
- electable
Nodes Number - Number of electable nodes for Atlas to deploy to the region. Electable nodes can become the primary and can facilitate local reads.
- The total number of electableNodes across all replication spec regions must total 3, 5, or 7.
- Specify 0 if you do not want any electable nodes in the region.
- You cannot create electable nodes in a region if
priority
is 0.
- priority Number
- Election priority of the region. For regions with only read-only nodes, set this value to 0.
- For regions where
electable_nodes
is at least 1, each region must have a priority of exactly one (1) less than the previous region. The first region must have a priority of 7. The lowest possible priority is 1. - The priority 7 region identifies the Preferred Region of the cluster. Atlas places the primary node in the Preferred Region. Priorities 1 through 7 are exclusive - no more than one region per cluster can be assigned a given priority.
- Example: If you have three regions, their priorities would be 7, 6, and 5 respectively. If you added two more regions for supporting electable nodes, the priorities of those regions would be 4 and 3 respectively.
- For regions where
- read
Only NumberNodes - Number of read-only nodes for Atlas to deploy to the region. Read-only nodes can never become the primary, but can facilitate local-reads. Specify 0 if you do not want any read-only nodes in the region.
ClusterSnapshotBackupPolicy, ClusterSnapshotBackupPolicyArgs
- Cluster
Id string - The cluster ID.
- Cluster
Name string - Next
Snapshot string - Policies
List<Cluster
Snapshot Backup Policy Policy> - Reference
Hour intOf Day - Reference
Minute intOf Hour - Restore
Window intDays - Update
Snapshots bool
- Cluster
Id string - The cluster ID.
- Cluster
Name string - Next
Snapshot string - Policies
[]Cluster
Snapshot Backup Policy Policy - Reference
Hour intOf Day - Reference
Minute intOf Hour - Restore
Window intDays - Update
Snapshots bool
- cluster
Id String - The cluster ID.
- cluster
Name String - next
Snapshot String - policies
List<Cluster
Snapshot Backup Policy Policy> - reference
Hour IntegerOf Day - reference
Minute IntegerOf Hour - restore
Window IntegerDays - update
Snapshots Boolean
- cluster
Id string - The cluster ID.
- cluster
Name string - next
Snapshot string - policies
Cluster
Snapshot Backup Policy Policy[] - reference
Hour numberOf Day - reference
Minute numberOf Hour - restore
Window numberDays - update
Snapshots boolean
- cluster_
id str - The cluster ID.
- cluster_
name str - next_
snapshot str - policies
Sequence[Cluster
Snapshot Backup Policy Policy] - reference_
hour_ intof_ day - reference_
minute_ intof_ hour - restore_
window_ intdays - update_
snapshots bool
- cluster
Id String - The cluster ID.
- cluster
Name String - next
Snapshot String - policies List<Property Map>
- reference
Hour NumberOf Day - reference
Minute NumberOf Hour - restore
Window NumberDays - update
Snapshots Boolean
ClusterSnapshotBackupPolicyPolicy, ClusterSnapshotBackupPolicyPolicyArgs
- Id string
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- Policy
Items List<ClusterSnapshot Backup Policy Policy Policy Item>
- Id string
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- Policy
Items []ClusterSnapshot Backup Policy Policy Policy Item
- id String
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- policy
Items List<ClusterSnapshot Backup Policy Policy Policy Item>
- id string
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- policy
Items ClusterSnapshot Backup Policy Policy Policy Item[]
- id str
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- policy_
items Sequence[ClusterSnapshot Backup Policy Policy Policy Item]
- id String
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- policy
Items List<Property Map>
ClusterSnapshotBackupPolicyPolicyPolicyItem, ClusterSnapshotBackupPolicyPolicyPolicyItemArgs
- Frequency
Interval int - Frequency
Type string - Id string
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- Retention
Unit string - Retention
Value int
- Frequency
Interval int - Frequency
Type string - Id string
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- Retention
Unit string - Retention
Value int
- frequency
Interval Integer - frequency
Type String - id String
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- retention
Unit String - retention
Value Integer
- frequency
Interval number - frequency
Type string - id string
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- retention
Unit string - retention
Value number
- frequency_
interval int - frequency_
type str - id str
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- retention_
unit str - retention_
value int
- frequency
Interval Number - frequency
Type String - id String
- Unique identifer of the replication document for a zone in a Global Cluster. This value corresponds to the legacy sharding schema (no independent shard scaling) and is different from the Shard ID you may see in the Atlas UI.
- retention
Unit String - retention
Value Number
ClusterTag, ClusterTagArgs
- 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
mongodbatlas
Terraform Provider.