Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI for business
    • Business tools
  • 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
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex Managed Service for YTsaurus
  • Getting started
  • Access management
  • Pricing policy
  • Terraform reference
    • API authentication
      • Overview
        • Overview
        • Get
        • List
        • Create
        • Update
        • Delete
        • Start
        • Stop
  • Audit Trails events
  • Release notes

In this article:

  • gRPC request
  • GetClusterRequest
  • Cluster
  • ClusterSpec
  • StorageSpec
  • HddSpec
  • SsdSpec
  • ComputeSpec
  • DiskSpec
  • ScalePolicy
  • FixedScale
  • AutoScale
  • TabletSpec
  • ProxySpec
  • HttpProxySpec
  • RpcProxySpec
  • OdinSpec
  • Endpoints
  1. API reference
  2. gRPC
  3. Cluster
  4. Get

Ytsaurus API, gRPC: ClusterService.Get

Written by
Yandex Cloud
Updated at October 30, 2025
  • gRPC request
  • GetClusterRequest
  • Cluster
  • ClusterSpec
  • StorageSpec
  • HddSpec
  • SsdSpec
  • ComputeSpec
  • DiskSpec
  • ScalePolicy
  • FixedScale
  • AutoScale
  • TabletSpec
  • ProxySpec
  • HttpProxySpec
  • RpcProxySpec
  • OdinSpec
  • Endpoints

Returns the specified cluster.

gRPC requestgRPC request

rpc Get (GetClusterRequest) returns (Cluster)

GetClusterRequestGetClusterRequest

{
  "cluster_id": "string"
}

Field

Description

cluster_id

string

Required field. ID of the cluster to return.

ClusterCluster

{
  "id": "string",
  "folder_id": "string",
  "zone_id": "string",
  "name": "string",
  "description": "string",
  "labels": "map<string, string>",
  "subnet_id": "string",
  "security_group_ids": [
    "string"
  ],
  "spec": {
    "storage": {
      "hdd": {
        "size_gb": "int64",
        "count": "int64"
      },
      "ssd": {
        "size_gb": "int64",
        "type": "string",
        "count": "int64"
      }
    },
    "compute": [
      {
        "preset": "string",
        "disks": [
          {
            "type": "string",
            "size_gb": "int64",
            "locations": [
              "string"
            ]
          }
        ],
        "scale_policy": {
          // Includes only one of the fields `fixed`, `auto`
          "fixed": {
            "size": "int64"
          },
          "auto": {
            "min_size": "int64",
            "max_size": "int64"
          }
          // end of the list of possible fields
        },
        "name": "string"
      }
    ],
    "tablet": {
      "preset": "string",
      "count": "int64"
    },
    "proxy": {
      "http": {
        "count": "int64"
      },
      "rpc": {
        "count": "int64"
      }
    },
    "odin": {
      "checks_ttl": "google.protobuf.Duration"
    },
    "flavor": "Flavor"
  },
  "created_at": "google.protobuf.Timestamp",
  "created_by": "string",
  "updated_at": "google.protobuf.Timestamp",
  "updated_by": "string",
  "status": "Status",
  "health": "Health",
  "endpoints": {
    "ui": "string",
    "external_http_proxy_balancer": "string",
    "internal_http_proxy_alias": "string",
    "internal_rpc_proxy_alias": "string"
  }
}

Field

Description

id

string

ID of the cluster. Generated at creation time.

folder_id

string

ID of the folder that the cluster belongs to.

zone_id

string

ID of the availability zone where the cluster resides.

name

string

Name of the cluster.
The name is unique within the folder.

description

string

Description of the cluster.

labels

object (map<string, string>)

Cluster labels as key:value pairs.

subnet_id

string

ID of the subnet where the cluster resides.

security_group_ids[]

string

Network interfaces security groups.

spec

ClusterSpec

Cluster specification.

created_at

google.protobuf.Timestamp

Time when the cluster was created.

created_by

string

User who created the cluster.

updated_at

google.protobuf.Timestamp

Time when the cluster was last updated.

updated_by

string

User who last updated the cluster.

status

enum Status

Status of the cluster.

  • STATUS_UNKNOWN
  • CREATING: Cluster is being created.
  • RUNNING: Cluster is running.
  • ERROR: Cluster encountered a problem and cannot operate.
  • STOPPING: Cluster is being stopped.
  • STOPPED: Cluster stopped.
  • STARTING: Cluster is being started.
  • UPDATING: Cluster is being updated.
  • DELETING: Cluster is being deleted.

health

enum Health

Health of the cluster.

  • HEALTH_UNKNOWN
  • ALIVE: Cluster is alive.
  • DEAD: Cluster is dead.
  • DEGRADED: Cluster is degraded.

endpoints

Endpoints

Endpoints of the cluster.

ClusterSpecClusterSpec

Field

Description

storage

StorageSpec

compute[]

ComputeSpec

tablet

TabletSpec

proxy

ProxySpec

odin

OdinSpec

flavor

enum Flavor

  • FLAVOR_UNSPECIFIED
  • DEMO: Demo cluster configuration with minimal system resources. Not fault-tolerant, not for production use.

StorageSpecStorageSpec

Field

Description

hdd

HddSpec

ssd

SsdSpec

HddSpecHddSpec

Field

Description

size_gb

int64

count

int64

SsdSpecSsdSpec

Field

Description

size_gb

int64

type

string

count

int64

ComputeSpecComputeSpec

Field

Description

preset

string

disks[]

DiskSpec

scale_policy

ScalePolicy

name

string

Name for exec pool.

DiskSpecDiskSpec

Field

Description

type

string

size_gb

int64

locations[]

string

ScalePolicyScalePolicy

Field

Description

fixed

FixedScale

Includes only one of the fields fixed, auto.

auto

AutoScale

Includes only one of the fields fixed, auto.

FixedScaleFixedScale

Field

Description

size

int64

AutoScaleAutoScale

Field

Description

min_size

int64

max_size

int64

TabletSpecTabletSpec

Field

Description

preset

string

count

int64

ProxySpecProxySpec

Field

Description

http

HttpProxySpec

rpc

RpcProxySpec

HttpProxySpecHttpProxySpec

Field

Description

count

int64

RpcProxySpecRpcProxySpec

Field

Description

count

int64

OdinSpecOdinSpec

Field

Description

checks_ttl

google.protobuf.Duration

EndpointsEndpoints

Field

Description

ui

string

https://CID.ui.ytsaurus.yandexcloud.net

external_http_proxy_balancer

string

https://CID.proxy.ytsaurus.yandexcloud.net

internal_http_proxy_alias

string

https://hp.CID.ytsaurus.mdb.yandexcloud.net:PORT

internal_rpc_proxy_alias

string

rp.CID.ytsaurus.mdb.yandexcloud.net:PORT

Was the article helpful?

Previous
Overview
Next
List
© 2025 Direct Cursus Technology L.L.C.