Managed Service for Apache Kafka® API, REST: Cluster.ListHosts
Retrieves a list of hosts for the specified Apache Kafka® cluster.
HTTP request
GET https://mdb.api.cloud.yandex.net/managed-kafka/v1/clusters/{clusterId}/hosts
Path parameters
Field |
Description |
clusterId |
string Required field. ID of the Apache Kafka® cluster. To get the Apache Kafka® cluster ID, make a ClusterService.List request. |
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 |
pageToken |
string Page token. To get the next page of results, set |
Response
HTTP Code: 200 - OK
{
"hosts": [
{
"name": "string",
"clusterId": "string",
"zoneId": "string",
"role": "string",
"resources": {
"resourcePresetId": "string",
"diskSize": "string",
"diskTypeId": "string"
},
"health": "string",
"subnetId": "string",
"assignPublicIp": "boolean"
}
],
"nextPageToken": "string"
}
Field |
Description |
hosts[] |
List of hosts. |
nextPageToken |
string Token that allows you to get the next page of results for list requests. If the number of results is larger than ListClusterHostsRequest.pageSize, use the |
Host
Cluster host metadata.
Field |
Description |
name |
string Name of the host. |
clusterId |
string ID of the Apache Kafka® cluster. |
zoneId |
string ID of the availability zone where the host resides. |
role |
enum (Role) Host role. If the field has default value, it is not returned in the response.
|
resources |
Computational resources allocated to the host. |
health |
enum (Health) Aggregated host health data. If the field has default value, it is not returned in the response.
|
subnetId |
string ID of the subnet the host resides in. |
assignPublicIp |
boolean The flag that defines whether a public IP address is assigned to the node. If the value is |
Resources
Field |
Description |
resourcePresetId |
string ID of the preset for computational resources available to a host (CPU, memory, etc.). |
diskSize |
string (int64) Volume of the storage available to a host, in bytes. Must be greater than 2 * partition segment size in bytes * partitions count, so each partition can have one active segment file and one closed segment file that can be deleted. |
diskTypeId |
string Type of the storage environment for the host. |