Want to learn about running containers in Lambda? Join our free hands-on workshop. Register Now

GetClusters

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

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

IMPORTANT:
• 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.

Example Usage

using Pulumi;
using Mongodbatlas = Pulumi.Mongodbatlas;

class MyStack : Stack
{
    public MyStack()
    {
        var testCluster = new Mongodbatlas.Cluster("testCluster", new Mongodbatlas.ClusterArgs
        {
            ProjectId = "<YOUR-PROJECT-ID>",
            DiskSizeGb = 100,
            NumShards = 1,
            ReplicationFactor = 3,
            ProviderBackupEnabled = true,
            AutoScalingDiskGbEnabled = true,
            ProviderName = "AWS",
            ProviderDiskIops = 300,
            ProviderVolumeType = "STANDARD",
            ProviderEncryptEbsVolume = true,
            ProviderInstanceSizeName = "M40",
            ProviderRegionName = "US_EAST_1",
        });
        var testClusters = testCluster.ProjectId.Apply(projectId => Mongodbatlas.GetClusters.InvokeAsync(new Mongodbatlas.GetClustersArgs
        {
            ProjectId = projectId,
        }));
    }

}
package main

import (
    "github.com/pulumi/pulumi-mongodbatlas/sdk/go/mongodbatlas"
    "github.com/pulumi/pulumi/sdk/v2/go/pulumi"
)

func main() {
    pulumi.Run(func(ctx *pulumi.Context) error {
        testCluster, err := mongodbatlas.NewCluster(ctx, "testCluster", &mongodbatlas.ClusterArgs{
            ProjectId:                pulumi.String("<YOUR-PROJECT-ID>"),
            DiskSizeGb:               pulumi.Float64(100),
            NumShards:                pulumi.Int(1),
            ReplicationFactor:        pulumi.Int(3),
            ProviderBackupEnabled:    pulumi.Bool(true),
            AutoScalingDiskGbEnabled: pulumi.Bool(true),
            ProviderName:             pulumi.String("AWS"),
            ProviderDiskIops:         pulumi.Int(300),
            ProviderVolumeType:       pulumi.String("STANDARD"),
            ProviderEncryptEbsVolume: pulumi.Bool(true),
            ProviderInstanceSizeName: pulumi.String("M40"),
            ProviderRegionName:       pulumi.String("US_EAST_1"),
        })
        if err != nil {
            return err
        }
        return nil
    })
}
import pulumi
import pulumi_mongodbatlas as mongodbatlas

test_cluster = mongodbatlas.Cluster("testCluster",
    project_id="<YOUR-PROJECT-ID>",
    disk_size_gb=100,
    num_shards=1,
    replication_factor=3,
    provider_backup_enabled=True,
    auto_scaling_disk_gb_enabled=True,
    provider_name="AWS",
    provider_disk_iops=300,
    provider_volume_type="STANDARD",
    provider_encrypt_ebs_volume=True,
    provider_instance_size_name="M40",
    provider_region_name="US_EAST_1")
test_clusters = test_cluster.project_id.apply(lambda project_id: mongodbatlas.get_clusters(project_id=project_id))
import * as pulumi from "@pulumi/pulumi";
import * as mongodbatlas from "@pulumi/mongodbatlas";

const testCluster = new mongodbatlas.Cluster("testCluster", {
    projectId: "<YOUR-PROJECT-ID>",
    diskSizeGb: 100,
    numShards: 1,
    replicationFactor: 3,
    providerBackupEnabled: true,
    autoScalingDiskGbEnabled: true,
    providerName: "AWS",
    providerDiskIops: 300,
    providerVolumeType: "STANDARD",
    providerEncryptEbsVolume: true,
    providerInstanceSizeName: "M40",
    providerRegionName: "US_EAST_1",
});
const testClusters = testCluster.projectId.apply(projectId => mongodbatlas.getClusters({
    projectId: projectId,
}));

Using GetClusters

function getClusters(args: GetClustersArgs, opts?: InvokeOptions): Promise<GetClustersResult>
def get_clusters(project_id: Optional[str] = None, opts: Optional[InvokeOptions] = None) -> GetClustersResult
func GetClusters(ctx *Context, args *GetClustersArgs, opts ...InvokeOption) (*GetClustersResult, error)
public static class GetClusters {
    public static Task<GetClustersResult> InvokeAsync(GetClustersArgs args, InvokeOptions? opts = null)
}

