Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Истории успеха
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Доступны в регионе
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • ИИ для бизнеса
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Партнёрская программа
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Истории успеха
  • Документация
  • Блог
Проект Яндекса
© 2025 ТОО «Облачные Сервисы Казахстан»
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
  • ListHostGroupHostsRequest
  • ListHostGroupHostsResponse
  • Host
  • Replacement
  1. Справочник API
  2. gRPC (англ.)
  3. HostGroup
  4. ListHosts

Compute Cloud API, gRPC: HostGroupService.ListHosts

Статья создана
Yandex Cloud
Обновлена 26 ноября 2024 г.
  • gRPC request
  • ListHostGroupHostsRequest
  • ListHostGroupHostsResponse
  • Host
  • Replacement

Lists hosts that belongs to the specified host group.

gRPC requestgRPC request

rpc ListHosts (ListHostGroupHostsRequest) returns (ListHostGroupHostsResponse)

ListHostGroupHostsRequestListHostGroupHostsRequest

{
  "host_group_id": "string",
  "page_size": "int64",
  "page_token": "string"
}

Field

Description

host_group_id

string

Required field. ID of the host group to list hosts for.
To get the host group ID, use HostGroupService.List request.

page_size

int64

The maximum number of results per page to return. If the number of available
results is larger than page_size,
the service returns a ListHostGroupHostsResponse.next_page_token
that can be used to get the next page of results in subsequent list requests.

page_token

string

Page token. To get the next page of results,
set page_token to the ListHostGroupHostsResponse.next_page_token
returned by a previous list request.

ListHostGroupHostsResponseListHostGroupHostsResponse

{
  "hosts": [
    {
      "id": "string",
      "status": "Status",
      "server_id": "string",
      "replacement": {
        "host_id": "string",
        "deadline_at": "google.protobuf.Timestamp"
      }
    }
  ],
  "next_page_token": "string"
}

Field

Description

hosts[]

Host

Lists hosts for the specified host group.

next_page_token

string

This token allows you to get the next page of results for list requests. If the number of results
is more than ListHostGroupHostsRequest.page_size, use
next_page_token as the value
for the ListHostGroupHostsRequest.page_token query parameter
in the next list request. Each subsequent list request will have its own
next_page_token to continue paging through the results.

HostHost

Represents a dedicated host

Field

Description

id

string

ID of the host.

status

enum Status

Current status of the host. New instances are unable to start on host in DOWN status.

  • STATUS_UNSPECIFIED
  • UP
  • DOWN

server_id

string

ID of the physical server that the host belongs to.

replacement

Replacement

Set temporarily if maintenance is planned for this host, and a new host was provided as a replacement.

ReplacementReplacement

Field

Description

host_id

string

ID of the host which replaces this one.

deadline_at

google.protobuf.Timestamp

The date and time when this host will be automatically freed of instances.

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

Предыдущая
ListInstances
Следующая
UpdateHost
Проект Яндекса
© 2025 ТОО «Облачные Сервисы Казахстан»