Contact UsGet started
© 2025 Direct Cursus Technology L.L.C.

yandex_mdb_mongodb_cluster (Data Source)

Written by
Updated at September 11, 2025

Get information about a Yandex Managed MongoDB cluster. For more information, see the official documentation.

Warning

Either cluster_id or name should be specified.

Example usage

//
// Get information about existing MDB MongoDB Cluster.
//
data "yandex_mdb_mongodb_cluster" "foo" {
  name = "test"
}

output "network_id" {
  value = data.yandex_mdb_mongodb_cluster.foo.network_id
}

Schema

Optional

  • cluster_config (Block List, Max: 1) Configuration of the MongoDB subcluster. (see below for nested schema)
  • cluster_id (String) The ID of the cluster.
  • created_at (String) The creation timestamp of the resource.
  • database (Block Set, Deprecated) A database of the MongoDB cluster. (see below for nested schema)
  • deletion_protection (Boolean) The true value means that resource is protected from accidental deletion.
  • description (String) The resource description.
  • disk_encryption_key_id (String) ID of the KMS key for cluster disk encryption.
  • disk_size_autoscaling_mongocfg (Block List, Max: 1) Disk size autoscaling settings for mongocfg. (see below for nested schema)
  • disk_size_autoscaling_mongod (Block List, Max: 1) Disk size autoscaling settings for mongod. (see below for nested schema)
  • disk_size_autoscaling_mongoinfra (Block List, Max: 1) Disk size autoscaling settings for mongoinfra. (see below for nested schema)
  • disk_size_autoscaling_mongos (Block List, Max: 1) Disk size autoscaling settings for mongos. (see below for nested schema)
  • environment (String) Deployment environment of the MongoDB cluster. Can be either PRESTABLE or PRODUCTION.
  • folder_id (String) The folder identifier that resource belongs to. If it is not provided, the default provider folder-id is used.
  • health (String) Aggregated health of the cluster. Can be either ALIVE, DEGRADED, DEAD or HEALTH_UNKNOWN. For more information see health field of JSON representation in the official documentation.
  • host (Block List) A host of the MongoDB cluster. (see below for nested schema)
  • labels (Map of String) A set of key/value label pairs which assigned to resource.
  • maintenance_window (Block List, Max: 1) Maintenance window settings of the MongoDB cluster. (see below for nested schema)
  • name (String) The resource name.
  • network_id (String) The VPC Network ID of subnets which resource attached to.
  • resources (Block List, Max: 1, Deprecated) (DEPRECATED, use resources_* instead) Resources allocated to hosts of the MongoDB cluster. (see below for nested schema)
  • resources_mongocfg (Block List, Max: 1) Resources allocated to mongocfg hosts of the MongoDB cluster. (see below for nested schema)
  • resources_mongod (Block List, Max: 1) Resources allocated to mongod hosts of the MongoDB cluster. (see below for nested schema)
  • resources_mongoinfra (Block List, Max: 1) Resources allocated to mongoinfra hosts of the MongoDB cluster. (see below for nested schema)
  • resources_mongos (Block List, Max: 1) Resources allocated to mongos hosts of the MongoDB cluster. (see below for nested schema)
  • restore (Block List, Max: 1) The cluster will be created from the specified backup. (see below for nested schema)
  • security_group_ids (Set of String) The list of security groups applied to resource or their components.
  • sharded (Boolean) MongoDB Cluster mode enabled/disabled.
  • status (String) Status of the cluster. Can be either CREATING, STARTING, RUNNING, UPDATING, STOPPING, STOPPED, ERROR or STATUS_UNKNOWN. For more information see status field of JSON representation in the official documentation.
  • user (Block Set, Deprecated) A user of the MongoDB cluster. (see below for nested schema)

Read-Only

  • id (String) The ID of this resource.

Nested Schema for cluster_config