The following arguments are supported:

ProjectId string

The unique ID for the project to get the clusters.

ProjectId string

The unique ID for the project to get the clusters.

projectId string

The unique ID for the project to get the clusters.

project_id str

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 []GetClustersResultType

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.

Supporting Types

GetClustersResult

See the output API doc for this type.

See the output API doc for this type.

See the output API doc for this type.

AutoScalingComputeEnabled bool

(Optional) Specifies whether cluster tier auto-scaling is enabled. The default is false.

AutoScalingComputeScaleDownEnabled bool

(Optional) Set to true to enable the cluster tier to scale down.

AutoScalingDiskGbEnabled bool

Indicates whether disk auto-scaling is enabled.

BackingProviderName string

Indicates Cloud service provider on which the server for a multi-tenant cluster is provisioned.

BackupEnabled bool

Legacy Option, Indicates whether Atlas continuous backups are enabled for the cluster.

BiConnector GetClustersResultBiConnectorArgs

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 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 GetClustersResultConnectionStringsArgs

Set of connection strings that your applications use to connect to this cluster. More info in Connection-strings. Use the parameters in this object to connect your applications to this cluster. To learn more about the formats of connection strings, see Connection String Options. NOTE: Atlas returns the contents of this object after the cluster is operational, not while it builds the cluster. - connection_strings.standard - Public mongodb:// connection string for this cluster. - connection_strings.standard_srv - 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. - connection_strings.aws_private_link - Private-endpoint-aware mongodb://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a AWS PrivateLink connection to this cluster. - connection_strings.aws_private_link_srv - Private-endpoint-aware mongodb+srv://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a AWS PrivateLink connection to this cluster. Use this URI format if your driver supports it. If it doesn’t, use connectionStrings.awsPrivateLink. - connection_strings.private - 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. - connection_strings.private_srv - 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.

ContainerId string

The Network Peering Container ID.

DiskSizeGb double

Indicates the size in gigabytes of the server’s root volume (AWS/GCP Only).

EncryptionAtRestProvider string

Indicates whether Encryption at Rest is enabled or disabled.

Labels List<GetClustersResultLabelArgs>
MongoDbMajorVersion string

Indicates the version of the cluster to deploy.

MongoDbVersion string

Version of MongoDB the cluster runs, in major-version.minor-version format.

MongoUri string

Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.

MongoUriUpdated 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 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 string

The name of the current plugin

NumShards int

Number of shards to deploy in the specified zone.

Paused bool

Flag that indicates whether the cluster is paused or not.

PitEnabled bool

Flag that indicates if the cluster uses Continuous Cloud Backup.

ProviderAutoScalingComputeMaxInstanceSize string

(Optional) Maximum instance size to which your cluster can automatically scale.

ProviderAutoScalingComputeMinInstanceSize string

(Optional) Minimum instance size to which your cluster can automatically scale.

ProviderBackupEnabled bool

Flag indicating if the cluster uses Cloud Backup Snapshots for backups.

ProviderDiskIops 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 string

Describes Azure disk type of the server’s root volume (Azure Only).

ProviderEncryptEbsVolume bool

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.

ProviderInstanceSizeName string

Atlas provides different instance sizes, each with a default storage capacity and RAM size.

ProviderName string

Indicates the cloud service provider on which the servers are provisioned.

ProviderRegionName 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 string

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

ReplicationFactor int

Number of replica set members. Each member keeps a copy of your databases, providing high availability and data redundancy. The possible values are 3, 5, or 7. The default value is 3.

ReplicationSpecs List<GetClustersResultReplicationSpecArgs>

Configuration for cluster regions. See Replication Spec below for more details.

SnapshotBackupPolicies List<GetClustersResultSnapshotBackupPolicyArgs>

current snapshot schedule and retention settings for the cluster.

SrvAddress 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 string

Indicates the current state of the cluster. The possible states are: - IDLE - CREATING - UPDATING - DELETING - DELETED - REPAIRING

AutoScalingComputeEnabled bool

(Optional) Specifies whether cluster tier auto-scaling is enabled. The default is false.

AutoScalingComputeScaleDownEnabled bool

(Optional) Set to true to enable the cluster tier to scale down.

AutoScalingDiskGbEnabled bool

