Contact UsGet started
© 2025 Direct Cursus Technology L.L.C.

Managed Service for Elasticsearch API, gRPC: ClusterService.ListHosts

Written by
Updated at November 26, 2024

Retrieves a list of hosts for the specified Elasticsearch cluster.

gRPC request

rpc ListHosts (ListClusterHostsRequest) returns (ListClusterHostsResponse)

ListClusterHostsRequest

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

Field

Description

cluster_id

string

Required field. ID of the Elasticsearch cluster.

To get the Elasticsearch cluster ID, make 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.

ListClusterHostsResponse

{
  "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",
      "services": [
        {
          "type": "Type",
          "health": "Health"
        }
      ],
      "subnet_id": "string",
      "assign_public_ip": "bool"
    }
  ],
  "next_page_token": "string"
}

Field

Description

hosts[]

Host

List of hosts.

next_page_token

string

Token that 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 will have its own next_page_token to continue paging through the results.

Host

Cluster host metadata.

Field

Description

name

string

Name of the host.

cluster_id

string

ID of the Elasticsearch cluster.

zone_id

string

ID of the availability zone where the host resides.

type

enum Type

Host type.

  • TYPE_UNSPECIFIED: Host type is unspecified. Default value.
  • DATA_NODE: The host is an Elasticsearch data node.
  • MASTER_NODE: The host is an Elasticsearch master node.

resources

Resources

health

enum Health

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

  • UNKNOWN: Health of the host is unknown.
  • 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 degraded and can perform only some of its essential functions.

services[]

Service

Services provided by the host.

subnet_id

string

ID of the subnet the host resides in.

assign_public_ip

bool

The flag that defines whether a public IP address is assigned to the host.

If the value is true, then this host is available on the Internet via it's public IP address.

Resources

Computational resources.

Field

Description

resource_preset_id

string

ID of the preset for computational resources available to a host (CPU, memory etc.).
All available presets are listed in the documentation.

disk_size

int64

Volume of the storage available to a host, in bytes.

disk_type_id

string

Type of the storage environment for the host.
All available types are listed in the documentation.

Service

Cluster service metadata.

Field

Description

type

enum Type

Type of the service provided by the host.

  • TYPE_UNSPECIFIED
  • ELASTICSEARCH: The Elasticsearch service.

health

enum Health

Service health data. If the field has default value, it is not returned in the response.

  • UNKNOWN: Health of the service is unknown.
  • ALIVE: The service is working normally.
  • DEAD: The service is dead or unresponsive.
Previous
ListOperations
Next
AddHosts