Discuss with expertTry it for free
© 2026 Direct Cursus Technology L.L.C.

Managed Service for Greenplum® API, REST: Cluster.ListSegmentHosts

Written by
Updated at July 13, 2026
View in Markdown

Retrieves a list of segment hosts for the specified cluster.

HTTP request

GET https://mdb.api.cloud.yandex.net/managed-greenplum/v1/clusters/{clusterId}/segment-hosts

Path parameters

Field

Description

clusterId

string

Required field. ID of the Greenplum® cluster.
To get the Greenplum® cluster ID use a ClusterService.List request.

The maximum string length in characters is 50.

Query parameters

Field

Description

pageSize

string (int64)

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

The maximum value is 1000.

pageToken

string

Page token. To get the next page of results, set pageToken to the ListClusterHostsResponse.nextPageToken returned by the previous list request.

The maximum string length in characters is 100.

Response

HTTP Code: 200 - OK

{
  "hosts": [
    {
      "name": "string",
      "clusterId": "string",
      "zoneId": "string",
      "type": "string",
      "resources": {
        "resourcePresetId": "string",
        "diskSize": "string",
        "diskTypeId": "string"
      },
      "health": "string",
      "subnetId": "string",
      "assignPublicIp": "boolean"
    }
  ],
  "nextPageToken": "string"
}

Field

Description

hosts[]

Host

Requested list of hosts for the cluster.

nextPageToken

string

This token allows you to get the next page of results for list requests.
If the number of results is larger than ListClusterHostsRequest.pageSize, use the nextPageToken as the value for the ListClusterHostsRequest.pageToken query parameter in the next list request.
Each subsequent list request has its own nextPageToken to continue paging through the results.

Host

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, 1-63 characters long.
The name is unique across all MDB hosts that exist on the platform, as it defines the FQDN of the host.

The maximum string length in characters is 63.

clusterId

string

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

zoneId

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.

  • 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.

subnetId

string

ID of the subnet that the host belongs to.

assignPublicIp

boolean

Determines whether a public IP is assigned to the host.

Resources

Field

Description

resourcePresetId

string

ID of the preset for computational resources allocated to a host.
Available presets are listed in the documentation.

diskSize

string (int64)

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

diskTypeId

string

Type of the storage used by the host: network-ssd or local-ssd.
Previous
ListMasterHosts
Next
ListBackups