Indicates whether disk auto-scaling is enabled.

BackingProviderName string

Indicates Cloud service provider on which the server for a multi-tenant cluster is provisioned.

BackupEnabled bool

Legacy Option, Indicates whether Atlas continuous backups are enabled for the cluster.

BiConnector GetClustersResultBiConnector

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 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 GetClustersResultConnectionStrings

Set of connection strings that your applications use to connect to this cluster. More info in Connection-strings. Use the parameters in this object to connect your applications to this cluster. To learn more about the formats of connection strings, see Connection String Options. NOTE: Atlas returns the contents of this object after the cluster is operational, not while it builds the cluster. - connection_strings.standard - Public mongodb:// connection string for this cluster. - connection_strings.standard_srv - 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. - connection_strings.aws_private_link - Private-endpoint-aware mongodb://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a AWS PrivateLink connection to this cluster. - connection_strings.aws_private_link_srv - Private-endpoint-aware mongodb+srv://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a AWS PrivateLink connection to this cluster. Use this URI format if your driver supports it. If it doesn’t, use connectionStrings.awsPrivateLink. - connection_strings.private - 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. - connection_strings.private_srv - 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.

ContainerId string

The Network Peering Container ID.

DiskSizeGb float64

Indicates the size in gigabytes of the server’s root volume (AWS/GCP Only).

EncryptionAtRestProvider string

Indicates whether Encryption at Rest is enabled or disabled.

Labels []GetClustersResultLabel
MongoDbMajorVersion string

Indicates the version of the cluster to deploy.

MongoDbVersion string

Version of MongoDB the cluster runs, in major-version.minor-version format.

MongoUri string

Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.

MongoUriUpdated 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 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 string

The name of the current plugin

NumShards int

Number of shards to deploy in the specified zone.

Paused bool

Flag that indicates whether the cluster is paused or not.

PitEnabled bool

Flag that indicates if the cluster uses Continuous Cloud Backup.

ProviderAutoScalingComputeMaxInstanceSize string

(Optional) Maximum instance size to which your cluster can automatically scale.

ProviderAutoScalingComputeMinInstanceSize string

(Optional) Minimum instance size to which your cluster can automatically scale.

ProviderBackupEnabled bool

Flag indicating if the cluster uses Cloud Backup Snapshots for backups.

ProviderDiskIops 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 string

Describes Azure disk type of the server’s root volume (Azure Only).

ProviderEncryptEbsVolume bool

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.

ProviderInstanceSizeName string

Atlas provides different instance sizes, each with a default storage capacity and RAM size.

ProviderName string

Indicates the cloud service provider on which the servers are provisioned.

ProviderRegionName 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 string

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

ReplicationFactor int

Number of replica set members. Each member keeps a copy of your databases, providing high availability and data redundancy. The possible values are 3, 5, or 7. The default value is 3.

ReplicationSpecs []GetClustersResultReplicationSpec

Configuration for cluster regions. See Replication Spec below for more details.

SnapshotBackupPolicies []GetClustersResultSnapshotBackupPolicy

current snapshot schedule and retention settings for the cluster.

SrvAddress 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 string

Indicates the current state of the cluster. The possible states are: - IDLE - CREATING - UPDATING - DELETING - DELETED - REPAIRING

autoScalingComputeEnabled boolean

(Optional) Specifies whether cluster tier auto-scaling is enabled. The default is false.

autoScalingComputeScaleDownEnabled boolean

(Optional) Set to true to enable the cluster tier to scale down.

autoScalingDiskGbEnabled boolean

Indicates whether disk auto-scaling is enabled.

backingProviderName string

Indicates Cloud service provider on which the server for a multi-tenant cluster is provisioned.

backupEnabled boolean

Legacy Option, Indicates whether Atlas continuous backups are enabled for the cluster.

biConnector GetClustersResultBiConnector

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 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 GetClustersResultConnectionStrings

Set of connection strings that your applications use to connect to this cluster. More info in Connection-strings. Use the parameters in this object to connect your applications to this cluster. To learn more about the formats of connection strings, see Connection String Options. NOTE: Atlas returns the contents of this object after the cluster is operational, not while it builds the cluster. - connection_strings.standard - Public mongodb:// connection string for this cluster. - connection_strings.standard_srv - 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. - connection_strings.aws_private_link - Private-endpoint-aware mongodb://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a AWS PrivateLink connection to this cluster. - connection_strings.aws_private_link_srv - Private-endpoint-aware mongodb+srv://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a AWS PrivateLink connection to this cluster. Use this URI format if your driver supports it. If it doesn’t, use connectionStrings.awsPrivateLink. - connection_strings.private - 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. - connection_strings.private_srv - 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.

