Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Terraform in Yandex Cloud
  • Getting started
  • Solution library
    • Overview
    • Release notes
          • ytsaurus_cluster

In this article:

  • Example usage
  • Schema
  • Optional
  • Read-Only
  • Nested Schema for timeouts
  • Nested Schema for cidr_blocks_whitelist
  • Nested Schema for endpoints
  • Nested Schema for spec
  • Nested Schema for spec.client_logging
  • Nested Schema for spec.compute
  • Nested Schema for spec.compute.disks
  • Nested Schema for spec.compute.scale_policy
  • Nested Schema for spec.compute.scale_policy.auto
  • Nested Schema for spec.compute.scale_policy.fixed
  • Nested Schema for spec.cron
  • Nested Schema for spec.cron.clear_tmp
  • Nested Schema for spec.odin
  • Nested Schema for spec.proxy
  • Nested Schema for spec.proxy.http
  • Nested Schema for spec.proxy.rpc
  • Nested Schema for spec.storage
  • Nested Schema for spec.storage.hdd
  • Nested Schema for spec.storage.ssd
  • Nested Schema for spec.storage.ssd.changelogs
  • Nested Schema for spec.tablet
  1. Terraform reference
  2. Resources
  3. Managed YTsaurus
  4. Data Sources
  5. ytsaurus_cluster

yandex_ytsaurus_cluster (Data Source)

Written by
Yandex Cloud
Updated at January 20, 2026
  • Example usage
  • Schema
    • Optional
    • Read-Only
    • Nested Schema for timeouts
    • Nested Schema for cidr_blocks_whitelist
    • Nested Schema for endpoints
    • Nested Schema for spec
    • Nested Schema for spec.client_logging
    • Nested Schema for spec.compute
    • Nested Schema for spec.compute.disks
    • Nested Schema for spec.compute.scale_policy
    • Nested Schema for spec.compute.scale_policy.auto
    • Nested Schema for spec.compute.scale_policy.fixed
    • Nested Schema for spec.cron
    • Nested Schema for spec.cron.clear_tmp
    • Nested Schema for spec.odin
    • Nested Schema for spec.proxy
    • Nested Schema for spec.proxy.http
    • Nested Schema for spec.proxy.rpc
    • Nested Schema for spec.storage
    • Nested Schema for spec.storage.hdd
    • Nested Schema for spec.storage.ssd
    • Nested Schema for spec.storage.ssd.changelogs
    • Nested Schema for spec.tablet

Example usageExample usage

//
// Get information about existing YTsaurus cluster.
//
data "yandex_ytsaurus_cluster" "my_cluster" {
  cluster_id = "some_cluster_id"
}

SchemaSchema

OptionalOptional

  • cluster_id (String) ID of the cluster to return.
  • folder_id (String) ID of the folder that the cluster belongs to.
  • id (String) ID of the cluster to return.
  • timeouts (Attributes) (see below for nested schema)

Read-OnlyRead-Only

  • cidr_blocks_whitelist (Attributes) CIDRs whitelist. (see below for nested schema)
  • created_at (String) Time when the cluster was created.
  • created_by (String) User who created the cluster.
  • description (String) Description of the cluster.
  • endpoints (Attributes) Endpoints of the cluster. (see below for nested schema)
  • health (String) Health of the cluster.
  • labels (Map of String) Cluster labels as key:value pairs.
  • name (String) Name of the cluster.
    The name is unique within the folder.
  • security_group_ids (List of String) Network interfaces security groups.
  • spec (Attributes) Cluster specification. (see below for nested schema)
  • status (String) Status of the cluster.
  • subnet_id (String) ID of the subnet where the cluster resides.
  • updated_at (String) Time when the cluster was last updated.
  • updated_by (String) User who last updated the cluster.
  • zone_id (String) ID of the availability zone where the cluster resides.

Nested Schema for Nested Schema for timeouts

Optional:

  • create (String) A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
  • delete (String) A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
  • read (String) A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Read operations occur during any refresh or planning operation when refresh is enabled.
  • update (String) A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).

Nested Schema for Nested Schema for cidr_blocks_whitelist

Read-Only:

  • v4_cidr_blocks (List of String) IPv4 CIDR blocks.

Nested Schema for Nested Schema for endpoints

Read-Only:

  • external_http_proxy_balancer (String) package: yandex.cloud.ytsaurus.v1
    filename: yandex/cloud/ytsaurus/v1/cluster.proto
  • internal_http_proxy_alias (String) package: yandex.cloud.ytsaurus.v1
    filename: yandex/cloud/ytsaurus/v1/cluster.proto
  • internal_rpc_proxy_alias (String) package: yandex.cloud.ytsaurus.v1
    filename: yandex/cloud/ytsaurus/v1/cluster.proto
  • ui (String) package: yandex.cloud.ytsaurus.v1
    filename: yandex/cloud/ytsaurus/v1/cluster.proto

