1. Packages
  2. Mongodbatlas Provider
  3. API Docs
  4. getClusters
MongoDB Atlas v3.30.0 published on Friday, Mar 21, 2025 by Pulumi

mongodbatlas.getClusters

Explore with Pulumi AI

# Data Source: mongodbatlas.getClusters

mongodbatlas.Cluster describes all Clusters by the provided project_id. The data source requires your Project ID.

IMPORTANT:
• Multi Region Cluster: The mongodbatlas.Cluster data source doesn’t return the container_id for each region utilized by the cluster. For retrieving the container_id, we recommend the mongodbatlas.AdvancedCluster data source instead.
• Changes to cluster configurations can affect costs. Before making changes, please see Billing.
• If your Atlas project contains a custom role that uses actions introduced in a specific MongoDB version, you cannot create a cluster with a MongoDB version less than that version unless you delete the custom role.

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

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as mongodbatlas from "@pulumi/mongodbatlas";

const testCluster = new mongodbatlas.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,
    providerName: "AWS",
    providerInstanceSizeName: "M40",
});
const test = mongodbatlas.getClustersOutput({
    projectId: testCluster.projectId,
});
Copy
import pulumi
import pulumi_mongodbatlas as mongodbatlas

test_cluster = mongodbatlas.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,
    provider_name="AWS",
    provider_instance_size_name="M40")
test = mongodbatlas.get_clusters_output(project_id=test_cluster.project_id)
Copy
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 {
		testCluster, err := mongodbatlas.NewCluster(ctx, "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),
			ProviderName:             pulumi.String("AWS"),
			ProviderInstanceSizeName: pulumi.String("M40"),
		})
		if err != nil {
			return err
		}
		_ = mongodbatlas.LookupClustersOutput(ctx, mongodbatlas.GetClustersOutputArgs{
			ProjectId: testCluster.ProjectId,
		}, nil)
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Mongodbatlas = Pulumi.Mongodbatlas;

return await Deployment.RunAsync(() => 
{
    var testCluster = new Mongodbatlas.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,
        ProviderName = "AWS",
        ProviderInstanceSizeName = "M40",
    });

    var test = Mongodbatlas.GetClusters.Invoke(new()
    {
        ProjectId = testCluster.ProjectId,
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.mongodbatlas.Cluster;
import com.pulumi.mongodbatlas.ClusterArgs;
import com.pulumi.mongodbatlas.inputs.ClusterReplicationSpecArgs;
import com.pulumi.mongodbatlas.MongodbatlasFunctions;
import com.pulumi.mongodbatlas.inputs.GetClustersArgs;
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 testCluster = new Cluster("testCluster", 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)
            .providerName("AWS")
            .providerInstanceSizeName("M40")
            .build());

        final var test = MongodbatlasFunctions.getClusters(GetClustersArgs.builder()
            .projectId(testCluster.projectId())
            .build());

    }
}
Copy
resources:
  testCluster:
    type: mongodbatlas:Cluster
    name: test
    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 # Provider Settings "block"
      providerName: AWS
      providerInstanceSizeName: M40
variables:
  test:
    fn::invoke:
      function: mongodbatlas:getClusters
      arguments:
        projectId: ${testCluster.projectId}
Copy

Using getClusters

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getClusters(args: GetClustersArgs, opts?: InvokeOptions): Promise<GetClustersResult>
function getClustersOutput(args: GetClustersOutputArgs, opts?: InvokeOptions): Output<GetClustersResult>
Copy
def get_clusters(project_id: Optional[str] = None,
                 opts: Optional[InvokeOptions] = None) -> GetClustersResult
def get_clusters_output(project_id: Optional[pulumi.Input[str]] = None,
                 opts: Optional[InvokeOptions] = None) -> Output[GetClustersResult]
Copy
func LookupClusters(ctx *Context, args *LookupClustersArgs, opts ...InvokeOption) (*LookupClustersResult, error)
func LookupClustersOutput(ctx *Context, args *LookupClustersOutputArgs, opts ...InvokeOption) LookupClustersResultOutput
Copy

> Note: This function is named LookupClusters in the Go SDK.