containerId string

The Network Peering Container ID.

diskSizeGb number

Indicates the size in gigabytes of the server’s root volume (AWS/GCP Only).

encryptionAtRestProvider string

Indicates whether Encryption at Rest is enabled or disabled.

labels GetClustersResultLabel[]
mongoDbMajorVersion string

Indicates the version of the cluster to deploy.

mongoDbVersion string

Version of MongoDB the cluster runs, in major-version.minor-version format.

mongoUri string

Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.

mongoUriUpdated 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 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 string

The name of the current plugin

numShards number

Number of shards to deploy in the specified zone.

paused boolean

Flag that indicates whether the cluster is paused or not.

pitEnabled boolean

Flag that indicates if the cluster uses Continuous Cloud Backup.

providerAutoScalingComputeMaxInstanceSize string

(Optional) Maximum instance size to which your cluster can automatically scale.

providerAutoScalingComputeMinInstanceSize string

(Optional) Minimum instance size to which your cluster can automatically scale.

providerBackupEnabled boolean

Flag indicating if the cluster uses Cloud Backup Snapshots for backups.

providerDiskIops 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 string

Describes Azure disk type of the server’s root volume (Azure Only).

providerEncryptEbsVolume boolean

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.

providerInstanceSizeName string

Atlas provides different instance sizes, each with a default storage capacity and RAM size.

providerName string

Indicates the cloud service provider on which the servers are provisioned.

providerRegionName 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 string

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

replicationFactor number

Number of replica set members. Each member keeps a copy of your databases, providing high availability and data redundancy. The possible values are 3, 5, or 7. The default value is 3.

replicationSpecs GetClustersResultReplicationSpec[]

Configuration for cluster regions. See Replication Spec below for more details.

snapshotBackupPolicies GetClustersResultSnapshotBackupPolicy[]

current snapshot schedule and retention settings for the cluster.

srvAddress 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 string

Indicates the current state of the cluster. The possible states are: - IDLE - CREATING - UPDATING - DELETING - DELETED - REPAIRING

auto_scaling_compute_enabled bool

(Optional) Specifies whether cluster tier auto-scaling is enabled. The default is false.

auto_scaling_compute_scale_down_enabled bool

(Optional) Set to true to enable the cluster tier to scale down.

auto_scaling_disk_gb_enabled bool

Indicates whether disk auto-scaling is enabled.

backing_provider_name str

Indicates Cloud service provider on which the server for a multi-tenant cluster is provisioned.

backup_enabled bool

Legacy Option, Indicates whether Atlas continuous backups are enabled for the cluster.

bi_connector GetClustersResultBiConnectorArgs

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 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 GetClustersResultConnectionStringsArgs

Set of connection strings that your applications use to connect to this cluster. More info in Connection-strings. Use the parameters in this object to connect your applications to this cluster. To learn more about the formats of connection strings, see Connection String Options. NOTE: Atlas returns the contents of this object after the cluster is operational, not while it builds the cluster. - connection_strings.standard - Public mongodb:// connection string for this cluster. - connection_strings.standard_srv - 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. - connection_strings.aws_private_link - Private-endpoint-aware mongodb://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a AWS PrivateLink connection to this cluster. - connection_strings.aws_private_link_srv - Private-endpoint-aware mongodb+srv://connection strings for each interface VPC endpoint you configured to connect to this cluster. Returned only if you created a AWS PrivateLink connection to this cluster. Use this URI format if your driver supports it. If it doesn’t, use connectionStrings.awsPrivateLink. - connection_strings.private - 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. - connection_strings.private_srv - 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.

container_id str

The Network Peering Container ID.

disk_size_gb float

Indicates the size in gigabytes of the server’s root volume (AWS/GCP Only).

encryption_at_rest_provider str

Indicates whether Encryption at Rest is enabled or disabled.

labels Sequence[GetClustersResultLabelArgs]
mongo_db_major_version str

Indicates the version of the cluster to deploy.