Nested Schema for Nested Schema for spec

Read-Only:

  • client_logging (Attributes) Client Cloud logging configuration. (see below for nested schema)
  • compute (Attributes List) Cluster exec nodes configuration. (see below for nested schema)
  • cron (Attributes) Cluster regular processing settings. (see below for nested schema)
  • flavor (String) Cluster flavor (type).
  • odin (Attributes) Odin configuration. (see below for nested schema)
  • proxy (Attributes) Cluster proxies configuration. (see below for nested schema)
  • storage (Attributes) Cluster storage configuration. (see below for nested schema)
  • tablet (Attributes) Cluster tablet nodes configuration. (see below for nested schema)

Nested Schema for Nested Schema for spec.client_logging

Optional:

  • folder_id (String) ID of cloud logging folder. Used default loging group.
  • service_account_id (String) ID of Service account used for write logs.

Read-Only:

  • audit_logs_enabled (Boolean) Enable audit logs.
  • log_group_id (String) ID of cloud logging group.

Nested Schema for Nested Schema for spec.compute

Read-Only:

  • disks (Attributes List) Configuration of exec node strorage. (see below for nested schema)
  • name (String) Name for exec pool.
  • preset (String) VM configuration preset name.
  • scale_policy (Attributes) Exec nodes scaling policy. (see below for nested schema)

Nested Schema for Nested Schema for spec.compute.disks

Read-Only:

  • locations (List of String) Locations on a disk.
  • size_gb (Number) Size of a single disk in GB.
  • type (String) Type of a disk.

Nested Schema for Nested Schema for spec.compute.scale_policy

Read-Only:

  • auto (Attributes) Scale policy that can adjust number of running exec nodes within specified range based on some criteria. (see below for nested schema)
  • fixed (Attributes) Scale policy that doesn't change number of running exec nodes over time. (see below for nested schema)

Nested Schema for Nested Schema for spec.compute.scale_policy.auto

Read-Only:

  • max_size (Number) package: yandex.cloud.ytsaurus.v1
    filename: yandex/cloud/ytsaurus/v1/cluster.proto
  • min_size (Number) package: yandex.cloud.ytsaurus.v1
    filename: yandex/cloud/ytsaurus/v1/cluster.proto

Nested Schema for Nested Schema for spec.compute.scale_policy.fixed

Read-Only:

  • size (Number) package: yandex.cloud.ytsaurus.v1
    filename: yandex/cloud/ytsaurus/v1/cluster.proto

Nested Schema for Nested Schema for spec.cron

Read-Only:

  • clear_tmp (Attributes) Cluster regular tmp-account cleaning settings. (see below for nested schema)

Nested Schema for Nested Schema for spec.cron.clear_tmp

Read-Only:

  • account_usage_ratio_save_per_owner (Number) Per account max space usage ratio.
  • account_usage_ratio_save_total (Number) Total max space usage ratio.
  • interval (String) Script starting interval.
  • max_dir_node_count (Number) Max nodes in every directory.

Nested Schema for Nested Schema for spec.odin

Read-Only:

  • checks_ttl (String) TTL of Odin check samples.

Nested Schema for Nested Schema for spec.proxy

Read-Only:

  • http (Attributes) Configuration of HTTP proxies. (see below for nested schema)
  • rpc (Attributes) Configuration of rpc proxies. (see below for nested schema)

Nested Schema for Nested Schema for spec.proxy.http

Read-Only:

  • count (Number) Total amount of HTTP proxies.

Nested Schema for Nested Schema for spec.proxy.rpc

Read-Only:

  • count (Number) Total amount of RPC proxies.

Nested Schema for Nested Schema for spec.storage

Read-Only:

  • hdd (Attributes) Configuration of cluster HDD strorage. (see below for nested schema)
  • ssd (Attributes) Configuration of cluster SSD strorage (see below for nested schema)

Nested Schema for Nested Schema for spec.storage.hdd

Read-Only:

  • count (Number) Total amount of HDD disks.
  • size_gb (Number) Size of a single HDD disk in GB.

Nested Schema for Nested Schema for spec.storage.ssd

Read-Only:

  • changelogs (Attributes) Configuration of dynamic table changelogs. (see below for nested schema)
  • count (Number) Total amount of SSD disks.
  • size_gb (Number) Size of a single SSD disk in GB.
  • type (String) Type of a SSD disk.

Nested Schema for Nested Schema for spec.storage.ssd.changelogs

Read-Only:

  • size_gb (Number) package: yandex.cloud.ytsaurus.v1
    filename: yandex/cloud/ytsaurus/v1/cluster.proto

Nested Schema for Nested Schema for spec.tablet

Read-Only:

  • count (Number) Total amount of tablet nodes.
  • preset (String) VM configuration preset name.

Was the article helpful?

Previous
ydb_topic
Next
ytsaurus_cluster
© 2026 Direct Cursus Technology L.L.C.