Optional:

  • access (Block List, Max: 1) Access policy to the MongoDB cluster. (see below for nested schema)

  • backup_retain_period_days (Number) Retain period of automatically created backup in days. Retain period of automatically created backup in days.

  • backup_window_start (Block List, Max: 1) Time to start the daily backup, in the UTC timezone. (see below for nested schema)

  • feature_compatibility_version (String) Feature compatibility version of MongoDB. If not provided version is taken. Can be either 6.0, 5.0, 4.4 and 4.2. Feature compatibility version of MongoDB. If not provided version is taken. Can be either 6.0, 5.0, 4.4 and 4.2.

  • mongocfg (Block List, Max: 1) Configuration of the mongocfg service. (see below for nested schema)

  • mongod (Block List, Max: 1) Configuration of the mongod service. (see below for nested schema)

  • mongos (Block List, Max: 1) Configuration of the mongos service. (see below for nested schema)

  • performance_diagnostics (Block List, Max: 1) Performance diagnostics to the MongoDB cluster. (see below for nested schema)

  • version (String) Version of the MongoDB server software. Can be either 4.2, 4.4, 4.4-enterprise, 5.0, 5.0-enterprise, 6.0 and 6.0-enterprise. Version of the MongoDB server software. Can be either 4.2, 4.4, 4.4-enterprise, 5.0, 5.0-enterprise, 6.0 and 6.0-enterprise.

Nested Schema for cluster_config.access

Optional:

Nested Schema for cluster_config.backup_window_start

Optional:

  • hours (Number) The hour at which backup will be started. The hour at which backup will be started.

  • minutes (Number) The minute at which backup will be started. The minute at which backup will be started.

Nested Schema for cluster_config.mongocfg

Optional:

Nested Schema for cluster_config.mongocfg.net

Optional:

  • max_incoming_connections (Number) The maximum number of simultaneous connections that host will accept. For more information, see the net.maxIncomingConnections description in the official documentation. The maximum number of simultaneous connections that host will accept. For more information, see the net.maxIncomingConnections description in the official documentation.

Nested Schema for cluster_config.mongocfg.operation_profiling

Optional:

  • mode (String) Specifies which operations should be profiled. The following profiler levels are available: off, slow_op, all. For more information, see the operationProfiling.mode description in the official documentation. Specifies which operations should be profiled. The following profiler levels are available: off, slow_op, all. For more information, see the operationProfiling.mode description in the official documentation.

  • slow_op_threshold (Number) The slow operation time threshold, in milliseconds. Operations that run for longer than this threshold are considered slow. For more information, see the operationProfiling.slowOpThresholdMs description in the official documentation. The slow operation time threshold, in milliseconds. Operations that run for longer than this threshold are considered slow. For more information, see the operationProfiling.slowOpThresholdMs description in the official documentation.

Nested Schema for cluster_config.mongocfg.storage

Optional:

Nested Schema for cluster_config.mongocfg.storage.wired_tiger

Optional:

  • cache_size_gb (Number) Defines the maximum size of the internal cache that WiredTiger will use for all data. For more information, see the storage.wiredTiger.engineConfig.cacheSizeGB description in the official documentation. Defines the maximum size of the internal cache that WiredTiger will use for all data. For more information, see the storage.wiredTiger.engineConfig.cacheSizeGB description in the official documentation.

Nested Schema for cluster_config.mongod

Optional:

Nested Schema for cluster_config.mongod.audit_log

Optional:

  • filter (String) Configuration of the audit log filter in JSON format. For more information see auditLog.filter description in the official documentation. Available only in enterprise edition. Configuration of the audit log filter in JSON format. For more information see auditLog.filter description in the official documentation. Available only in enterprise edition.

  • runtime_configuration (Boolean) Specifies if a node allows runtime configuration of audit filters and the auditAuthorizationSuccess variable. For more information see auditLog.runtimeConfiguration description in the official documentation. Available only in enterprise edition. Specifies if a node allows runtime configuration of audit filters and the auditAuthorizationSuccess variable. For more information see auditLog.runtimeConfiguration description in the official documentation. Available only in enterprise edition.

Nested Schema for cluster_config.mongod.net