mongo_db_version str

Version of MongoDB the cluster runs, in major-version.minor-version format.

mongo_uri str

Base connection string for the cluster. Atlas only displays this field after the cluster is operational, not while it builds the cluster.

mongo_uri_updated 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 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 str

The name of the current plugin

num_shards int

Number of shards to deploy in the specified zone.

paused bool

Flag that indicates whether the cluster is paused or not.

pit_enabled bool

Flag that indicates if the cluster uses Continuous Cloud Backup.

provider_auto_scaling_compute_max_instance_size str

(Optional) Maximum instance size to which your cluster can automatically scale.

provider_auto_scaling_compute_min_instance_size str

(Optional) Minimum instance size to which your cluster can automatically scale.

provider_backup_enabled bool

Flag indicating if the cluster uses Cloud Backup Snapshots for backups.

provider_disk_iops 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 str

Describes Azure disk type of the server’s root volume (Azure Only).

provider_encrypt_ebs_volume bool

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.

provider_instance_size_name str

Atlas provides different instance sizes, each with a default storage capacity and RAM size.

provider_name str

Indicates the cloud service provider on which the servers are provisioned.

provider_region_name 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 str

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

replication_factor int

Number of replica set members. Each member keeps a copy of your databases, providing high availability and data redundancy. The possible values are 3, 5, or 7. The default value is 3.

replication_specs Sequence[GetClustersResultReplicationSpecArgs]

Configuration for cluster regions. See Replication Spec below for more details.

snapshot_backup_policies Sequence[GetClustersResultSnapshotBackupPolicyArgs]

current snapshot schedule and retention settings for the cluster.

srv_address str

Connection string for connecting to the Atlas cluster. The +srv modifier forces the connection to use TLS/SSL. See the mongoURI for additional options.

state_name str

Indicates the current state of the cluster. The possible states are: - IDLE - CREATING - UPDATING - DELETING - DELETED - REPAIRING

GetClustersResultBiConnector

See the output API doc for this type.

See the output API doc for this type.

See the output API doc for this type.

Enabled string

Indicates whether or not BI Connector for Atlas is enabled on the cluster.

ReadPreference 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 string

Indicates whether or not BI Connector for Atlas is enabled on the cluster.

ReadPreference 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 string

Indicates whether or not BI Connector for Atlas is enabled on the cluster.

readPreference 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 str

Indicates whether or not BI Connector for Atlas is enabled on the cluster.

read_preference 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.

GetClustersResultConnectionStrings

See the output API doc for this type.

See the output API doc for this type.

See the output API doc for this type.

AwsPrivateLink Dictionary<string, object>
AwsPrivateLinkSrv Dictionary<string, object>
Private string
PrivateSrv string
Standard string
StandardSrv string
AwsPrivateLink map[string]interface{}
AwsPrivateLinkSrv map[string]interface{}
Private string
PrivateSrv string
Standard string
StandardSrv string
awsPrivateLink {[key: string]: any}
awsPrivateLinkSrv {[key: string]: any}
private string
privateSrv string
standard string
standardSrv string
aws_private_link Mapping[str, Any]
aws_private_link_srv Mapping[str, Any]
private str
private_srv str
standard str
standard_srv str

GetClustersResultLabel

See the output API doc for this type.

See the output API doc for this type.

See the output API doc for this type.

Key string

The key that was set.

Value string

The value that represents the key.

Key string

The key that was set.

Value string

The value that represents the key.

key string

The key that was set.

value string

The value that represents the key.

key str

The key that was set.

value str

The value that represents the key.

GetClustersResultReplicationSpec

See the output API doc for this type.

See the output API doc for this type.

See the output API doc for this type.

Id string

Unique identifer of the replication document for a zone in a Global Cluster.

NumShards int

Number of shards to deploy in the specified zone.

RegionsConfigs List<GetClustersResultReplicationSpecRegionsConfigArgs>

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 string

Indicates the n ame for the zone in a Global Cluster.

Id string

Unique identifer of the replication document for a zone in a Global Cluster.

NumShards int

Number of shards to deploy in the specified zone.

RegionsConfigs []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 string

Indicates the n ame for the zone in a Global Cluster.

id string

Unique identifer of the replication document for a zone in a Global Cluster.

numShards number

Number of shards to deploy in the specified zone.

regionsConfigs 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 string

