Managed Service for Redis API, REST: Cluster.listHosts
Retrieves a list of hosts for the specified cluster.
HTTP request
GET https://mdb.api.cloud.yandex.net/managed-redis/v1/clusters/{clusterId}/hosts
Path parameters
Parameter | Description |
---|---|
clusterId | Required. ID of the Redis cluster. To get the Redis cluster ID use a list request. The maximum string length in characters is 50. |
Query parameters
Parameter | Description |
---|---|
pageSize | The maximum number of results per page to return. If the number of available results is larger than pageSize, the service returns a nextPageToken that can be used to get the next page of results in subsequent list requests. Acceptable values are 0 to 1000, inclusive. |
pageToken | Page token. To get the next page of results, set pageToken to the 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",
"subnetId": "string",
"resources": {
"resourcePresetId": "string",
"diskSize": "string",
"diskTypeId": "string"
},
"role": "string",
"health": "string",
"services": [
{
"type": "string",
"health": "string"
}
],
"shardName": "string",
"replicaPriority": "integer",
"assignPublicIp": true
}
],
"nextPageToken": "string"
}
Field | Description |
---|---|
hosts[] | object List of hosts for the cluster. |
hosts[]. name |
string Name of the Redis host. The host name is assigned by MDB 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. |
hosts[]. clusterId |
string ID of the Redis cluster. The ID is assigned by MDB at creation time. |
hosts[]. zoneId |
string ID of the availability zone where the Redis host resides. |
hosts[]. subnetId |
string ID of the subnet that the host belongs to. |
hosts[]. resources |
object Resources allocated to the Redis host. |
hosts[]. resources. resourcePresetId |
string ID of the preset for computational resources available to a host (CPU, memory etc.). All available presets are listed in the documentation. |
hosts[]. resources. diskSize |
string (int64) Volume of the storage available to a host, in bytes. |
hosts[]. resources. diskTypeId |
string Type of the storage environment for the host. Possible values:
|
hosts[]. role |
string Role of the host in the cluster. If the field has default value, it is not returned in the response.
|
hosts[]. health |
string Aggregated health of the host. If the field has default value, it is not returned in the response.
|
hosts[]. services[] |
object Services provided by the host. |
hosts[]. services[]. type |
string Type of the service provided by the host. If the field has default value, it is not returned in the response.
|
hosts[]. services[]. health |
string Aggregated health of the service. If the field has default value, it is not returned in the response.
|
hosts[]. shardName |
string |
hosts[]. replicaPriority |
integer (int64) A replica with a low priority number is considered better for promotion. A replica with priority of 0 will never be selected by Redis Sentinel for promotion. Works only for non-sharded clusters. Default value is 100. |
hosts[]. assignPublicIp |
boolean (boolean) Flag showing public IP assignment status to this host. |
nextPageToken | string This token allows you to get the next page of results for list requests. If the number of results is larger than pageSize, use the nextPageToken as the value for the pageToken query parameter in the next list request. Each subsequent list request will have its own nextPageToken to continue paging through the results. |