Managed Service for ClickHouse API, REST: Cluster.ListHosts
Retrieves a list of hosts for the specified cluster.
HTTP request
GET https://mdb.api.cloud.yandex.net/managed-clickhouse/v1/clusters/{clusterId}/hosts
Path parameters
Field |
Description |
clusterId |
string Required field. ID of the ClickHouse cluster. |
Query parameters
Field |
Description |
pageSize |
string (int64) The maximum number of results per page to return. If the number of available |
pageToken |
string Page token. To get the next page of results, set |
Response
HTTP Code: 200 - OK
{
"hosts": [
{
"name": "string",
"clusterId": "string",
"zoneId": "string",
"type": "string",
"resources": {
"resourcePresetId": "string",
"diskSize": "string",
"diskTypeId": "string"
},
"health": "string",
"services": [
{
"type": "string",
"health": "string"
}
],
"subnetId": "string",
"assignPublicIp": "boolean",
"shardName": "string"
}
],
"nextPageToken": "string"
}
Field |
Description |
hosts[] |
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 |
Host
Field |
Description |
name |
string Name of the ClickHouse host. The host name is assigned by MDB 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. |
clusterId |
string ID of the ClickHouse host. The ID is assigned by MDB at creation time. |
zoneId |
string ID of the availability zone where the ClickHouse host resides. |
type |
enum (Type) Type of the host. If the field has default value, it is not returned in the response.
|
resources |
Resources allocated to the ClickHouse host. |
health |
enum (Health) Aggregated health of the host. If the field has default value, it is not returned in the response.
|
services[] |
Services provided by the host. |
subnetId |
string ID of the subnet that the host belongs to. |
assignPublicIp |
boolean Flag showing public IP assignment status to this host. |
shardName |
string |
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. |
diskTypeId |
string Type of the storage environment for the host.
|
Service
Field |
Description |
type |
enum (Type) Type of the service provided by the host. If the field has default value, it is not returned in the response.
|
health |
enum (Health) Aggregated health of the service. If the field has default value, it is not returned in the response.
|