public static class GetClusters 
{
    public static Task<GetClustersResult> InvokeAsync(GetClustersArgs args, InvokeOptions? opts = null)
    public static Output<GetClustersResult> Invoke(GetClustersInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetClustersResult> getClusters(GetClustersArgs args, InvokeOptions options)
public static Output<GetClustersResult> getClusters(GetClustersArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: mongodbatlas:index/getClusters:getClusters
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

ProjectId This property is required. string
The unique ID for the project to get the clusters.
ProjectId This property is required. string
The unique ID for the project to get the clusters.
projectId This property is required. String
The unique ID for the project to get the clusters.
projectId This property is required. string
The unique ID for the project to get the clusters.
project_id This property is required. str
The unique ID for the project to get the clusters.
projectId This property is required. String
The unique ID for the project to get the clusters.

getClusters Result

The following output properties are available:

Id string
The provider-assigned unique ID for this managed resource.
ProjectId string
Results List<GetClustersResult>
A list where each represents a Cluster. See Cluster below for more details.
Id string
The provider-assigned unique ID for this managed resource.
ProjectId string
Results []GetClustersResult
A list where each represents a Cluster. See Cluster below for more details.
id String
The provider-assigned unique ID for this managed resource.
projectId String
results List<GetClustersResult>
A list where each represents a Cluster. See Cluster below for more details.
id string
The provider-assigned unique ID for this managed resource.
projectId string
results GetClustersResult[]
A list where each represents a Cluster. See Cluster below for more details.
id str
The provider-assigned unique ID for this managed resource.
project_id str
results Sequence[GetClustersResult]
A list where each represents a Cluster. See Cluster below for more details.
id String
The provider-assigned unique ID for this managed resource.
projectId String
results List<Property Map>
A list where each represents a Cluster. See Cluster below for more details.

Supporting Types

GetClustersResult

AdvancedConfigurations This property is required. List<GetClustersResultAdvancedConfiguration>
Get the advanced configuration options. See Advanced Configuration below for more details.
AutoScalingComputeEnabled This property is required. bool
Specifies whether cluster tier auto-scaling is enabled. The default is false.
AutoScalingComputeScaleDownEnabled This property is required. bool
  • auto_scaling_compute_scale_down_enabled - Specifies whether cluster tier auto-down-scaling is enabled.
AutoScalingDiskGbEnabled This property is required. bool
Indicates whether disk auto-scaling is enabled.
BackingProviderName This property is required. string
Indicates Cloud service provider on which the server for a multi-tenant cluster is provisioned.
BackupEnabled This property is required. bool
Legacy Option, Indicates whether Atlas continuous backups are enabled for the cluster.
BiConnectorConfigs This property is required. List<GetClustersResultBiConnectorConfig>
Indicates 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.
ClusterType This property is required. string
Indicates the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
ConnectionStrings This property is required. List<GetClustersResultConnectionString>
Set of connection strings that your applications use to connect to this cluster. More information 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.
ContainerId This property is required. string
The Network Peering Container ID.
DiskSizeGb This property is required. double
Indicates the size in gigabytes of the server’s root volume (AWS/GCP Only).
EncryptionAtRestProvider This property is required. string
Indicates whether Encryption at Rest is enabled or disabled.
Labels This property is required. List<GetClustersResultLabel>
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.
MongoDbMajorVersion This property is required. string
Indicates the version of the cluster to deploy.
MongoDbVersion This property is required. string
Version of MongoDB the cluster runs, in major-version.minor-version format.
MongoUri This property is required. string
Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.
MongoUriUpdated This property is required. string
Lists when the connection string was last updated. The connection string changes, for example, if you change a replica set to a sharded cluster.
MongoUriWithOptions This property is required. string
Describes 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 This property is required. string
The name of the current plugin
NumShards This property is required. int
Number of shards to deploy in the specified zone.
Paused This property is required. bool
Flag that indicates whether the cluster is paused or not.
PinnedFcvs This property is required. List<GetClustersResultPinnedFcv>
The pinned Feature Compatibility Version (FCV) with its associated expiration date. See below.
PitEnabled This property is required. bool
Flag that indicates if the cluster uses Continuous Cloud Backup.
ProviderAutoScalingComputeMaxInstanceSize This property is required. string
Maximum instance size to which your cluster can automatically scale.
ProviderAutoScalingComputeMinInstanceSize This property is required. string
Minimum instance size to which your cluster can automatically scale.
ProviderBackupEnabled This property is required. bool
Flag indicating if the cluster uses Cloud Backup Snapshots for backups. DEPRECATED Use cloud_backup instead.
ProviderDiskIops This property is required. int
Indicates the maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected providerSettings.instanceSizeName and diskSizeGB.
ProviderDiskTypeName This property is required. string
Describes Azure disk type of the server’s root volume (Azure Only).
ProviderEncryptEbsVolume This property is required. bool
(DEPRECATED) Indicates whether the Amazon EBS encryption is enabled. This feature encrypts the server’s root volume for both data at rest within the volume and data moving between the volume and the instance. By default this attribute is always enabled, per deprecation process showing the real value at provider_encrypt_ebs_volume_flag computed attribute.
ProviderInstanceSizeName This property is required. string
Atlas provides different instance sizes, each with a default storage capacity and RAM size.
ProviderName This property is required. string
Indicates the cloud service provider on which the servers are provisioned.
ProviderRegionName This property is required. string
Indicates 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.
ProviderVolumeType This property is required. string

Indicates the type of the volume. The possible values are: STANDARD and PROVISIONED.

NOTE: STANDARD is not available for NVME clusters.

RedactClientLogData This property is required. bool
(Optional) Flag that enables or disables log redaction, see the manual for more information.
ReplicationFactor This property is required. int
(Deprecated) 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.
ReplicationSpecs This property is required. List<GetClustersResultReplicationSpec>
Configuration for cluster regions. See Replication Spec below for more details.
SnapshotBackupPolicies This property is required. List<GetClustersResultSnapshotBackupPolicy>
current snapshot schedule and retention settings for the cluster.
SrvAddress This property is required. 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.
StateName This property is required. string
Indicates the current state of the cluster. The possible states are:

  • IDLE
  • CREATING
  • UPDATING
  • DELETING
  • DELETED
  • REPAIRING
Tags This property is required. List<GetClustersResultTag>
Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
TerminationProtectionEnabled This property is required. bool
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.
VersionReleaseSystem This property is required. string
Release cadence that Atlas uses for this cluster.
AdvancedConfigurations This property is required. []GetClustersResultAdvancedConfiguration
Get the advanced configuration options. See Advanced Configuration below for more details.
AutoScalingComputeEnabled This property is required. bool
Specifies whether cluster tier auto-scaling is enabled. The default is false.
AutoScalingComputeScaleDownEnabled This property is required. bool
  • auto_scaling_compute_scale_down_enabled - Specifies whether cluster tier auto-down-scaling is enabled.
AutoScalingDiskGbEnabled This property is required. bool
Indicates whether disk auto-scaling is enabled.
BackingProviderName This property is required. string
Indicates Cloud service provider on which the server for a multi-tenant cluster is provisioned.
BackupEnabled This property is required. bool
Legacy Option, Indicates whether Atlas continuous backups are enabled for the cluster.
BiConnectorConfigs This property is required. []GetClustersResultBiConnectorConfig
Indicates 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.
ClusterType This property is required. string
Indicates the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
ConnectionStrings This property is required. []GetClustersResultConnectionString
Set of connection strings that your applications use to connect to this cluster. More information 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.
ContainerId This property is required. string
The Network Peering Container ID.
DiskSizeGb This property is required. float64
Indicates the size in gigabytes of the server’s root volume (AWS/GCP Only).
EncryptionAtRestProvider This property is required. string
Indicates whether Encryption at Rest is enabled or disabled.
Labels This property is required. []GetClustersResultLabel
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.
MongoDbMajorVersion This property is required. string
Indicates the version of the cluster to deploy.
MongoDbVersion This property is required. string
Version of MongoDB the cluster runs, in major-version.minor-version format.
MongoUri This property is required. string
Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.
MongoUriUpdated This property is required. string
Lists when the connection string was last updated. The connection string changes, for example, if you change a replica set to a sharded cluster.
MongoUriWithOptions This property is required. string
Describes 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 This property is required. string
The name of the current plugin
NumShards This property is required. int
Number of shards to deploy in the specified zone.
Paused This property is required. bool
Flag that indicates whether the cluster is paused or not.
PinnedFcvs This property is required. []GetClustersResultPinnedFcv
The pinned Feature Compatibility Version (FCV) with its associated expiration date. See below.
PitEnabled This property is required. bool
Flag that indicates if the cluster uses Continuous Cloud Backup.
ProviderAutoScalingComputeMaxInstanceSize This property is required. string
Maximum instance size to which your cluster can automatically scale.
ProviderAutoScalingComputeMinInstanceSize This property is required. string
Minimum instance size to which your cluster can automatically scale.
ProviderBackupEnabled This property is required. bool
Flag indicating if the cluster uses Cloud Backup Snapshots for backups. DEPRECATED Use cloud_backup instead.
ProviderDiskIops This property is required. int
Indicates the maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected providerSettings.instanceSizeName and diskSizeGB.
ProviderDiskTypeName This property is required. string
Describes Azure disk type of the server’s root volume (Azure Only).
ProviderEncryptEbsVolume This property is required. bool
(DEPRECATED) Indicates whether the Amazon EBS encryption is enabled. This feature encrypts the server’s root volume for both data at rest within the volume and data moving between the volume and the instance. By default this attribute is always enabled, per deprecation process showing the real value at provider_encrypt_ebs_volume_flag computed attribute.
ProviderInstanceSizeName This property is required. string
Atlas provides different instance sizes, each with a default storage capacity and RAM size.
ProviderName This property is required. string
Indicates the cloud service provider on which the servers are provisioned.
ProviderRegionName This property is required. string
Indicates 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.
ProviderVolumeType This property is required. string

Indicates the type of the volume. The possible values are: STANDARD and PROVISIONED.

NOTE: STANDARD is not available for NVME clusters.

RedactClientLogData This property is required. bool
(Optional) Flag that enables or disables log redaction, see the manual for more information.
ReplicationFactor This property is required. int
(Deprecated) 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.
ReplicationSpecs This property is required. []GetClustersResultReplicationSpec
Configuration for cluster regions. See Replication Spec below for more details.
SnapshotBackupPolicies This property is required. []GetClustersResultSnapshotBackupPolicy
current snapshot schedule and retention settings for the cluster.
SrvAddress This property is required. 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.
StateName This property is required. string
Indicates the current state of the cluster. The possible states are:

  • IDLE
  • CREATING
  • UPDATING
  • DELETING
  • DELETED
  • REPAIRING
Tags This property is required. []GetClustersResultTag
Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
TerminationProtectionEnabled This property is required. bool
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.
VersionReleaseSystem This property is required. string
Release cadence that Atlas uses for this cluster.
advancedConfigurations This property is required. List<GetClustersResultAdvancedConfiguration>
Get the advanced configuration options. See Advanced Configuration below for more details.
autoScalingComputeEnabled This property is required. Boolean
Specifies whether cluster tier auto-scaling is enabled. The default is false.
autoScalingComputeScaleDownEnabled This property is required. Boolean
  • auto_scaling_compute_scale_down_enabled - Specifies whether cluster tier auto-down-scaling is enabled.
autoScalingDiskGbEnabled This property is required. Boolean
Indicates whether disk auto-scaling is enabled.
backingProviderName This property is required. String
Indicates Cloud service provider on which the server for a multi-tenant cluster is provisioned.
backupEnabled This property is required. Boolean
Legacy Option, Indicates whether Atlas continuous backups are enabled for the cluster.
biConnectorConfigs This property is required. List<GetClustersResultBiConnectorConfig>
Indicates 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.
clusterType This property is required. String
Indicates the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
connectionStrings This property is required. List<GetClustersResultConnectionString>
Set of connection strings that your applications use to connect to this cluster. More information 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.
containerId This property is required. String
The Network Peering Container ID.
diskSizeGb This property is required. Double
Indicates the size in gigabytes of the server’s root volume (AWS/GCP Only).
encryptionAtRestProvider This property is required. String
Indicates whether Encryption at Rest is enabled or disabled.
labels This property is required. List<GetClustersResultLabel>
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.
mongoDbMajorVersion This property is required. String
Indicates the version of the cluster to deploy.
mongoDbVersion This property is required. String
Version of MongoDB the cluster runs, in major-version.minor-version format.
mongoUri This property is required. String
Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.
mongoUriUpdated This property is required. String
Lists when the connection string was last updated. The connection string changes, for example, if you change a replica set to a sharded cluster.
mongoUriWithOptions This property is required. String
Describes 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 This property is required. String
The name of the current plugin
numShards This property is required. Integer
Number of shards to deploy in the specified zone.
paused This property is required. Boolean
Flag that indicates whether the cluster is paused or not.
pinnedFcvs This property is required. List<GetClustersResultPinnedFcv>
The pinned Feature Compatibility Version (FCV) with its associated expiration date. See below.
pitEnabled This property is required. Boolean
Flag that indicates if the cluster uses Continuous Cloud Backup.
providerAutoScalingComputeMaxInstanceSize This property is required. String
Maximum instance size to which your cluster can automatically scale.
providerAutoScalingComputeMinInstanceSize This property is required. String
Minimum instance size to which your cluster can automatically scale.
providerBackupEnabled This property is required. Boolean
Flag indicating if the cluster uses Cloud Backup Snapshots for backups. DEPRECATED Use cloud_backup instead.
providerDiskIops This property is required. Integer
Indicates the maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected providerSettings.instanceSizeName and diskSizeGB.
providerDiskTypeName This property is required. String
Describes Azure disk type of the server’s root volume (Azure Only).
providerEncryptEbsVolume This property is required. Boolean
(DEPRECATED) Indicates whether the Amazon EBS encryption is enabled. This feature encrypts the server’s root volume for both data at rest within the volume and data moving between the volume and the instance. By default this attribute is always enabled, per deprecation process showing the real value at provider_encrypt_ebs_volume_flag computed attribute.
providerInstanceSizeName This property is required. String
Atlas provides different instance sizes, each with a default storage capacity and RAM size.
providerName This property is required. String
Indicates the cloud service provider on which the servers are provisioned.
providerRegionName This property is required. String
Indicates 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.
providerVolumeType This property is required. String

Indicates the type of the volume. The possible values are: STANDARD and PROVISIONED.

NOTE: STANDARD is not available for NVME clusters.

redactClientLogData This property is required. Boolean
(Optional) Flag that enables or disables log redaction, see the manual for more information.
replicationFactor This property is required. Integer
(Deprecated) 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.
replicationSpecs This property is required. List<GetClustersResultReplicationSpec>
Configuration for cluster regions. See Replication Spec below for more details.
snapshotBackupPolicies This property is required. List<GetClustersResultSnapshotBackupPolicy>
current snapshot schedule and retention settings for the cluster.
srvAddress This property is required. 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.
stateName This property is required. String
Indicates the current state of the cluster. The possible states are:

  • IDLE
  • CREATING
  • UPDATING
  • DELETING
  • DELETED
  • REPAIRING
tags This property is required. List<GetClustersResultTag>
Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
terminationProtectionEnabled This property is required. Boolean
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.
versionReleaseSystem This property is required. String
Release cadence that Atlas uses for this cluster.
advancedConfigurations This property is required. GetClustersResultAdvancedConfiguration[]
Get the advanced configuration options. See Advanced Configuration below for more details.
autoScalingComputeEnabled This property is required. boolean
Specifies whether cluster tier auto-scaling is enabled. The default is false.
autoScalingComputeScaleDownEnabled This property is required. boolean
  • auto_scaling_compute_scale_down_enabled - Specifies whether cluster tier auto-down-scaling is enabled.
autoScalingDiskGbEnabled This property is required. boolean
Indicates whether disk auto-scaling is enabled.
backingProviderName This property is required. string
Indicates Cloud service provider on which the server for a multi-tenant cluster is provisioned.
backupEnabled This property is required. boolean
Legacy Option, Indicates whether Atlas continuous backups are enabled for the cluster.
biConnectorConfigs This property is required. GetClustersResultBiConnectorConfig[]
Indicates 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.
clusterType This property is required. string
Indicates the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
connectionStrings This property is required. GetClustersResultConnectionString[]
Set of connection strings that your applications use to connect to this cluster. More information 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.
containerId This property is required. string
The Network Peering Container ID.
diskSizeGb This property is required. number
Indicates the size in gigabytes of the server’s root volume (AWS/GCP Only).
encryptionAtRestProvider This property is required. string
Indicates whether Encryption at Rest is enabled or disabled.
labels This property is required. GetClustersResultLabel[]
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.
mongoDbMajorVersion This property is required. string
Indicates the version of the cluster to deploy.
mongoDbVersion This property is required. string
Version of MongoDB the cluster runs, in major-version.minor-version format.
mongoUri This property is required. string
Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.
mongoUriUpdated This property is required. string
Lists when the connection string was last updated. The connection string changes, for example, if you change a replica set to a sharded cluster.
mongoUriWithOptions This property is required. string
Describes 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 This property is required. string
The name of the current plugin
numShards This property is required. number
Number of shards to deploy in the specified zone.
paused This property is required. boolean
Flag that indicates whether the cluster is paused or not.
pinnedFcvs This property is required. GetClustersResultPinnedFcv[]
The pinned Feature Compatibility Version (FCV) with its associated expiration date. See below.
pitEnabled This property is required. boolean
Flag that indicates if the cluster uses Continuous Cloud Backup.
providerAutoScalingComputeMaxInstanceSize This property is required. string
Maximum instance size to which your cluster can automatically scale.
providerAutoScalingComputeMinInstanceSize This property is required. string
Minimum instance size to which your cluster can automatically scale.
providerBackupEnabled This property is required. boolean
Flag indicating if the cluster uses Cloud Backup Snapshots for backups. DEPRECATED Use cloud_backup instead.
providerDiskIops This property is required. number
Indicates the maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected providerSettings.instanceSizeName and diskSizeGB.
providerDiskTypeName This property is required. string
Describes Azure disk type of the server’s root volume (Azure Only).
providerEncryptEbsVolume This property is required. boolean
(DEPRECATED) Indicates whether the Amazon EBS encryption is enabled. This feature encrypts the server’s root volume for both data at rest within the volume and data moving between the volume and the instance. By default this attribute is always enabled, per deprecation process showing the real value at provider_encrypt_ebs_volume_flag computed attribute.
providerInstanceSizeName This property is required. string
Atlas provides different instance sizes, each with a default storage capacity and RAM size.
providerName This property is required. string
Indicates the cloud service provider on which the servers are provisioned.
providerRegionName This property is required. string
Indicates 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.
providerVolumeType This property is required. string

Indicates the type of the volume. The possible values are: STANDARD and PROVISIONED.

NOTE: STANDARD is not available for NVME clusters.

redactClientLogData This property is required. boolean
(Optional) Flag that enables or disables log redaction, see the manual for more information.
replicationFactor This property is required. number
(Deprecated) 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.
replicationSpecs This property is required. GetClustersResultReplicationSpec[]
Configuration for cluster regions. See Replication Spec below for more details.
snapshotBackupPolicies This property is required. GetClustersResultSnapshotBackupPolicy[]
current snapshot schedule and retention settings for the cluster.
srvAddress This property is required. 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.
stateName This property is required. string
Indicates the current state of the cluster. The possible states are:

  • IDLE
  • CREATING
  • UPDATING
  • DELETING
  • DELETED
  • REPAIRING
tags This property is required. GetClustersResultTag[]
Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
terminationProtectionEnabled This property is required. boolean
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.
versionReleaseSystem This property is required. string
Release cadence that Atlas uses for this cluster.
advanced_configurations This property is required. Sequence[GetClustersResultAdvancedConfiguration]
Get the advanced configuration options. See Advanced Configuration below for more details.
auto_scaling_compute_enabled This property is required. bool
Specifies whether cluster tier auto-scaling is enabled. The default is false.
auto_scaling_compute_scale_down_enabled This property is required. bool
  • auto_scaling_compute_scale_down_enabled - Specifies whether cluster tier auto-down-scaling is enabled.
auto_scaling_disk_gb_enabled This property is required. bool
Indicates whether disk auto-scaling is enabled.
backing_provider_name This property is required. str
Indicates Cloud service provider on which the server for a multi-tenant cluster is provisioned.
backup_enabled This property is required. bool
Legacy Option, Indicates whether Atlas continuous backups are enabled for the cluster.
bi_connector_configs This property is required. Sequence[GetClustersResultBiConnectorConfig]
Indicates 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.
cluster_type This property is required. str
Indicates the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
connection_strings This property is required. Sequence[GetClustersResultConnectionString]
Set of connection strings that your applications use to connect to this cluster. More information 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 This property is required. str
The Network Peering Container ID.
disk_size_gb This property is required. float
Indicates the size in gigabytes of the server’s root volume (AWS/GCP Only).
encryption_at_rest_provider This property is required. str
Indicates whether Encryption at Rest is enabled or disabled.
labels This property is required. Sequence[GetClustersResultLabel]
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_major_version This property is required. str
Indicates the version of the cluster to deploy.
mongo_db_version This property is required. str
Version of MongoDB the cluster runs, in major-version.minor-version format.
mongo_uri This property is required. 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_updated This property is required. str
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_with_options This property is required. str
Describes 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 This property is required. str
The name of the current plugin
num_shards This property is required. int
Number of shards to deploy in the specified zone.
paused This property is required. bool
Flag that indicates whether the cluster is paused or not.
pinned_fcvs This property is required. Sequence[GetClustersResultPinnedFcv]
The pinned Feature Compatibility Version (FCV) with its associated expiration date. See below.
pit_enabled This property is required. bool
Flag that indicates if the cluster uses Continuous Cloud Backup.
provider_auto_scaling_compute_max_instance_size This property is required. str
Maximum instance size to which your cluster can automatically scale.
provider_auto_scaling_compute_min_instance_size This property is required. str
Minimum instance size to which your cluster can automatically scale.
provider_backup_enabled This property is required. bool
Flag indicating if the cluster uses Cloud Backup Snapshots for backups. DEPRECATED Use cloud_backup instead.
provider_disk_iops This property is required. int
Indicates the maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected providerSettings.instanceSizeName and diskSizeGB.
provider_disk_type_name This property is required. str
Describes Azure disk type of the server’s root volume (Azure Only).
provider_encrypt_ebs_volume This property is required. bool
(DEPRECATED) Indicates whether the Amazon EBS encryption is enabled. This feature encrypts the server’s root volume for both data at rest within the volume and data moving between the volume and the instance. By default this attribute is always enabled, per deprecation process showing the real value at provider_encrypt_ebs_volume_flag computed attribute.
provider_instance_size_name This property is required. str
Atlas provides different instance sizes, each with a default storage capacity and RAM size.
provider_name This property is required. str
Indicates the cloud service provider on which the servers are provisioned.
provider_region_name This property is required. str
Indicates 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.
provider_volume_type This property is required. str

Indicates the type of the volume. The possible values are: STANDARD and PROVISIONED.

NOTE: STANDARD is not available for NVME clusters.

redact_client_log_data This property is required. bool
(Optional) Flag that enables or disables log redaction, see the manual for more information.
replication_factor This property is required. int
(Deprecated) 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 This property is required. Sequence[GetClustersResultReplicationSpec]
Configuration for cluster regions. See Replication Spec below for more details.
snapshot_backup_policies This property is required. Sequence[GetClustersResultSnapshotBackupPolicy]
current snapshot schedule and retention settings for the cluster.
srv_address This property is required. 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 This property is required. str
Indicates the current state of the cluster. The possible states are:

  • IDLE
  • CREATING
  • UPDATING
  • DELETING
  • DELETED
  • REPAIRING
tags This property is required. Sequence[GetClustersResultTag]
Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
termination_protection_enabled This property is required. bool
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_system This property is required. str
Release cadence that Atlas uses for this cluster.
advancedConfigurations This property is required. List<Property Map>
Get the advanced configuration options. See Advanced Configuration below for more details.
autoScalingComputeEnabled This property is required. Boolean
Specifies whether cluster tier auto-scaling is enabled. The default is false.
autoScalingComputeScaleDownEnabled This property is required. Boolean
  • auto_scaling_compute_scale_down_enabled - Specifies whether cluster tier auto-down-scaling is enabled.
autoScalingDiskGbEnabled This property is required. Boolean
Indicates whether disk auto-scaling is enabled.
backingProviderName This property is required. String
Indicates Cloud service provider on which the server for a multi-tenant cluster is provisioned.
backupEnabled This property is required. Boolean
Legacy Option, Indicates whether Atlas continuous backups are enabled for the cluster.
biConnectorConfigs This property is required. List<Property Map>
Indicates 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.
clusterType This property is required. String
Indicates the type of the cluster that you want to modify. You cannot convert a sharded cluster deployment to a replica set deployment.
connectionStrings This property is required. List<Property Map>
Set of connection strings that your applications use to connect to this cluster. More information 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.
containerId This property is required. String
The Network Peering Container ID.
diskSizeGb This property is required. Number
Indicates the size in gigabytes of the server’s root volume (AWS/GCP Only).
encryptionAtRestProvider This property is required. String
Indicates whether Encryption at Rest is enabled or disabled.
labels This property is required. 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.
mongoDbMajorVersion This property is required. String
Indicates the version of the cluster to deploy.
mongoDbVersion This property is required. String
Version of MongoDB the cluster runs, in major-version.minor-version format.
mongoUri This property is required. String
Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.
mongoUriUpdated This property is required. String
Lists when the connection string was last updated. The connection string changes, for example, if you change a replica set to a sharded cluster.
mongoUriWithOptions This property is required. String
Describes 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 This property is required. String
The name of the current plugin
numShards This property is required. Number
Number of shards to deploy in the specified zone.
paused This property is required. Boolean
Flag that indicates whether the cluster is paused or not.
pinnedFcvs This property is required. List<Property Map>
The pinned Feature Compatibility Version (FCV) with its associated expiration date. See below.
pitEnabled This property is required. Boolean
Flag that indicates if the cluster uses Continuous Cloud Backup.
providerAutoScalingComputeMaxInstanceSize This property is required. String
Maximum instance size to which your cluster can automatically scale.
providerAutoScalingComputeMinInstanceSize This property is required. String
Minimum instance size to which your cluster can automatically scale.
providerBackupEnabled This property is required. Boolean
Flag indicating if the cluster uses Cloud Backup Snapshots for backups. DEPRECATED Use cloud_backup instead.
providerDiskIops This property is required. Number
Indicates the maximum input/output operations per second (IOPS) the system can perform. The possible values depend on the selected providerSettings.instanceSizeName and diskSizeGB.
providerDiskTypeName This property is required. String
Describes Azure disk type of the server’s root volume (Azure Only).
providerEncryptEbsVolume This property is required. Boolean
(DEPRECATED) Indicates whether the Amazon EBS encryption is enabled. This feature encrypts the server’s root volume for both data at rest within the volume and data moving between the volume and the instance. By default this attribute is always enabled, per deprecation process showing the real value at provider_encrypt_ebs_volume_flag computed attribute.
providerInstanceSizeName This property is required. String
Atlas provides different instance sizes, each with a default storage capacity and RAM size.
providerName This property is required. String
Indicates the cloud service provider on which the servers are provisioned.
providerRegionName This property is required. String
Indicates 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.
providerVolumeType This property is required. String

Indicates the type of the volume. The possible values are: STANDARD and PROVISIONED.

NOTE: STANDARD is not available for NVME clusters.

redactClientLogData This property is required. Boolean
(Optional) Flag that enables or disables log redaction, see the manual for more information.
replicationFactor This property is required. Number
(Deprecated) 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.
replicationSpecs This property is required. List<Property Map>
Configuration for cluster regions. See Replication Spec below for more details.
snapshotBackupPolicies This property is required. List<Property Map>
current snapshot schedule and retention settings for the cluster.
srvAddress This property is required. 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.
stateName This property is required. String
Indicates the current state of the cluster. The possible states are:

  • IDLE
  • CREATING
  • UPDATING
  • DELETING
  • DELETED
  • REPAIRING
tags This property is required. List<Property Map>
Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below.
terminationProtectionEnabled This property is required. Boolean
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.
versionReleaseSystem This property is required. String
Release cadence that Atlas uses for this cluster.

GetClustersResultAdvancedConfiguration

ChangeStreamOptionsPreAndPostImagesExpireAfterSeconds This property is required. int
(Optional) The minimum pre- and post-image retention time in seconds. This parameter is only supported for MongoDB version 6.0 and above. Defaults to -1(off).
CustomOpensslCipherConfigTls12s This property is required. List<string>
The custom OpenSSL cipher suite list for TLS 1.2. This field is only valid when tls_cipher_config_mode is set to CUSTOM.
DefaultMaxTimeMs This property is required. int
DefaultReadConcern This property is required. string
Default level of acknowledgment requested from MongoDB for read operations set for this cluster. MongoDB 4.4 clusters default to available.

Deprecated: This parameter is deprecated. Please refer to our examples, documentation, and 1.18.0 migration guide for more details at https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/1.18.0-upgrade-guide.html.markdown

DefaultWriteConcern This property is required. string
Default level of acknowledgment requested from MongoDB for write operations set for this cluster. MongoDB 4.4 clusters default to 1.
FailIndexKeyTooLong This property is required. bool
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.

Deprecated: This parameter is deprecated. Please refer to our examples, documentation, and 1.18.0 migration guide for more details at https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/1.18.0-upgrade-guide.html.markdown

JavascriptEnabled This property is required. 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.
MinimumEnabledTlsProtocol This property is required. string
Sets the minimum Transport Layer Security (TLS) version the cluster accepts for incoming connections. Valid values are:
NoTableScan This property is required. bool
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.
OplogMinRetentionHours This property is required. double
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.
OplogSizeMb This property is required. int
The custom oplog size of the cluster. Without a value that indicates that the cluster uses the default oplog size calculated by Atlas.
SampleRefreshIntervalBiConnector This property is required. int
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.
SampleSizeBiConnector This property is required. int
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.
TlsCipherConfigMode This property is required. string
The TLS cipher suite configuration mode. Valid values include CUSTOM or DEFAULT. The DEFAULT mode uses the default cipher suites. The CUSTOM mode allows you to specify custom cipher suites for both TLS 1.2 and TLS 1.3.
TransactionLifetimeLimitSeconds This property is required. int
ChangeStreamOptionsPreAndPostImagesExpireAfterSeconds This property is required. int
(Optional) The minimum pre- and post-image retention time in seconds. This parameter is only supported for MongoDB version 6.0 and above. Defaults to -1(off).
CustomOpensslCipherConfigTls12s This property is required. []string
The custom OpenSSL cipher suite list for TLS 1.2. This field is only valid when tls_cipher_config_mode is set to CUSTOM.
DefaultMaxTimeMs This property is required. int
DefaultReadConcern This property is required. string
Default level of acknowledgment requested from MongoDB for read operations set for this cluster. MongoDB 4.4 clusters default to available.

Deprecated: This parameter is deprecated. Please refer to our examples, documentation, and 1.18.0 migration guide for more details at https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/1.18.0-upgrade-guide.html.markdown

DefaultWriteConcern This property is required. string
Default level of acknowledgment requested from MongoDB for write operations set for this cluster. MongoDB 4.4 clusters default to 1.
FailIndexKeyTooLong This property is required. bool
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.

Deprecated: This parameter is deprecated. Please refer to our examples, documentation, and 1.18.0 migration guide for more details at https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/1.18.0-upgrade-guide.html.markdown

JavascriptEnabled This property is required. 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.
MinimumEnabledTlsProtocol This property is required. string
Sets the minimum Transport Layer Security (TLS) version the cluster accepts for incoming connections. Valid values are:
NoTableScan This property is required. bool
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.
OplogMinRetentionHours This property is required. float64
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.
OplogSizeMb This property is required. int
The custom oplog size of the cluster. Without a value that indicates that the cluster uses the default oplog size calculated by Atlas.
SampleRefreshIntervalBiConnector This property is required. int
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.
SampleSizeBiConnector This property is required. int
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.
TlsCipherConfigMode This property is required. string
The TLS cipher suite configuration mode. Valid values include CUSTOM or DEFAULT. The DEFAULT mode uses the default cipher suites. The CUSTOM mode allows you to specify custom cipher suites for both TLS 1.2 and TLS 1.3.
TransactionLifetimeLimitSeconds This property is required. int
changeStreamOptionsPreAndPostImagesExpireAfterSeconds This property is required. Integer
(Optional) The minimum pre- and post-image retention time in seconds. This parameter is only supported for MongoDB version 6.0 and above. Defaults to -1(off).
customOpensslCipherConfigTls12s This property is required. List<String>
The custom OpenSSL cipher suite list for TLS 1.2. This field is only valid when tls_cipher_config_mode is set to CUSTOM.
defaultMaxTimeMs This property is required. Integer
defaultReadConcern This property is required. String
Default level of acknowledgment requested from MongoDB for read operations set for this cluster. MongoDB 4.4 clusters default to available.

Deprecated: This parameter is deprecated. Please refer to our examples, documentation, and 1.18.0 migration guide for more details at https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/1.18.0-upgrade-guide.html.markdown

defaultWriteConcern This property is required. String
Default level of acknowledgment requested from MongoDB for write operations set for this cluster. MongoDB 4.4 clusters default to 1.
failIndexKeyTooLong This property is required. Boolean
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.

Deprecated: This parameter is deprecated. Please refer to our examples, documentation, and 1.18.0 migration guide for more details at https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/1.18.0-upgrade-guide.html.markdown

javascriptEnabled This property is required. 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.
minimumEnabledTlsProtocol This property is required. String
Sets the minimum Transport Layer Security (TLS) version the cluster accepts for incoming connections. Valid values are:
noTableScan This property is required. Boolean
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.
oplogMinRetentionHours This property is required. Double
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.
oplogSizeMb This property is required. Integer
The custom oplog size of the cluster. Without a value that indicates that the cluster uses the default oplog size calculated by Atlas.
sampleRefreshIntervalBiConnector This property is required. Integer
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.
sampleSizeBiConnector This property is required. Integer
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.
tlsCipherConfigMode This property is required. String
The TLS cipher suite configuration mode. Valid values include CUSTOM or DEFAULT. The DEFAULT mode uses the default cipher suites. The CUSTOM mode allows you to specify custom cipher suites for both TLS 1.2 and TLS 1.3.
transactionLifetimeLimitSeconds This property is required. Integer
changeStreamOptionsPreAndPostImagesExpireAfterSeconds This property is required. number
(Optional) The minimum pre- and post-image retention time in seconds. This parameter is only supported for MongoDB version 6.0 and above. Defaults to -1(off).
customOpensslCipherConfigTls12s This property is required. string[]
The custom OpenSSL cipher suite list for TLS 1.2. This field is only valid when tls_cipher_config_mode is set to CUSTOM.
defaultMaxTimeMs This property is required. number
defaultReadConcern This property is required. string
Default level of acknowledgment requested from MongoDB for read operations set for this cluster. MongoDB 4.4 clusters default to available.

Deprecated: This parameter is deprecated. Please refer to our examples, documentation, and 1.18.0 migration guide for more details at https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/1.18.0-upgrade-guide.html.markdown

defaultWriteConcern This property is required. string
Default level of acknowledgment requested from MongoDB for write operations set for this cluster. MongoDB 4.4 clusters default to 1.
failIndexKeyTooLong This property is required. boolean
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.

Deprecated: This parameter is deprecated. Please refer to our examples, documentation, and 1.18.0 migration guide for more details at https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/1.18.0-upgrade-guide.html.markdown

javascriptEnabled This property is required. 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.
minimumEnabledTlsProtocol This property is required. string
Sets the minimum Transport Layer Security (TLS) version the cluster accepts for incoming connections. Valid values are:
noTableScan This property is required. boolean
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.
oplogMinRetentionHours This property is required. number
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.
oplogSizeMb This property is required. number
The custom oplog size of the cluster. Without a value that indicates that the cluster uses the default oplog size calculated by Atlas.
sampleRefreshIntervalBiConnector This property is required. number
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.
sampleSizeBiConnector This property is required. number
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.
tlsCipherConfigMode This property is required. string
The TLS cipher suite configuration mode. Valid values include CUSTOM or DEFAULT. The DEFAULT mode uses the default cipher suites. The CUSTOM mode allows you to specify custom cipher suites for both TLS 1.2 and TLS 1.3.
transactionLifetimeLimitSeconds This property is required. number
change_stream_options_pre_and_post_images_expire_after_seconds This property is required. int
(Optional) The minimum pre- and post-image retention time in seconds. This parameter is only supported for MongoDB version 6.0 and above. Defaults to -1(off).
custom_openssl_cipher_config_tls12s This property is required. Sequence[str]
The custom OpenSSL cipher suite list for TLS 1.2. This field is only valid when tls_cipher_config_mode is set to CUSTOM.
default_max_time_ms This property is required. int
default_read_concern This property is required. str
Default level of acknowledgment requested from MongoDB for read operations set for this cluster. MongoDB 4.4 clusters default to available.

Deprecated: This parameter is deprecated. Please refer to our examples, documentation, and 1.18.0 migration guide for more details at https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/1.18.0-upgrade-guide.html.markdown

default_write_concern This property is required. str
Default level of acknowledgment requested from MongoDB for write operations set for this cluster. MongoDB 4.4 clusters default to 1.
fail_index_key_too_long This property is required. bool
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.

Deprecated: This parameter is deprecated. Please refer to our examples, documentation, and 1.18.0 migration guide for more details at https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/1.18.0-upgrade-guide.html.markdown

javascript_enabled This property is required. 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_tls_protocol This property is required. str
Sets the minimum Transport Layer Security (TLS) version the cluster accepts for incoming connections. Valid values are:
no_table_scan This property is required. bool
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_retention_hours This property is required. float
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.
oplog_size_mb This property is required. int
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_interval_bi_connector This property is required. int
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_bi_connector This property is required. int
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.
tls_cipher_config_mode This property is required. str
The TLS cipher suite configuration mode. Valid values include CUSTOM or DEFAULT. The DEFAULT mode uses the default cipher suites. The CUSTOM mode allows you to specify custom cipher suites for both TLS 1.2 and TLS 1.3.
transaction_lifetime_limit_seconds This property is required. int
changeStreamOptionsPreAndPostImagesExpireAfterSeconds This property is required. Number
(Optional) The minimum pre- and post-image retention time in seconds. This parameter is only supported for MongoDB version 6.0 and above. Defaults to -1(off).
customOpensslCipherConfigTls12s This property is required. List<String>
The custom OpenSSL cipher suite list for TLS 1.2. This field is only valid when tls_cipher_config_mode is set to CUSTOM.
defaultMaxTimeMs This property is required. Number
defaultReadConcern This property is required. String
Default level of acknowledgment requested from MongoDB for read operations set for this cluster. MongoDB 4.4 clusters default to available.

Deprecated: This parameter is deprecated. Please refer to our examples, documentation, and 1.18.0 migration guide for more details at https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/1.18.0-upgrade-guide.html.markdown

defaultWriteConcern This property is required. String
Default level of acknowledgment requested from MongoDB for write operations set for this cluster. MongoDB 4.4 clusters default to 1.
failIndexKeyTooLong This property is required. Boolean
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.

Deprecated: This parameter is deprecated. Please refer to our examples, documentation, and 1.18.0 migration guide for more details at https://registry.terraform.io/providers/mongodb/mongodbatlas/latest/docs/guides/1.18.0-upgrade-guide.html.markdown

javascriptEnabled This property is required. 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.
minimumEnabledTlsProtocol This property is required. String
Sets the minimum Transport Layer Security (TLS) version the cluster accepts for incoming connections. Valid values are:
noTableScan This property is required. Boolean
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.
oplogMinRetentionHours This property is required. Number
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.
oplogSizeMb This property is required. Number
The custom oplog size of the cluster. Without a value that indicates that the cluster uses the default oplog size calculated by Atlas.
sampleRefreshIntervalBiConnector This property is required. Number
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.
sampleSizeBiConnector This property is required. Number
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.
tlsCipherConfigMode This property is required. String
The TLS cipher suite configuration mode. Valid values include CUSTOM or DEFAULT. The DEFAULT mode uses the default cipher suites. The CUSTOM mode allows you to specify custom cipher suites for both TLS 1.2 and TLS 1.3.
transactionLifetimeLimitSeconds This property is required. Number

GetClustersResultBiConnectorConfig

Enabled This property is required. bool
Indicates whether or not BI Connector for Atlas is enabled on the cluster.
ReadPreference This property is required. string
Indicates 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.
Enabled This property is required. bool
Indicates whether or not BI Connector for Atlas is enabled on the cluster.
ReadPreference This property is required. string
Indicates 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.
enabled This property is required. Boolean
Indicates whether or not BI Connector for Atlas is enabled on the cluster.
readPreference This property is required. String
Indicates 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.
enabled This property is required. boolean
Indicates whether or not BI Connector for Atlas is enabled on the cluster.
readPreference This property is required. string
Indicates 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.
enabled This property is required. bool
Indicates whether or not BI Connector for Atlas is enabled on the cluster.
read_preference This property is required. str
Indicates 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.
enabled This property is required. Boolean
Indicates whether or not BI Connector for Atlas is enabled on the cluster.
readPreference This property is required. String
Indicates 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.

GetClustersResultConnectionString

AwsPrivateLink This property is required. Dictionary<string, string>
AwsPrivateLinkSrv This property is required. Dictionary<string, string>
Private This property is required. 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.
PrivateEndpoints This property is required. List<GetClustersResultConnectionStringPrivateEndpoint>
PrivateSrv This property is required. 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.

  • connection_strings.private_endpoint.#.connection_string - Private-endpoint-aware mongodb://connection string for this private endpoint.
  • connection_strings.private_endpoint.#.srv_connection_string - Private-endpoint-aware mongodb+srv:// connection string for this private endpoint.
  • connection_strings.private_endpoint.#.srv_shard_optimized_connection_string - Private endpoint-aware connection string optimized for sharded clusters that uses the mongodb+srv:// protocol to connect to MongoDB Cloud through a private endpoint.
  • connection_strings.private_endpoint.#.type - Type of MongoDB process that you connect to with the connection strings. Atlas returns MONGOD for replica sets, or MONGOS for sharded clusters.
  • connection_strings.private_endpoint.#.endpoints - Private endpoint through which you connect to Atlas when you use connection_strings.private_endpoint[#].connection_string or connection_strings.private_endpoint[#].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 returns AWS or AZURE.
  • connection_strings.private_endpoint.#.endpoints.#.region - Region to which you deployed the private endpoint.
Standard This property is required. string
Public mongodb:// connection string for this cluster.
StandardSrv This property is required. 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.
AwsPrivateLink This property is required. map[string]string
AwsPrivateLinkSrv This property is required. map[string]string
Private This property is required. 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.
PrivateEndpoints This property is required. []GetClustersResultConnectionStringPrivateEndpoint
PrivateSrv This property is required. 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.

  • connection_strings.private_endpoint.#.connection_string - Private-endpoint-aware mongodb://connection string for this private endpoint.
  • connection_strings.private_endpoint.#.srv_connection_string - Private-endpoint-aware mongodb+srv:// connection string for this private endpoint.
  • connection_strings.private_endpoint.#.srv_shard_optimized_connection_string - Private endpoint-aware connection string optimized for sharded clusters that uses the mongodb+srv:// protocol to connect to MongoDB Cloud through a private endpoint.
  • connection_strings.private_endpoint.#.type - Type of MongoDB process that you connect to with the connection strings. Atlas returns MONGOD for replica sets, or MONGOS for sharded clusters.
  • connection_strings.private_endpoint.#.endpoints - Private endpoint through which you connect to Atlas when you use connection_strings.private_endpoint[#].connection_string or connection_strings.private_endpoint[#].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 returns AWS or AZURE.
  • connection_strings.private_endpoint.#.endpoints.#.region - Region to which you deployed the private endpoint.
Standard This property is required. string
Public mongodb:// connection string for this cluster.
StandardSrv This property is required. 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.
awsPrivateLink This property is required. Map<String,String>
awsPrivateLinkSrv This property is required. Map<String,String>
privateEndpoints This property is required. List<GetClustersResultConnectionStringPrivateEndpoint>
privateSrv This property is required. 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.

  • connection_strings.private_endpoint.#.connection_string - Private-endpoint-aware mongodb://connection string for this private endpoint.
  • connection_strings.private_endpoint.#.srv_connection_string - Private-endpoint-aware mongodb+srv:// connection string for this private endpoint.
  • connection_strings.private_endpoint.#.srv_shard_optimized_connection_string - Private endpoint-aware connection string optimized for sharded clusters that uses the mongodb+srv:// protocol to connect to MongoDB Cloud through a private endpoint.
  • connection_strings.private_endpoint.#.type - Type of MongoDB process that you connect to with the connection strings. Atlas returns MONGOD for replica sets, or MONGOS for sharded clusters.
  • connection_strings.private_endpoint.#.endpoints - Private endpoint through which you connect to Atlas when you use connection_strings.private_endpoint[#].connection_string or connection_strings.private_endpoint[#].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 returns AWS or AZURE.
  • connection_strings.private_endpoint.#.endpoints.#.region - Region to which you deployed the private endpoint.
private_ This property is required. 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 This property is required. String
Public mongodb:// connection string for this cluster.
standardSrv This property is required. 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.
awsPrivateLink This property is required. {[key: string]: string}
awsPrivateLinkSrv This property is required. {[key: string]: string}
private This property is required. 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.
privateEndpoints This property is required. GetClustersResultConnectionStringPrivateEndpoint[]
privateSrv This property is required. 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.

  • connection_strings.private_endpoint.#.connection_string - Private-endpoint-aware mongodb://connection string for this private endpoint.
  • connection_strings.private_endpoint.#.srv_connection_string - Private-endpoint-aware mongodb+srv:// connection string for this private endpoint.
  • connection_strings.private_endpoint.#.srv_shard_optimized_connection_string - Private endpoint-aware connection string optimized for sharded clusters that uses the mongodb+srv:// protocol to connect to MongoDB Cloud through a private endpoint.
  • connection_strings.private_endpoint.#.type - Type of MongoDB process that you connect to with the connection strings. Atlas returns MONGOD for replica sets, or MONGOS for sharded clusters.
  • connection_strings.private_endpoint.#.endpoints - Private endpoint through which you connect to Atlas when you use connection_strings.private_endpoint[#].connection_string or connection_strings.private_endpoint[#].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 returns AWS or AZURE.
  • connection_strings.private_endpoint.#.endpoints.#.region - Region to which you deployed the private endpoint.
standard This property is required. string
Public mongodb:// connection string for this cluster.
standardSrv This property is required. 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.
aws_private_link This property is required. Mapping[str, str]
aws_private_link_srv This property is required. Mapping[str, str]
private This property is required. 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 This property is required. Sequence[GetClustersResultConnectionStringPrivateEndpoint]
private_srv This property is required. 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.

  • connection_strings.private_endpoint.#.connection_string - Private-endpoint-aware mongodb://connection string for this private endpoint.
  • connection_strings.private_endpoint.#.srv_connection_string - Private-endpoint-aware mongodb+srv:// connection string for this private endpoint.
  • connection_strings.private_endpoint.#.srv_shard_optimized_connection_string - Private endpoint-aware connection string optimized for sharded clusters that uses the mongodb+srv:// protocol to connect to MongoDB Cloud through a private endpoint.
  • connection_strings.private_endpoint.#.type - Type of MongoDB process that you connect to with the connection strings. Atlas returns MONGOD for replica sets, or MONGOS for sharded clusters.
  • connection_strings.private_endpoint.#.endpoints - Private endpoint through which you connect to Atlas when you use connection_strings.private_endpoint[#].connection_string or connection_strings.private_endpoint[#].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 returns AWS or AZURE.
  • connection_strings.private_endpoint.#.endpoints.#.region - Region to which you deployed the private endpoint.
standard This property is required. str
Public mongodb:// connection string for this cluster.
standard_srv This property is required. 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.
awsPrivateLink This property is required. Map<String>
awsPrivateLinkSrv This property is required. Map<String>
private This property is required. 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.
privateEndpoints This property is required. List<Property Map>
privateSrv This property is required. 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.

  • connection_strings.private_endpoint.#.connection_string - Private-endpoint-aware mongodb://connection string for this private endpoint.
  • connection_strings.private_endpoint.#.srv_connection_string - Private-endpoint-aware mongodb+srv:// connection string for this private endpoint.
  • connection_strings.private_endpoint.#.srv_shard_optimized_connection_string - Private endpoint-aware connection string optimized for sharded clusters that uses the mongodb+srv:// protocol to connect to MongoDB Cloud through a private endpoint.
  • connection_strings.private_endpoint.#.type - Type of MongoDB process that you connect to with the connection strings. Atlas returns MONGOD for replica sets, or MONGOS for sharded clusters.
  • connection_strings.private_endpoint.#.endpoints - Private endpoint through which you connect to Atlas when you use connection_strings.private_endpoint[#].connection_string or connection_strings.private_endpoint[#].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 returns AWS or AZURE.
  • connection_strings.private_endpoint.#.endpoints.#.region - Region to which you deployed the private endpoint.
standard This property is required. String
Public mongodb:// connection string for this cluster.
standardSrv This property is required. 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.

GetClustersResultConnectionStringPrivateEndpoint

ConnectionString This property is required. string
Endpoints This property is required. List<GetClustersResultConnectionStringPrivateEndpointEndpoint>
SrvConnectionString This property is required. string
SrvShardOptimizedConnectionString This property is required. string
Type This property is required. string
ConnectionString This property is required. string
Endpoints This property is required. []GetClustersResultConnectionStringPrivateEndpointEndpoint
SrvConnectionString This property is required. string
SrvShardOptimizedConnectionString This property is required. string
Type This property is required. string
connectionString This property is required. String
endpoints This property is required. List<GetClustersResultConnectionStringPrivateEndpointEndpoint>
srvConnectionString This property is required. String
srvShardOptimizedConnectionString This property is required. String
type This property is required. String
connectionString This property is required. string
endpoints This property is required. GetClustersResultConnectionStringPrivateEndpointEndpoint[]
srvConnectionString This property is required. string
srvShardOptimizedConnectionString This property is required. string
type This property is required. string
connection_string This property is required. str
endpoints This property is required. Sequence[GetClustersResultConnectionStringPrivateEndpointEndpoint]
srv_connection_string This property is required. str
srv_shard_optimized_connection_string This property is required. str
type This property is required. str
connectionString This property is required. String
endpoints This property is required. List<Property Map>
srvConnectionString This property is required. String
srvShardOptimizedConnectionString This property is required. String
type This property is required. String

GetClustersResultConnectionStringPrivateEndpointEndpoint

EndpointId This property is required. string
ProviderName This property is required. string
Indicates the cloud service provider on which the servers are provisioned.
Region This property is required. string
EndpointId This property is required. string
ProviderName This property is required. string
Indicates the cloud service provider on which the servers are provisioned.
Region This property is required. string
endpointId This property is required. String
providerName This property is required. String
Indicates the cloud service provider on which the servers are provisioned.
region This property is required. String
endpointId This property is required. string
providerName This property is required. string
Indicates the cloud service provider on which the servers are provisioned.
region This property is required. string
endpoint_id This property is required. str
provider_name This property is required. str
Indicates the cloud service provider on which the servers are provisioned.
region This property is required. str
endpointId This property is required. String
providerName This property is required. String
Indicates the cloud service provider on which the servers are provisioned.
region This property is required. String

GetClustersResultLabel

Key This property is required. string
The key that you want to write.
Value This property is required. string
The value that you want to write.
Key This property is required. string
The key that you want to write.
Value This property is required. string
The value that you want to write.
key This property is required. String
The key that you want to write.
value This property is required. String
The value that you want to write.
key This property is required. string
The key that you want to write.
value This property is required. string
The value that you want to write.
key This property is required. str
The key that you want to write.
value This property is required. str
The value that you want to write.
key This property is required. String
The key that you want to write.
value This property is required. String
The value that you want to write.

GetClustersResultPinnedFcv

ExpirationDate This property is required. string
Expiration date of the fixed FCV. This value is in the ISO 8601 timestamp format (e.g. "2024-12-04T16:25:00Z").
Version This property is required. string
Feature compatibility version of the cluster.
ExpirationDate This property is required. string
Expiration date of the fixed FCV. This value is in the ISO 8601 timestamp format (e.g. "2024-12-04T16:25:00Z").
Version This property is required. string
Feature compatibility version of the cluster.
expirationDate This property is required. String
Expiration date of the fixed FCV. This value is in the ISO 8601 timestamp format (e.g. "2024-12-04T16:25:00Z").
version This property is required. String
Feature compatibility version of the cluster.
expirationDate This property is required. string
Expiration date of the fixed FCV. This value is in the ISO 8601 timestamp format (e.g. "2024-12-04T16:25:00Z").
version This property is required. string
Feature compatibility version of the cluster.
expiration_date This property is required. str
Expiration date of the fixed FCV. This value is in the ISO 8601 timestamp format (e.g. "2024-12-04T16:25:00Z").
version This property is required. str
Feature compatibility version of the cluster.
expirationDate This property is required. String
Expiration date of the fixed FCV. This value is in the ISO 8601 timestamp format (e.g. "2024-12-04T16:25:00Z").
version This property is required. String
Feature compatibility version of the cluster.

GetClustersResultReplicationSpec

Id This property is required. 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.
NumShards This property is required. int
Number of shards to deploy in the specified zone.
RegionsConfigs This property is required. List<GetClustersResultReplicationSpecRegionsConfig>
Describes the 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.
ZoneName This property is required. string
Indicates the n ame for the zone in a Global Cluster.
Id This property is required. 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.
NumShards This property is required. int
Number of shards to deploy in the specified zone.
RegionsConfigs This property is required. []GetClustersResultReplicationSpecRegionsConfig
Describes the 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.
ZoneName This property is required. string
Indicates the n ame for the zone in a Global Cluster.
id This property is required. 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.
numShards This property is required. Integer
Number of shards to deploy in the specified zone.
regionsConfigs This property is required. List<GetClustersResultReplicationSpecRegionsConfig>
Describes the 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.
zoneName This property is required. String
Indicates the n ame for the zone in a Global Cluster.
id This property is required. 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.
numShards This property is required. number
Number of shards to deploy in the specified zone.
regionsConfigs This property is required. GetClustersResultReplicationSpecRegionsConfig[]
Describes the 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.
zoneName This property is required. string
Indicates the n ame for the zone in a Global Cluster.
id This property is required. 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.
num_shards This property is required. int
Number of shards to deploy in the specified zone.
regions_configs This property is required. Sequence[GetClustersResultReplicationSpecRegionsConfig]
Describes the 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 This property is required. str
Indicates the n ame for the zone in a Global Cluster.
id This property is required. 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.
numShards This property is required. Number
Number of shards to deploy in the specified zone.
regionsConfigs This property is required. List<Property Map>
Describes the 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.
zoneName This property is required. String
Indicates the n ame for the zone in a Global Cluster.

GetClustersResultReplicationSpecRegionsConfig

AnalyticsNodes This property is required. int
Indicates 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.
ElectableNodes This property is required. int
Number of electable nodes for Atlas to deploy to the region.
Priority This property is required. int
Election priority of the region. For regions with only read-only nodes, set this value to 0.
ReadOnlyNodes This property is required. int
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.
RegionName This property is required. string
Name for the region specified.
AnalyticsNodes This property is required. int
Indicates 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.
ElectableNodes This property is required. int
Number of electable nodes for Atlas to deploy to the region.
Priority This property is required. int
Election priority of the region. For regions with only read-only nodes, set this value to 0.
ReadOnlyNodes This property is required. int
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.
RegionName This property is required. string
Name for the region specified.
analyticsNodes This property is required. Integer
Indicates 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.
electableNodes This property is required. Integer
Number of electable nodes for Atlas to deploy to the region.
priority This property is required. Integer
Election priority of the region. For regions with only read-only nodes, set this value to 0.
readOnlyNodes This property is required. Integer
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.
regionName This property is required. String
Name for the region specified.
analyticsNodes This property is required. number
Indicates 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.
electableNodes This property is required. number
Number of electable nodes for Atlas to deploy to the region.
priority This property is required. number
Election priority of the region. For regions with only read-only nodes, set this value to 0.
readOnlyNodes This property is required. number
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.
regionName This property is required. string
Name for the region specified.
analytics_nodes This property is required. int
Indicates 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.
electable_nodes This property is required. int
Number of electable nodes for Atlas to deploy to the region.
priority This property is required. int
Election priority of the region. For regions with only read-only nodes, set this value to 0.
read_only_nodes This property is required. int
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 This property is required. str
Name for the region specified.
analyticsNodes This property is required. Number
Indicates 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.
electableNodes This property is required. Number
Number of electable nodes for Atlas to deploy to the region.
priority This property is required. Number
Election priority of the region. For regions with only read-only nodes, set this value to 0.
readOnlyNodes This property is required. Number
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.
regionName This property is required. String
Name for the region specified.

GetClustersResultSnapshotBackupPolicy

ClusterId This property is required. string
ClusterName This property is required. string
NextSnapshot This property is required. string
Policies This property is required. List<GetClustersResultSnapshotBackupPolicyPolicy>
ReferenceHourOfDay This property is required. int
ReferenceMinuteOfHour This property is required. int
RestoreWindowDays This property is required. int
UpdateSnapshots This property is required. bool
ClusterId This property is required. string
ClusterName This property is required. string
NextSnapshot This property is required. string
Policies This property is required. []GetClustersResultSnapshotBackupPolicyPolicy
ReferenceHourOfDay This property is required. int
ReferenceMinuteOfHour This property is required. int
RestoreWindowDays This property is required. int
UpdateSnapshots This property is required. bool
clusterId This property is required. String
clusterName This property is required. String
nextSnapshot This property is required. String
policies This property is required. List<GetClustersResultSnapshotBackupPolicyPolicy>
referenceHourOfDay This property is required. Integer
referenceMinuteOfHour This property is required. Integer
restoreWindowDays This property is required. Integer
updateSnapshots This property is required. Boolean
clusterId This property is required. string
clusterName This property is required. string
nextSnapshot This property is required. string
policies This property is required. GetClustersResultSnapshotBackupPolicyPolicy[]
referenceHourOfDay This property is required. number
referenceMinuteOfHour This property is required. number
restoreWindowDays This property is required. number
updateSnapshots This property is required. boolean
cluster_id This property is required. str
cluster_name This property is required. str
next_snapshot This property is required. str
policies This property is required. Sequence[GetClustersResultSnapshotBackupPolicyPolicy]
reference_hour_of_day This property is required. int
reference_minute_of_hour This property is required. int
restore_window_days This property is required. int
update_snapshots This property is required. bool
clusterId This property is required. String
clusterName This property is required. String
nextSnapshot This property is required. String
policies This property is required. List<Property Map>
referenceHourOfDay This property is required. Number
referenceMinuteOfHour This property is required. Number
restoreWindowDays This property is required. Number
updateSnapshots This property is required. Boolean

GetClustersResultSnapshotBackupPolicyPolicy

Id This property is required. 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.
PolicyItems This property is required. List<GetClustersResultSnapshotBackupPolicyPolicyPolicyItem>
Id This property is required. 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.
PolicyItems This property is required. []GetClustersResultSnapshotBackupPolicyPolicyPolicyItem
id This property is required. 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.
policyItems This property is required. List<GetClustersResultSnapshotBackupPolicyPolicyPolicyItem>
id This property is required. 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.
policyItems This property is required. GetClustersResultSnapshotBackupPolicyPolicyPolicyItem[]
id This property is required. 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 This property is required. Sequence[GetClustersResultSnapshotBackupPolicyPolicyPolicyItem]
id This property is required. 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.
policyItems This property is required. List<Property Map>

GetClustersResultSnapshotBackupPolicyPolicyPolicyItem

FrequencyInterval This property is required. int
FrequencyType This property is required. string
Id This property is required. 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.
RetentionUnit This property is required. string
RetentionValue This property is required. int
FrequencyInterval This property is required. int
FrequencyType This property is required. string
Id This property is required. 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.
RetentionUnit This property is required. string
RetentionValue This property is required. int
frequencyInterval This property is required. Integer
frequencyType This property is required. String
id This property is required. 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.
retentionUnit This property is required. String
retentionValue This property is required. Integer
frequencyInterval This property is required. number
frequencyType This property is required. string
id This property is required. 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.
retentionUnit This property is required. string
retentionValue This property is required. number
frequency_interval This property is required. int
frequency_type This property is required. str
id This property is required. 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 This property is required. str
retention_value This property is required. int
frequencyInterval This property is required. Number
frequencyType This property is required. String
id This property is required. 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.
retentionUnit This property is required. String
retentionValue This property is required. Number

GetClustersResultTag

Key This property is required. string
The key that you want to write.
Value This property is required. string
The value that you want to write.
Key This property is required. string
The key that you want to write.
Value This property is required. string
The value that you want to write.
key This property is required. String
The key that you want to write.
value This property is required. String
The value that you want to write.
key This property is required. string
The key that you want to write.
value This property is required. string
The value that you want to write.
key This property is required. str
The key that you want to write.
value This property is required. str
The value that you want to write.
key This property is required. String
The key that you want to write.
value This property is required. String
The value that you want to write.

Package Details

Repository
MongoDB Atlas pulumi/pulumi-mongodbatlas
License
Apache-2.0
Notes
This Pulumi package is based on the mongodbatlas Terraform Provider.