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: Themongodbatlas.Cluster
data source doesn’t return thecontainer_id
for each region utilized by the cluster. For retrieving thecontainer_id
, we recommend themongodbatlas.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,
});
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)
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
})
}
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,
});
});
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());
}
}
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}
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>
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]
func LookupClusters(ctx *Context, args *LookupClustersArgs, opts ...InvokeOption) (*LookupClustersResult, error)
func LookupClustersOutput(ctx *Context, args *LookupClustersOutputArgs, opts ...InvokeOption) LookupClustersResultOutput
> 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)
}
public static CompletableFuture<GetClustersResult> getClusters(GetClustersArgs args, InvokeOptions options)
public static Output<GetClustersResult> getClusters(GetClustersArgs args, InvokeOptions options)
fn::invoke:
function: mongodbatlas:index/getClusters:getClusters
arguments:
# arguments dictionary
The following arguments are supported:
- Project
Id This property is required. string - The unique ID for the project to get the clusters.
- Project
Id This property is required. string - The unique ID for the project to get the clusters.
- project
Id This property is required. String - The unique ID for the project to get the clusters.
- project
Id 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.
- project
Id 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.
- Project
Id string - Results
List<Get
Clusters Result> - A list where each represents a Cluster. See Cluster below for more details.
- Id string
- The provider-assigned unique ID for this managed resource.
- Project
Id string - Results
[]Get
Clusters Result - A list where each represents a Cluster. See Cluster below for more details.
- id String
- The provider-assigned unique ID for this managed resource.
- project
Id String - results
List<Get
Clusters Result> - A list where each represents a Cluster. See Cluster below for more details.
- id string
- The provider-assigned unique ID for this managed resource.
- project
Id string - results
Get
Clusters Result[] - 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[Get
Clusters Result] - A list where each represents a Cluster. See Cluster below for more details.
- id String
- The provider-assigned unique ID for this managed resource.
- project
Id String - results List<Property Map>
- A list where each represents a Cluster. See Cluster below for more details.
Supporting Types
GetClustersResult
- Advanced
Configurations This property is required. List<GetClusters Result Advanced Configuration> - 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. string - 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. List<GetClusters Result Bi Connector Config> - 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. string - 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. List<GetClusters Result Connection String> - 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. string - The Network Peering Container ID.
- Disk
Size Gb This property is required. double - Indicates the size in gigabytes of the server’s root volume (AWS/GCP Only).
- Encryption
At Rest Provider This property is required. string - Indicates whether Encryption at Rest is enabled or disabled.
- Labels
This property is required. List<GetClusters Result Label> - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below. DEPRECATED Use
tags
instead. - Mongo
Db Major Version This property is required. string - Indicates the version of the cluster to deploy.
- Mongo
Db Version This property is required. string - Version of MongoDB the cluster runs, in
major-version
.minor-version
format. - Mongo
Uri 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.
- Mongo
Uri Updated 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.
- Mongo
Uri With Options 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
- 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. List<GetClusters Result Pinned Fcv> - 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. string - Maximum instance size to which your cluster can automatically scale.
- Provider
Auto Scaling Compute Min Instance Size This property is required. string - 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. string - 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. string - Atlas provides different instance sizes, each with a default storage capacity and RAM size.
- Provider
Name This property is required. string - Indicates the cloud service provider on which the servers are provisioned.
- Provider
Region Name 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.
- Provider
Volume Type This property is required. string Indicates the type of the volume. The possible values are:
STANDARD
andPROVISIONED
.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. List<GetClusters Result Replication Spec> - Configuration for cluster regions. See Replication Spec below for more details.
- Snapshot
Backup Policies This property is required. List<GetClusters Result Snapshot Backup Policy> - current snapshot schedule and retention settings for the cluster.
- Srv
Address 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.
- State
Name This property is required. string - Indicates the current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
This property is required. List<GetClusters Result Tag> - 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. string - Release cadence that Atlas uses for this cluster.
- Advanced
Configurations This property is required. []GetClusters Result Advanced Configuration - 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. string - 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. []GetClusters Result Bi Connector Config - 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. string - 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. []GetClusters Result Connection String - 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. string - The Network Peering Container ID.
- Disk
Size Gb This property is required. float64 - Indicates the size in gigabytes of the server’s root volume (AWS/GCP Only).
- Encryption
At Rest Provider This property is required. string - Indicates whether Encryption at Rest is enabled or disabled.
- Labels
This property is required. []GetClusters Result Label - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below. DEPRECATED Use
tags
instead. - Mongo
Db Major Version This property is required. string - Indicates the version of the cluster to deploy.
- Mongo
Db Version This property is required. string - Version of MongoDB the cluster runs, in
major-version
.minor-version
format. - Mongo
Uri 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.
- Mongo
Uri Updated 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.
- Mongo
Uri With Options 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
- 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. []GetClusters Result Pinned Fcv - 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. string - Maximum instance size to which your cluster can automatically scale.
- Provider
Auto Scaling Compute Min Instance Size This property is required. string - 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. string - 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. string - Atlas provides different instance sizes, each with a default storage capacity and RAM size.
- Provider
Name This property is required. string - Indicates the cloud service provider on which the servers are provisioned.
- Provider
Region Name 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.
- Provider
Volume Type This property is required. string Indicates the type of the volume. The possible values are:
STANDARD
andPROVISIONED
.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. []GetClusters Result Replication Spec - Configuration for cluster regions. See Replication Spec below for more details.
- Snapshot
Backup Policies This property is required. []GetClusters Result Snapshot Backup Policy - current snapshot schedule and retention settings for the cluster.
- Srv
Address 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.
- State
Name This property is required. string - Indicates the current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
This property is required. []GetClusters Result Tag - 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. string - Release cadence that Atlas uses for this cluster.
- advanced
Configurations This property is required. List<GetClusters Result Advanced Configuration> - Get the advanced configuration options. See Advanced Configuration below for more details.
- auto
Scaling Compute Enabled This property is required. Boolean - Specifies whether cluster tier auto-scaling is enabled. The default is false.
- auto
Scaling Compute Scale Down Enabled This property is required. Boolean auto_scaling_compute_scale_down_enabled
- Specifies whether cluster tier auto-down-scaling is enabled.
- auto
Scaling Disk Gb Enabled This property is required. Boolean - Indicates whether disk auto-scaling is enabled.
- backing
Provider Name This property is required. String - Indicates Cloud service provider on which the server for a multi-tenant cluster is provisioned.
- backup
Enabled This property is required. Boolean - Legacy Option, Indicates whether Atlas continuous backups are enabled for the cluster.
- bi
Connector Configs This property is required. List<GetClusters Result Bi Connector Config> - 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. String - 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. List<GetClusters Result Connection String> - 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. String - The Network Peering Container ID.
- disk
Size Gb This property is required. Double - Indicates the size in gigabytes of the server’s root volume (AWS/GCP Only).
- encryption
At Rest Provider This property is required. String - Indicates whether Encryption at Rest is enabled or disabled.
- labels
This property is required. List<GetClusters Result Label> - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below. DEPRECATED Use
tags
instead. - mongo
Db Major Version This property is required. String - Indicates the version of the cluster to deploy.
- mongo
Db Version This property is required. String - Version of MongoDB the cluster runs, in
major-version
.minor-version
format. - mongo
Uri 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.
- mongo
Uri Updated 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.
- mongo
Uri With Options 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
- num
Shards 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.
- pinned
Fcvs This property is required. List<GetClusters Result Pinned Fcv> - The pinned Feature Compatibility Version (FCV) with its associated expiration date. See below.
- pit
Enabled This property is required. Boolean - Flag that indicates if the cluster uses Continuous Cloud Backup.
- provider
Auto Scaling Compute Max Instance Size This property is required. String - Maximum instance size to which your cluster can automatically scale.
- provider
Auto Scaling Compute Min Instance Size This property is required. String - Minimum instance size to which your cluster can automatically scale.
- provider
Backup Enabled This property is required. Boolean - Flag indicating if the cluster uses Cloud Backup Snapshots for backups. DEPRECATED Use
cloud_backup
instead. - provider
Disk Iops 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.
- provider
Disk Type Name This property is required. String - Describes Azure disk type of the server’s root volume (Azure Only).
- provider
Encrypt Ebs Volume 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. - provider
Instance Size Name This property is required. String - Atlas provides different instance sizes, each with a default storage capacity and RAM size.
- provider
Name This property is required. String - Indicates the cloud service provider on which the servers are provisioned.
- provider
Region Name 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.
- provider
Volume Type This property is required. String Indicates the type of the volume. The possible values are:
STANDARD
andPROVISIONED
.NOTE:
STANDARD
is not available for NVME clusters.- redact
Client Log Data This property is required. Boolean - (Optional) Flag that enables or disables log redaction, see the manual for more information.
- replication
Factor 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.
- replication
Specs This property is required. List<GetClusters Result Replication Spec> - Configuration for cluster regions. See Replication Spec below for more details.
- snapshot
Backup Policies This property is required. List<GetClusters Result Snapshot Backup Policy> - current snapshot schedule and retention settings for the cluster.
- srv
Address 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.
- state
Name This property is required. String - Indicates the current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
This property is required. List<GetClusters Result Tag> - 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. 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.
- version
Release System This property is required. String - Release cadence that Atlas uses for this cluster.
- advanced
Configurations This property is required. GetClusters Result Advanced Configuration[] - Get the advanced configuration options. See Advanced Configuration below for more details.
- auto
Scaling Compute Enabled This property is required. boolean - Specifies whether cluster tier auto-scaling is enabled. The default is false.
- auto
Scaling Compute Scale Down Enabled This property is required. boolean auto_scaling_compute_scale_down_enabled
- Specifies whether cluster tier auto-down-scaling is enabled.
- auto
Scaling Disk Gb Enabled This property is required. boolean - Indicates whether disk auto-scaling is enabled.
- backing
Provider Name This property is required. string - Indicates Cloud service provider on which the server for a multi-tenant cluster is provisioned.
- backup
Enabled This property is required. boolean - Legacy Option, Indicates whether Atlas continuous backups are enabled for the cluster.
- bi
Connector Configs This property is required. GetClusters Result Bi Connector Config[] - 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. string - 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. GetClusters Result Connection String[] - 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. string - The Network Peering Container ID.
- disk
Size Gb This property is required. number - Indicates the size in gigabytes of the server’s root volume (AWS/GCP Only).
- encryption
At Rest Provider This property is required. string - Indicates whether Encryption at Rest is enabled or disabled.
- labels
This property is required. GetClusters Result Label[] - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below. DEPRECATED Use
tags
instead. - mongo
Db Major Version This property is required. string - Indicates the version of the cluster to deploy.
- mongo
Db Version This property is required. string - Version of MongoDB the cluster runs, in
major-version
.minor-version
format. - mongo
Uri 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.
- mongo
Uri Updated 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.
- mongo
Uri With Options 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
- num
Shards 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.
- pinned
Fcvs This property is required. GetClusters Result Pinned Fcv[] - The pinned Feature Compatibility Version (FCV) with its associated expiration date. See below.
- pit
Enabled This property is required. boolean - Flag that indicates if the cluster uses Continuous Cloud Backup.
- provider
Auto Scaling Compute Max Instance Size This property is required. string - Maximum instance size to which your cluster can automatically scale.
- provider
Auto Scaling Compute Min Instance Size This property is required. string - Minimum instance size to which your cluster can automatically scale.
- provider
Backup Enabled This property is required. boolean - Flag indicating if the cluster uses Cloud Backup Snapshots for backups. DEPRECATED Use
cloud_backup
instead. - provider
Disk Iops 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.
- provider
Disk Type Name This property is required. string - Describes Azure disk type of the server’s root volume (Azure Only).
- provider
Encrypt Ebs Volume 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. - provider
Instance Size Name This property is required. string - Atlas provides different instance sizes, each with a default storage capacity and RAM size.
- provider
Name This property is required. string - Indicates the cloud service provider on which the servers are provisioned.
- provider
Region Name 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.
- provider
Volume Type This property is required. string Indicates the type of the volume. The possible values are:
STANDARD
andPROVISIONED
.NOTE:
STANDARD
is not available for NVME clusters.- redact
Client Log Data This property is required. boolean - (Optional) Flag that enables or disables log redaction, see the manual for more information.
- replication
Factor 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.
- replication
Specs This property is required. GetClusters Result Replication Spec[] - Configuration for cluster regions. See Replication Spec below for more details.
- snapshot
Backup Policies This property is required. GetClusters Result Snapshot Backup Policy[] - current snapshot schedule and retention settings for the cluster.
- srv
Address 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.
- state
Name This property is required. string - Indicates the current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
This property is required. GetClusters Result Tag[] - 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. 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.
- version
Release System This property is required. string - Release cadence that Atlas uses for this cluster.
- advanced_
configurations This property is required. Sequence[GetClusters Result Advanced Configuration] - 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[GetClusters Result Bi Connector Config] - 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[GetClusters Result Connection String] - 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[GetClusters Result Label] - Set that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. See below. DEPRECATED Use
tags
instead. - mongo_
db_ 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[GetClusters Result Pinned Fcv] - 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
andPROVISIONED
.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[GetClusters Result Replication Spec] - Configuration for cluster regions. See Replication Spec below for more details.
- snapshot_
backup_ policies This property is required. Sequence[GetClusters Result Snapshot Backup Policy] - 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
This property is required. Sequence[GetClusters Result Tag] - 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.
- advanced
Configurations This property is required. List<Property Map> - Get the advanced configuration options. See Advanced Configuration below for more details.
- auto
Scaling Compute Enabled This property is required. Boolean - Specifies whether cluster tier auto-scaling is enabled. The default is false.
- auto
Scaling Compute Scale Down Enabled This property is required. Boolean auto_scaling_compute_scale_down_enabled
- Specifies whether cluster tier auto-down-scaling is enabled.
- auto
Scaling Disk Gb Enabled This property is required. Boolean - Indicates whether disk auto-scaling is enabled.
- backing
Provider Name This property is required. String - Indicates Cloud service provider on which the server for a multi-tenant cluster is provisioned.
- backup
Enabled This property is required. Boolean - Legacy Option, Indicates whether Atlas continuous backups are enabled for the cluster.
- bi
Connector Configs 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.
- cluster
Type 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.
- connection
Strings 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.
- container
Id This property is required. String - The Network Peering Container ID.
- disk
Size Gb This property is required. Number - Indicates the size in gigabytes of the server’s root volume (AWS/GCP Only).
- encryption
At Rest Provider 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. - mongo
Db Major Version This property is required. String - Indicates the version of the cluster to deploy.
- mongo
Db Version This property is required. String - Version of MongoDB the cluster runs, in
major-version
.minor-version
format. - mongo
Uri 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.
- mongo
Uri Updated 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.
- mongo
Uri With Options 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
- num
Shards 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.
- pinned
Fcvs This property is required. List<Property Map> - The pinned Feature Compatibility Version (FCV) with its associated expiration date. See below.
- pit
Enabled This property is required. Boolean - Flag that indicates if the cluster uses Continuous Cloud Backup.
- provider
Auto Scaling Compute Max Instance Size This property is required. String - Maximum instance size to which your cluster can automatically scale.
- provider
Auto Scaling Compute Min Instance Size This property is required. String - Minimum instance size to which your cluster can automatically scale.
- provider
Backup Enabled This property is required. Boolean - Flag indicating if the cluster uses Cloud Backup Snapshots for backups. DEPRECATED Use
cloud_backup
instead. - provider
Disk Iops 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.
- provider
Disk Type Name This property is required. String - Describes Azure disk type of the server’s root volume (Azure Only).
- provider
Encrypt Ebs Volume 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. - provider
Instance Size Name This property is required. String - Atlas provides different instance sizes, each with a default storage capacity and RAM size.
- provider
Name This property is required. String - Indicates the cloud service provider on which the servers are provisioned.
- provider
Region Name 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.
- provider
Volume Type This property is required. String Indicates the type of the volume. The possible values are:
STANDARD
andPROVISIONED
.NOTE:
STANDARD
is not available for NVME clusters.- redact
Client Log Data This property is required. Boolean - (Optional) Flag that enables or disables log redaction, see the manual for more information.
- replication
Factor 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.
- replication
Specs This property is required. List<Property Map> - Configuration for cluster regions. See Replication Spec below for more details.
- snapshot
Backup Policies This property is required. List<Property Map> - current snapshot schedule and retention settings for the cluster.
- srv
Address 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.
- state
Name This property is required. String - Indicates the current state of the cluster. The possible states are:
- IDLE
- CREATING
- UPDATING
- DELETING
- DELETED
- REPAIRING
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.
- termination
Protection Enabled 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.
- version
Release System This property is required. String - Release cadence that Atlas uses for this cluster.
GetClustersResultAdvancedConfiguration
- 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. List<string> - The custom OpenSSL cipher suite list for TLS 1.2. This field is only valid when
tls_cipher_config_mode
is set toCUSTOM
. - Default
Max Time Ms This property is required. int - Default
Read Concern 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.
- Default
Write Concern 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.
- 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.
- 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. string - 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. 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.
- 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. string - The TLS cipher suite configuration mode. Valid values include
CUSTOM
orDEFAULT
. TheDEFAULT
mode uses the default cipher suites. TheCUSTOM
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
- 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. []string - The custom OpenSSL cipher suite list for TLS 1.2. This field is only valid when
tls_cipher_config_mode
is set toCUSTOM
. - Default
Max Time Ms This property is required. int - Default
Read Concern 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.
- Default
Write Concern 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.
- 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.
- 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. string - 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. 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.
- 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. string - The TLS cipher suite configuration mode. Valid values include
CUSTOM
orDEFAULT
. TheDEFAULT
mode uses the default cipher suites. TheCUSTOM
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
- change
Stream Options Pre And Post Images Expire After Seconds 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). - custom
Openssl Cipher Config Tls12s 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 toCUSTOM
. - default
Max Time Ms This property is required. Integer - default
Read Concern 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.
- default
Write Concern 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.
- fail
Index Key Too Long 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.
- javascript
Enabled 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.
- minimum
Enabled Tls Protocol This property is required. String - Sets the minimum Transport Layer Security (TLS) version the cluster accepts for incoming connections. Valid values are:
- no
Table Scan 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.
- oplog
Min Retention Hours 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.
- oplog
Size Mb 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.
- sample
Refresh Interval Bi Connector 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.
- sample
Size Bi Connector 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.
- tls
Cipher Config Mode This property is required. String - The TLS cipher suite configuration mode. Valid values include
CUSTOM
orDEFAULT
. TheDEFAULT
mode uses the default cipher suites. TheCUSTOM
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. Integer
- change
Stream Options Pre And Post Images Expire After Seconds 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). - custom
Openssl Cipher Config Tls12s 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 toCUSTOM
. - default
Max Time Ms This property is required. number - default
Read Concern 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.
- default
Write Concern 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.
- fail
Index Key Too Long 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.
- javascript
Enabled 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.
- minimum
Enabled Tls Protocol This property is required. string - Sets the minimum Transport Layer Security (TLS) version the cluster accepts for incoming connections. Valid values are:
- no
Table Scan 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.
- oplog
Min Retention Hours 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.
- oplog
Size Mb 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.
- sample
Refresh Interval Bi Connector 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.
- sample
Size Bi Connector 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.
- tls
Cipher Config Mode This property is required. string - The TLS cipher suite configuration mode. Valid values include
CUSTOM
orDEFAULT
. TheDEFAULT
mode uses the default cipher suites. TheCUSTOM
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. 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 toCUSTOM
. - 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.
- 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.
- 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
orDEFAULT
. TheDEFAULT
mode uses the default cipher suites. TheCUSTOM
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
- change
Stream Options Pre And Post Images Expire After Seconds 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). - custom
Openssl Cipher Config Tls12s 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 toCUSTOM
. - default
Max Time Ms This property is required. Number - default
Read Concern 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.
- default
Write Concern 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.
- fail
Index Key Too Long 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.
- javascript
Enabled 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.
- minimum
Enabled Tls Protocol This property is required. String - Sets the minimum Transport Layer Security (TLS) version the cluster accepts for incoming connections. Valid values are:
- no
Table Scan 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.
- oplog
Min Retention Hours 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.
- oplog
Size Mb 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.
- sample
Refresh Interval Bi Connector 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.
- sample
Size Bi Connector 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.
- tls
Cipher Config Mode This property is required. String - The TLS cipher suite configuration mode. Valid values include
CUSTOM
orDEFAULT
. TheDEFAULT
mode uses the default cipher suites. TheCUSTOM
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. Number
GetClustersResultBiConnectorConfig
- 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. 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. 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.
- read
Preference 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.
- read
Preference 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.
- read
Preference 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
- Aws
Private Link This property is required. Dictionary<string, string> - Aws
Private Link Srv 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.
- Private
Endpoints This property is required. List<GetClusters Result Connection String Private Endpoint> - Private
Srv 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-awaremongodb://
connection string for this private endpoint.connection_strings.private_endpoint.#.srv_connection_string
- Private-endpoint-awaremongodb+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 themongodb+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 returnsMONGOD
for replica sets, orMONGOS
for sharded clusters.connection_strings.private_endpoint.#.endpoints
- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[#].connection_string
orconnection_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 returnsAWS
orAZURE
.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.
- Standard
Srv 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. map[string]string - Aws
Private Link Srv 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.
- Private
Endpoints This property is required. []GetClusters Result Connection String Private Endpoint - Private
Srv 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-awaremongodb://
connection string for this private endpoint.connection_strings.private_endpoint.#.srv_connection_string
- Private-endpoint-awaremongodb+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 themongodb+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 returnsMONGOD
for replica sets, orMONGOS
for sharded clusters.connection_strings.private_endpoint.#.endpoints
- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[#].connection_string
orconnection_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 returnsAWS
orAZURE
.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.
- Standard
Srv 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. Map<String,String> - aws
Private Link Srv This property is required. Map<String,String> - private
Endpoints This property is required. List<GetClusters Result Connection String Private Endpoint> - private
Srv 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-awaremongodb://
connection string for this private endpoint.connection_strings.private_endpoint.#.srv_connection_string
- Private-endpoint-awaremongodb+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 themongodb+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 returnsMONGOD
for replica sets, orMONGOS
for sharded clusters.connection_strings.private_endpoint.#.endpoints
- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[#].connection_string
orconnection_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 returnsAWS
orAZURE
.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.
- standard
Srv 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. {[key: string]: string} - aws
Private Link Srv 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.
- private
Endpoints This property is required. GetClusters Result Connection String Private Endpoint[] - private
Srv 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-awaremongodb://
connection string for this private endpoint.connection_strings.private_endpoint.#.srv_connection_string
- Private-endpoint-awaremongodb+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 themongodb+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 returnsMONGOD
for replica sets, orMONGOS
for sharded clusters.connection_strings.private_endpoint.#.endpoints
- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[#].connection_string
orconnection_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 returnsAWS
orAZURE
.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.
- standard
Srv 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[GetClusters Result Connection String Private Endpoint] - 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-awaremongodb://
connection string for this private endpoint.connection_strings.private_endpoint.#.srv_connection_string
- Private-endpoint-awaremongodb+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 themongodb+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 returnsMONGOD
for replica sets, orMONGOS
for sharded clusters.connection_strings.private_endpoint.#.endpoints
- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[#].connection_string
orconnection_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 returnsAWS
orAZURE
.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.
- aws
Private Link This property is required. Map<String> - aws
Private Link Srv 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.
- private
Endpoints This property is required. List<Property Map> - private
Srv 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-awaremongodb://
connection string for this private endpoint.connection_strings.private_endpoint.#.srv_connection_string
- Private-endpoint-awaremongodb+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 themongodb+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 returnsMONGOD
for replica sets, orMONGOS
for sharded clusters.connection_strings.private_endpoint.#.endpoints
- Private endpoint through which you connect to Atlas when you useconnection_strings.private_endpoint[#].connection_string
orconnection_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 returnsAWS
orAZURE
.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.
- standard
Srv 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
- Connection
String This property is required. string - Endpoints
This property is required. List<GetClusters Result Connection String Private Endpoint Endpoint> - Srv
Connection String This property is required. string - Srv
Shard Optimized Connection String This property is required. string - Type
This property is required. string
- Connection
String This property is required. string - Endpoints
This property is required. []GetClusters Result Connection String Private Endpoint Endpoint - Srv
Connection String This property is required. string - Srv
Shard Optimized Connection String This property is required. string - Type
This property is required. string
- connection
String This property is required. String - endpoints
This property is required. List<GetClusters Result Connection String Private Endpoint Endpoint> - srv
Connection String This property is required. String - srv
Shard Optimized Connection String This property is required. String - type
This property is required. String
- connection
String This property is required. string - endpoints
This property is required. GetClusters Result Connection String Private Endpoint Endpoint[] - srv
Connection String This property is required. string - srv
Shard Optimized Connection String This property is required. string - type
This property is required. string
- connection_
string This property is required. str - endpoints
This property is required. Sequence[GetClusters Result Connection String Private Endpoint Endpoint] - srv_
connection_ string This property is required. str - srv_
shard_ optimized_ connection_ string This property is required. str - type
This property is required. str
- connection
String This property is required. String - endpoints
This property is required. List<Property Map> - srv
Connection String This property is required. String - srv
Shard Optimized Connection String This property is required. String - type
This property is required. String
GetClustersResultConnectionStringPrivateEndpointEndpoint
- Endpoint
Id This property is required. string - Provider
Name 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. string - Provider
Name 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. String - provider
Name 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. string - provider
Name 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
- endpoint
Id This property is required. String - provider
Name This property is required. String - Indicates the cloud service provider on which the servers are provisioned.
- region
This property is required. String
GetClustersResultLabel
GetClustersResultPinnedFcv
- Expiration
Date 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. 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. 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. 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.
- expiration
Date 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.
- Num
Shards This property is required. int - Number of shards to deploy in the specified zone.
- Regions
Configs This property is required. List<GetClusters Result Replication Spec Regions Config> - 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. 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.
- Num
Shards This property is required. int - Number of shards to deploy in the specified zone.
- Regions
Configs This property is required. []GetClusters Result Replication Spec Regions Config - 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. 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.
- num
Shards This property is required. Integer - Number of shards to deploy in the specified zone.
- regions
Configs This property is required. List<GetClusters Result Replication Spec Regions Config> - 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. 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.
- num
Shards This property is required. number - Number of shards to deploy in the specified zone.
- regions
Configs This property is required. GetClusters Result Replication Spec Regions Config[] - 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. 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[GetClusters Result Replication Spec Regions Config] - 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.
- num
Shards This property is required. Number - Number of shards to deploy in the specified zone.
- regions
Configs 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.
- zone
Name This property is required. String - Indicates the n ame for the zone in a Global Cluster.
GetClustersResultReplicationSpecRegionsConfig
- 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. 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. string - Name for the region specified.
- analytics
Nodes 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.
- electable
Nodes 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.
- read
Only Nodes 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.
- region
Name This property is required. String - Name for the region specified.
- analytics
Nodes 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.
- electable
Nodes 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.
- read
Only Nodes 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.
- region
Name 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.
- analytics
Nodes 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.
- electable
Nodes 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.
- read
Only Nodes 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.
- region
Name This property is required. String - Name for the region specified.
GetClustersResultSnapshotBackupPolicy
- Cluster
Id This property is required. string - Cluster
Name This property is required. string - Next
Snapshot This property is required. string - Policies
This property is required. List<GetClusters Result Snapshot Backup Policy Policy> - 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
- Cluster
Id This property is required. string - Cluster
Name This property is required. string - Next
Snapshot This property is required. string - Policies
This property is required. []GetClusters Result Snapshot Backup Policy Policy - 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
- cluster
Id This property is required. String - cluster
Name This property is required. String - next
Snapshot This property is required. String - policies
This property is required. List<GetClusters Result Snapshot Backup Policy Policy> - reference
Hour Of Day This property is required. Integer - reference
Minute Of Hour This property is required. Integer - restore
Window Days This property is required. Integer - update
Snapshots This property is required. Boolean
- cluster
Id This property is required. string - cluster
Name This property is required. string - next
Snapshot This property is required. string - policies
This property is required. GetClusters Result Snapshot Backup Policy Policy[] - reference
Hour Of Day This property is required. number - reference
Minute Of Hour This property is required. number - restore
Window Days This property is required. number - update
Snapshots 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[GetClusters Result Snapshot Backup Policy Policy] - 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
- cluster
Id This property is required. String - cluster
Name This property is required. String - next
Snapshot This property is required. String - policies
This property is required. List<Property Map> - reference
Hour Of Day This property is required. Number - reference
Minute Of Hour This property is required. Number - restore
Window Days This property is required. Number - update
Snapshots 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.
- Policy
Items This property is required. List<GetClusters Result Snapshot Backup Policy Policy Policy Item>
- 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.
- Policy
Items This property is required. []GetClusters Result Snapshot Backup Policy Policy Policy Item
- 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.
- policy
Items This property is required. List<GetClusters Result Snapshot Backup Policy Policy Policy Item>
- 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.
- policy
Items This property is required. GetClusters Result Snapshot Backup Policy Policy Policy Item[]
- 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[GetClusters Result Snapshot Backup Policy Policy Policy Item]
- 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.
- policy
Items This property is required. List<Property Map>
GetClustersResultSnapshotBackupPolicyPolicyPolicyItem
- Frequency
Interval This property is required. int - Frequency
Type 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.
- Retention
Unit This property is required. string - Retention
Value This property is required. int
- Frequency
Interval This property is required. int - Frequency
Type 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.
- Retention
Unit This property is required. string - Retention
Value This property is required. int
- frequency
Interval This property is required. Integer - frequency
Type 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.
- retention
Unit This property is required. String - retention
Value This property is required. Integer
- frequency
Interval This property is required. number - frequency
Type 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.
- retention
Unit This property is required. string - retention
Value 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
- frequency
Interval This property is required. Number - frequency
Type 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.
- retention
Unit This property is required. String - retention
Value This property is required. Number
GetClustersResultTag
Package Details
- Repository
- MongoDB Atlas pulumi/pulumi-mongodbatlas
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
mongodbatlas
Terraform Provider.