Optional:

  • compressors (List of String) Specifies the default compressor(s) to use for communication between this mongod or mongos. Accepts array of compressors. Order matters. Available compressors: snappy, zlib, zstd, disabled. To disable network compression, make disabled the only value. For more information, see the net.Compression.Compressors description in the official documentation. Specifies the default compressor(s) to use for communication between this mongod or mongos. Accepts array of compressors. Order matters. Available compressors: snappy, zlib, zstd, disabled. To disable network compression, make disabled the only value. For more information, see the net.Compression.Compressors description in the official documentation.

  • max_incoming_connections (Number) The maximum number of simultaneous connections that host will accept. For more information, see the net.maxIncomingConnections description in the official documentation. The maximum number of simultaneous connections that host will accept. For more information, see the net.maxIncomingConnections description in the official documentation.

Nested Schema for cluster_config.mongod.operation_profiling

Optional:

  • mode (String) Specifies which operations should be profiled. The following profiler levels are available: off, slow_op, all. For more information, see the operationProfiling.mode description in the official documentation. Specifies which operations should be profiled. The following profiler levels are available: off, slow_op, all. For more information, see the operationProfiling.mode description in the official documentation.

  • slow_op_sample_rate (Number) The fraction of slow operations that should be profiled or logged. Accepts values between 0 and 1, inclusive. For more information, see the operationProfiling.slowOpSampleRate description in the official documentation. The fraction of slow operations that should be profiled or logged. Accepts values between 0 and 1, inclusive. For more information, see the operationProfiling.slowOpSampleRate description in the official documentation.

  • slow_op_threshold (Number) The slow operation time threshold, in milliseconds. Operations that run for longer than this threshold are considered slow. For more information, see the operationProfiling.slowOpThresholdMs description in the official documentation. The slow operation time threshold, in milliseconds. Operations that run for longer than this threshold are considered slow. For more information, see the operationProfiling.slowOpThresholdMs description in the official documentation.

Nested Schema for cluster_config.mongod.security

Optional:

  • enable_encryption (Boolean) Enables the encryption for the WiredTiger storage engine. Can be either true or false. For more information see security.enableEncryption description in the official documentation. Available only in enterprise edition. Enables the encryption for the WiredTiger storage engine. Can be either true or false. For more information see security.enableEncryption description in the official documentation. Available only in enterprise edition.

  • kmip (Block List, Max: 1) Configuration of the third party key management appliance via the Key Management Interoperability Protocol (KMIP) (see Encryption tutorial ). Requires enable_encryption to be true. The structure is documented below. Available only in enterprise edition. (see below for nested schema)

Nested Schema for cluster_config.mongod.security.kmip

Optional:

  • client_certificate (String) String containing the client certificate used for authenticating MongoDB to the KMIP server. For more information see security.kmip.clientCertificateFile description in the official documentation. String containing the client certificate used for authenticating MongoDB to the KMIP server. For more information see security.kmip.clientCertificateFile description in the official documentation.

  • key_identifier (String) Unique KMIP identifier for an existing key within the KMIP server. For more information see security.kmip.keyIdentifier description in the official documentation. Unique KMIP identifier for an existing key within the KMIP server. For more information see security.kmip.keyIdentifier description in the official documentation.

  • port (Number) Port number to use to communicate with the KMIP server. Default: 5696 For more information see security.kmip.port description in the official documentation. Port number to use to communicate with the KMIP server. Default: 5696 For more information see security.kmip.port description in the official documentation.

  • server_ca (String) Path to CA File. Used for validating secure client connection to KMIP server. For more information see security.kmip.serverCAFile description in the official documentation. Path to CA File. Used for validating secure client connection to KMIP server. For more information see security.kmip.serverCAFile description in the official documentation.

  • server_name (String) Hostname or IP address of the KMIP server to connect to. For more information see security.kmip.serverName description in the official documentation. Hostname or IP address of the KMIP server to connect to. For more information see security.kmip.serverName description in the official documentation.

Nested Schema for cluster_config.mongod.set_parameter

