Yandex Cloud
Поиск
Связаться с экспертомПопробовать бесплатно
  • Кейсы
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
  • Marketplace
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Искусственный интеллект
    • Безопасность
    • Инструменты DevOps
    • Бессерверные вычисления
    • Управление ресурсами
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Калькулятор цен
    • Тарифы
    • Акции и free tier
  • Кейсы
  • Документация
  • Блог
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ООО «Яндекс.Облако»
Yandex Compute Cloud
  • Yandex Container Solution
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
    • Аутентификация в API
      • Overview
        • Overview
        • Get
        • List
        • Create
        • Update
        • Delete
        • ListOperations
        • ListInstances
        • ListHosts
        • UpdateHost
        • ListAccessBindings
        • SetAccessBindings
        • UpdateAccessBindings
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • История изменений
  • Обучающие курсы

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

  • gRPC request
  • GetHostGroupRequest
  • HostGroup
  • ScalePolicy
  • FixedScale
  1. Справочник API
  2. gRPC (англ.)
  3. HostGroup
  4. Get

Compute Cloud API, gRPC: HostGroupService.Get

Статья создана
Yandex Cloud
Обновлена 1 июня 2026 г.
  • gRPC request
  • GetHostGroupRequest
  • HostGroup
  • ScalePolicy
  • FixedScale

Returns the specified host group.

gRPC requestgRPC request

rpc Get (GetHostGroupRequest) returns (HostGroup)

GetHostGroupRequestGetHostGroupRequest

{
  "host_group_id": "string"
}

Field

Description

host_group_id

string

ID of the host group to return.
To get the host group ID, use HostGroupService.List request.
The length must be less than or equal to 50.
This field is required.

HostGroupHostGroup

{
  "id": "string",
  "folder_id": "string",
  "created_at": "google.protobuf.Timestamp",
  "name": "string",
  "description": "string",
  "labels": "map<string, string>",
  "zone_id": "string",
  "status": "Status",
  "type_id": "string",
  "maintenance_policy": "MaintenancePolicy",
  "scale_policy": {
    // Includes only one of the fields `fixed_scale`
    "fixed_scale": {
      "size": "int64"
    }
    // end of the list of possible fields
  }
}

Represents group of dedicated hosts

Field

Description

id

string

ID of the group.

folder_id

string

ID of the folder that the group belongs to.

created_at

google.protobuf.Timestamp

Creation timestamp in RFC3339 text format.

name

string

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

description

string

Description of the group.

labels

object (map<string, string>)

Resource labels as key:value pairs.

zone_id

string

Availability zone where all dedicated hosts are allocated.

status

enum Status

Status of the group.

  • CREATING
  • READY
  • UPDATING
  • DELETING

type_id

string

ID of host type. Resources provided by each host of the group.

maintenance_policy

enum MaintenancePolicy

Behaviour on maintenance events.

  • RESTART: Restart instance to move it to another host during maintenance
  • MIGRATE: Use live migration to move instance to another host during maintenance

scale_policy

ScalePolicy

Scale policy. Only fixed number of hosts are supported at this moment.

ScalePolicyScalePolicy

Field

Description

fixed_scale

FixedScale

Includes only one of the fields fixed_scale.

FixedScaleFixedScale

Field

Description

size

int64

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

Предыдущая
Overview
Следующая
List
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ООО «Яндекс.Облако»