Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Истории успеха
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • ИИ для бизнеса
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Калькулятор цен
    • Тарифы
    • Промоакции и free tier
    • Правила тарификации
  • Истории успеха
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Managed Service for YTsaurus
  • Начало работы
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
    • Аутентификация в API
      • Overview
        • Overview
        • Get
        • List
        • Create
        • Update
        • Delete
        • Start
        • Stop
  • Аудитные логи Audit Trails
  • История изменений

В этой статье:

  • gRPC request
  • GetClusterRequest
  • Cluster
  • ClusterSpec
  • StorageSpec
  • HddSpec
  • SsdSpec
  • ComputeSpec
  • DiskSpec
  • ScalePolicy
  • FixedScale
  • AutoScale
  • TabletSpec
  • ProxySpec
  • HttpProxySpec
  • RpcProxySpec
  • OdinSpec
  • Endpoints
  1. Справочник API
  2. gRPC (англ.)
  3. Cluster
  4. Get

Ytsaurus API, gRPC: ClusterService.Get

Статья создана
Yandex Cloud
Обновлена 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

Была ли статья полезна?

Предыдущая
Overview
Следующая
List
Проект Яндекса
© 2025 ООО «Яндекс.Облако»