Optional:

  • audit_authorization_success (Boolean) Enables the auditing of authorization successes. Can be either true or false. For more information, see the auditAuthorizationSuccess description in the official documentation. Available only in enterprise edition. Enables the auditing of authorization successes. Can be either true or false. For more information, see the auditAuthorizationSuccess description in the official documentation. Available only in enterprise edition.

  • enable_flow_control (Boolean) Enables the flow control. Can be either true or false. For more information, see the enableFlowControl description in the official documentation. Enables the flow control. Can be either true or false. For more information, see the enableFlowControl description in the official documentation.

  • min_snapshot_history_window_in_seconds (Number) The minimum time window in seconds for which the storage engine keeps the snapshot history. For more information, see the minSnapshotHistoryWindowInSeconds description in the official documentation. The minimum time window in seconds for which the storage engine keeps the snapshot history. For more information, see the minSnapshotHistoryWindowInSeconds description in the official documentation.

Nested Schema for cluster_config.mongod.storage

Optional:

Nested Schema for cluster_config.mongod.storage.journal

Optional:

  • commit_interval (Number) The maximum amount of time in milliseconds that the mongod process allows between journal operations. For more information, see the storage.journal.commitIntervalMs description in the official documentation. The maximum amount of time in milliseconds that the mongod process allows between journal operations. For more information, see the storage.journal.commitIntervalMs description in the official documentation.

Nested Schema for cluster_config.mongod.storage.wired_tiger

Optional:

  • block_compressor (String) Specifies the default compression for collection data. You can override this on a per-collection basis when creating collections. Available compressors are: none, snappy, zlib, zstd. This setting available only on mongod hosts. For more information, see the storage.wiredTiger.collectionConfig.blockCompressor description in the official documentation. Specifies the default compression for collection data. You can override this on a per-collection basis when creating collections. Available compressors are: none, snappy, zlib, zstd. This setting available only on mongod hosts. For more information, see the storage.wiredTiger.collectionConfig.blockCompressor description in the official documentation.

  • cache_size_gb (Number) Defines the maximum size of the internal cache that WiredTiger will use for all data. For more information, see the storage.wiredTiger.engineConfig.cacheSizeGB description in the official documentation. Defines the maximum size of the internal cache that WiredTiger will use for all data. For more information, see the storage.wiredTiger.engineConfig.cacheSizeGB description in the official documentation.

  • prefix_compression (Boolean) Enables or disables prefix compression for index data. Сan be either true or false. For more information, see the storage.wiredTiger.indexConfig.prefixCompression description in the official documentation. Enables or disables prefix compression for index data. Сan be either true or false. For more information, see the storage.wiredTiger.indexConfig.prefixCompression description in the official documentation.

Nested Schema for cluster_config.mongos

Optional:

Nested Schema for cluster_config.mongos.net

Optional:

  • compressors (List of String) Specifies the default compressor(s) to use for communication between this mongod or mongos. Accepts array of compressors. Order matters. Available compressors: snappy, zlib, zstd, disabled. To disable network compression, make disabled the only value. For more information, see the net.Compression.Compressors description in the official documentation. Specifies the default compressor(s) to use for communication between this mongod or mongos. Accepts array of compressors. Order matters. Available compressors: snappy, zlib, zstd, disabled. To disable network compression, make disabled the only value. For more information, see the net.Compression.Compressors description in the official documentation.

  • max_incoming_connections (Number) The maximum number of simultaneous connections that host will accept. For more information, see the net.maxIncomingConnections description in the official documentation. The maximum number of simultaneous connections that host will accept. For more information, see the net.maxIncomingConnections description in the official documentation.

Nested Schema for cluster_config.performance_diagnostics

Optional:

  • enabled (Boolean) Enable or disable performance diagnostics. Enable or disable performance diagnostics.

Nested Schema for database

Optional:

  • name (String) The name of the database. The name of the database.

Nested Schema for disk_size_autoscaling_mongocfg

Optional:

  • disk_size_limit (Number) Limit of disk size after autoscaling (GiB). Limit of disk size after autoscaling (GiB).

  • emergency_usage_threshold (Number) Immediate autoscaling disk usage (percent). Immediate autoscaling disk usage (percent).

  • planned_usage_threshold (Number) Maintenance window autoscaling disk usage (percent). Maintenance window autoscaling disk usage (percent).

Nested Schema for disk_size_autoscaling_mongod

