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

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

  • gRPC request
  • ListClusterHostsRequest
  • ListClusterHostsResponse
  • Host
  • Resources
  1. Справочник API
  2. gRPC (англ.)
  3. Cluster
  4. ListSegmentHosts

Managed Service for Greenplum® API, gRPC: ClusterService.ListSegmentHosts

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

Retrieves a list of segment hosts for the specified cluster.

gRPC requestgRPC request

rpc ListSegmentHosts (ListClusterHostsRequest) returns (ListClusterHostsResponse)

ListClusterHostsRequestListClusterHostsRequest

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

Field

Description

cluster_id

string

Required field. ID of the Greenplum® cluster.

To get the Greenplum® cluster ID use a ClusterService.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 ListClusterHostsResponse.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 ListClusterHostsResponse.next_page_token returned by the previous list request.

ListClusterHostsResponseListClusterHostsResponse

{
  "hosts": [
    {
      "name": "string",
      "cluster_id": "string",
      "zone_id": "string",
      "type": "Type",
      "resources": {
        "resource_preset_id": "string",
        "disk_size": "int64",
        "disk_type_id": "string"
      },
      "health": "Health",
      "subnet_id": "string",
      "assign_public_ip": "bool"
    }
  ],
  "next_page_token": "string"
}

Field

Description

hosts[]

Host

Requested list of hosts for the cluster.

next_page_token

string

This token allows you to get the next page of results for list requests.

If the number of results is larger than ListClusterHostsRequest.page_size, use the next_page_token as the value for the ListClusterHostsRequest.page_token query parameter in the next list request.

Each subsequent list request has its own next_page_token to continue paging through the results.

HostHost

A Greenplum® cluster host resource.

Field

Description

name

string

Required field. Name of the Greenplum® host.

The host name is assigned by the platform at creation time and cannot be changed.

The name is unique across all MDB hosts that exist on the platform, as it defines the FQDN of the host.

cluster_id

string

ID of the Greenplum® cluster. The ID is assigned by the platform at creation time.

zone_id

string

ID of the availability zone the Greenplum® host belongs to.

type

enum Type

Type of the host. If the field has default value, it is not returned in the response.

  • TYPE_UNSPECIFIED: Host type is not specified. Default value.
  • MASTER: A Greenplum® master host.
  • REPLICA: A Greenplum® master replica host.
  • SEGMENT: A Greenplum® segment host.

resources

Resources

Resources allocated to the Greenplum® host.

health

enum Health

Aggregated health of the host. If the field has default value, it is not returned in the response.

  • UNKNOWN: Health of the host is unknown. Default value.
  • ALIVE: The host is performing all its functions normally.
  • DEAD: The host is inoperable and cannot perform any of its essential functions.
  • DEGRADED: The host is working below capacity or not fully functional.
  • UNBALANCED: One or more segments are not in the preferred role.

subnet_id

string

ID of the subnet that the host belongs to.

assign_public_ip

bool

Determines whether a public IP is assigned to the host.

ResourcesResources

Field

Description

resource_preset_id

string

ID of the preset for computational resources allocated to a host.

Available presets are listed in the documentation.

disk_size

int64

Volume of the storage used by the host, in bytes.

disk_type_id

string

Type of the storage used by the host: network-hdd, network-ssd or local-ssd.

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

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