Indicates the n ame for the zone in a Global Cluster.

id str

Unique identifer of the replication document for a zone in a Global Cluster.

num_shards int

Number of shards to deploy in the specified zone.

regions_configs Sequence[GetClustersResultReplicationSpecRegionsConfigArgs]

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 str

Indicates the n ame for the zone in a Global Cluster.

GetClustersResultReplicationSpecRegionsConfig

See the output API doc for this type.

See the output API doc for this type.

See the output API doc for this type.

AnalyticsNodes 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 int

Number of electable nodes for Atlas to deploy to the region.

Priority int

Election priority of the region. For regions with only read-only nodes, set this value to 0.

ReadOnlyNodes 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 string

Name for the region specified.

AnalyticsNodes 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 int

Number of electable nodes for Atlas to deploy to the region.

Priority int

Election priority of the region. For regions with only read-only nodes, set this value to 0.

ReadOnlyNodes 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 string

Name for the region specified.

analyticsNodes 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 number

Number of electable nodes for Atlas to deploy to the region.

priority number

Election priority of the region. For regions with only read-only nodes, set this value to 0.

readOnlyNodes 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 string

Name for the region specified.

analytics_nodes 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 int

Number of electable nodes for Atlas to deploy to the region.

priority int

Election priority of the region. For regions with only read-only nodes, set this value to 0.

read_only_nodes 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 str

Name for the region specified.

GetClustersResultSnapshotBackupPolicy

See the output API doc for this type.

See the output API doc for this type.

See the output API doc for this type.

ClusterId string
ClusterName string
NextSnapshot string
Policies List<GetClustersResultSnapshotBackupPolicyPolicyArgs>
ReferenceHourOfDay int
ReferenceMinuteOfHour int
RestoreWindowDays int
UpdateSnapshots bool
ClusterId string
ClusterName string
NextSnapshot string
Policies []GetClustersResultSnapshotBackupPolicyPolicy
ReferenceHourOfDay int
ReferenceMinuteOfHour int
RestoreWindowDays int
UpdateSnapshots bool
clusterId string
clusterName string
nextSnapshot string
policies GetClustersResultSnapshotBackupPolicyPolicy[]
referenceHourOfDay number
referenceMinuteOfHour number
restoreWindowDays number
updateSnapshots boolean
cluster_id str
cluster_name str
next_snapshot str
policies Sequence[GetClustersResultSnapshotBackupPolicyPolicyArgs]
reference_hour_of_day int
reference_minute_of_hour int
restore_window_days int
update_snapshots bool

GetClustersResultSnapshotBackupPolicyPolicy

See the output API doc for this type.

See the output API doc for this type.

See the output API doc for this type.

Id string

Unique identifer of the replication document for a zone in a Global Cluster.

PolicyItems List<GetClustersResultSnapshotBackupPolicyPolicyPolicyItemArgs>
Id string

Unique identifer of the replication document for a zone in a Global Cluster.

PolicyItems []GetClustersResultSnapshotBackupPolicyPolicyPolicyItem
id string

Unique identifer of the replication document for a zone in a Global Cluster.

policyItems GetClustersResultSnapshotBackupPolicyPolicyPolicyItem[]
id str

Unique identifer of the replication document for a zone in a Global Cluster.

policy_items Sequence[GetClustersResultSnapshotBackupPolicyPolicyPolicyItemArgs]

GetClustersResultSnapshotBackupPolicyPolicyPolicyItem

See the output API doc for this type.

See the output API doc for this type.

See the output API doc for this type.

FrequencyInterval int
FrequencyType string
Id string

Unique identifer of the replication document for a zone in a Global Cluster.

RetentionUnit string
RetentionValue int
FrequencyInterval int
FrequencyType string
Id string

Unique identifer of the replication document for a zone in a Global Cluster.

RetentionUnit string
RetentionValue int
frequencyInterval number
frequencyType string
id string

Unique identifer of the replication document for a zone in a Global Cluster.

retentionUnit string
retentionValue number
frequency_interval int
frequency_type str
id str

Unique identifer of the replication document for a zone in a Global Cluster.

retention_unit str
retention_value int

Package Details

Repository
https://github.com/pulumi/pulumi-mongodbatlas
License
Apache-2.0
Notes
This Pulumi package is based on the mongodbatlas Terraform Provider.