Optional:

  • disk_size_limit (Number) Limit of disk size after autoscaling (GiB). Limit of disk size after autoscaling (GiB).

  • emergency_usage_threshold (Number) Immediate autoscaling disk usage (percent). Immediate autoscaling disk usage (percent).

  • planned_usage_threshold (Number) Maintenance window autoscaling disk usage (percent). Maintenance window autoscaling disk usage (percent).

Nested Schema for disk_size_autoscaling_mongoinfra

Optional:

  • disk_size_limit (Number) Limit of disk size after autoscaling (GiB). Limit of disk size after autoscaling (GiB).

  • emergency_usage_threshold (Number) Immediate autoscaling disk usage (percent). Immediate autoscaling disk usage (percent).

  • planned_usage_threshold (Number) Maintenance window autoscaling disk usage (percent). Maintenance window autoscaling disk usage (percent).

Nested Schema for disk_size_autoscaling_mongos

Optional:

  • disk_size_limit (Number) Limit of disk size after autoscaling (GiB). Limit of disk size after autoscaling (GiB).

  • emergency_usage_threshold (Number) Immediate autoscaling disk usage (percent). Immediate autoscaling disk usage (percent).

  • planned_usage_threshold (Number) Maintenance window autoscaling disk usage (percent). Maintenance window autoscaling disk usage (percent).

Nested Schema for host

Optional:

  • assign_public_ip (Boolean) Should this host have assigned public IP assigned. Can be either true or false. Should this host have assigned public IP assigned. Can be either true or false.

  • health (String) The health of the host. The health of the host.

  • host_parameters (Block List, Max: 1) The parameters of mongod host in replicaset. (see below for nested schema)

  • name (String) The fully qualified domain name of the host. Computed on server side. The fully qualified domain name of the host. Computed on server side.

  • role (String) The role of the cluster (either PRIMARY or SECONDARY). The role of the cluster (either PRIMARY or SECONDARY).

  • shard_name (String) The name of the shard to which the host belongs. Only for sharded cluster. The name of the shard to which the host belongs. Only for sharded cluster.

  • subnet_id (String) The ID of the subnet, to which the host belongs. The subnet must be a part of the network to which the cluster belongs. The ID of the subnet, to which the host belongs. The subnet must be a part of the network to which the cluster belongs.

  • type (String) Type of Mongo daemon which runs on this host (mongod, mongos, mongocfg, mongoinfra). Defaults to mongod. Type of Mongo daemon which runs on this host (mongod, mongos, mongocfg, mongoinfra). Defaults to mongod.

  • zone_id (String) The availability zone where resource is located. If it is not provided, the default provider zone will be used. The availability zone where resource is located. If it is not provided, the default provider zone will be used.

Nested Schema for host.host_parameters

Optional:

  • hidden (Boolean) Should this host be hidden in replicaset. Can be either true of false. For more information see the official documentation. Should this host be hidden in replicaset. Can be either true of false. For more information see the official documentation.

  • priority (Number) A floating point number that indicates the relative likelihood of a replica set member to become the primary. For more information see the official documentation. A floating point number that indicates the relative likelihood of a replica set member to become the primary. For more information see the official documentation.

  • secondary_delay_secs (Number) The number of seconds behind the primary that this replica set member should lag. For more information see the official documentation. The number of seconds behind the primary that this replica set member should lag. For more information see the official documentation.

  • tags (Map of String) A set of key/value pairs to assign for the replica set member. For more information see the official documentation. A set of key/value pairs to assign for the replica set member. For more information see the official documentation.

Nested Schema for maintenance_window

Optional:

  • day (String) Day of week for maintenance window if window type is weekly. Possible values: MON, TUE, WED, THU, FRI, SAT, SUN. Day of week for maintenance window if window type is weekly. Possible values: MON, TUE, WED, THU, FRI, SAT, SUN.

  • hour (Number) Hour of day in UTC time zone (1-24) for maintenance window if window type is weekly. Hour of day in UTC time zone (1-24) for maintenance window if window type is weekly.

  • type (String) Type of maintenance window. Can be either ANYTIME or WEEKLY. A day and hour of window need to be specified with weekly window. Type of maintenance window. Can be either ANYTIME or WEEKLY. A day and hour of window need to be specified with weekly window.

Nested Schema for resources

Optional:

  • disk_size (Number) Volume of the storage available to a MongoDB host, in gigabytes. Volume of the storage available to a MongoDB host, in gigabytes.

  • disk_type_id (String) Type of the storage of MongoDB hosts. For more information see the official documentation. Type of the storage of MongoDB hosts. For more information see the official documentation.

  • resource_preset_id (String) The ID of the preset for computational resources available to a MongoDB host (CPU, memory etc.). For more information, see the official documentation. The ID of the preset for computational resources available to a MongoDB host (CPU, memory etc.). For more information, see the official documentation.

Nested Schema for resources_mongocfg

Optional:

  • disk_size (Number) Volume of the storage available to a MongoDB host, in gigabytes. Volume of the storage available to a MongoDB host, in gigabytes.

  • disk_type_id (String) Type of the storage of MongoDB hosts. For more information see the official documentation. Type of the storage of MongoDB hosts. For more information see the official documentation.

  • resource_preset_id (String) The ID of the preset for computational resources available to a MongoDB host (CPU, memory etc.). For more information, see the official documentation. The ID of the preset for computational resources available to a MongoDB host (CPU, memory etc.). For more information, see the official documentation.

Nested Schema for resources_mongod

Optional:

  • disk_size (Number) Volume of the storage available to a MongoDB host, in gigabytes. Volume of the storage available to a MongoDB host, in gigabytes.

  • disk_type_id (String) Type of the storage of MongoDB hosts. For more information see the official documentation. Type of the storage of MongoDB hosts. For more information see the official documentation.

  • resource_preset_id (String) The ID of the preset for computational resources available to a MongoDB host (CPU, memory etc.). For more information, see the official documentation. The ID of the preset for computational resources available to a MongoDB host (CPU, memory etc.). For more information, see the official documentation.

Nested Schema for resources_mongoinfra

Optional:

  • disk_size (Number) Volume of the storage available to a MongoDB host, in gigabytes. Volume of the storage available to a MongoDB host, in gigabytes.

  • disk_type_id (String) Type of the storage of MongoDB hosts. For more information see the official documentation. Type of the storage of MongoDB hosts. For more information see the official documentation.

  • resource_preset_id (String) The ID of the preset for computational resources available to a MongoDB host (CPU, memory etc.). For more information, see the official documentation. The ID of the preset for computational resources available to a MongoDB host (CPU, memory etc.). For more information, see the official documentation.

Nested Schema for resources_mongos

Optional:

  • disk_size (Number) Volume of the storage available to a MongoDB host, in gigabytes. Volume of the storage available to a MongoDB host, in gigabytes.

  • disk_type_id (String) Type of the storage of MongoDB hosts. For more information see the official documentation. Type of the storage of MongoDB hosts. For more information see the official documentation.

  • resource_preset_id (String) The ID of the preset for computational resources available to a MongoDB host (CPU, memory etc.). For more information, see the official documentation. The ID of the preset for computational resources available to a MongoDB host (CPU, memory etc.). For more information, see the official documentation.

Nested Schema for restore

Optional:

  • backup_id (String) Backup ID. The cluster will be created from the specified backup. How to get a list of PostgreSQL backups. Backup ID. The cluster will be created from the specified backup. How to get a list of PostgreSQL backups.

  • time (String) Timestamp of the moment to which the MongoDB cluster should be restored. (Format: 2006-01-02T15:04:05 - UTC). When not set, current time is used. Timestamp of the moment to which the MongoDB cluster should be restored. (Format: 2006-01-02T15:04:05 - UTC). When not set, current time is used.

Nested Schema for user

Optional:

  • name (String) The name of the user. The name of the user.

  • password (String, Sensitive) The password of the user. The password of the user.

  • permission (Block Set) Set of permissions granted to the user. (see below for nested schema)

Nested Schema for user.permission

Optional:

  • database_name (String) The name of the database that the permission grants access to. The name of the database that the permission grants access to.

  • roles (List of String) The roles of the user in this database. For more information see the official documentation. The roles of the user in this database. For more information see the official documentation.

Previous
kubernetes_node_group
Next
mdb_mongodb_database