Managed Service for Redis API, gRPC: ClusterService.ListHosts
Retrieves a list of hosts for the specified cluster.
gRPC request
rpc ListHosts (ListClusterHostsRequest) returns (ListClusterHostsResponse)
ListClusterHostsRequest
{
"clusterId": "string",
"pageSize": "int64",
"pageToken": "string"
}
Field |
Description |
clusterId |
string Required field. ID of the Redis cluster. |
pageSize |
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 |
ListClusterHostsResponse
{
"hosts": [
{
"name": "string",
"clusterId": "string",
"zoneId": "string",
"subnetId": "string",
"resources": {
"resourcePresetId": "string",
"diskSize": "int64",
"diskTypeId": "string"
},
"role": "Role",
"health": "Health",
"services": [
{
"type": "Type",
"health": "Health"
}
],
"shardName": "string",
"replicaPriority": "google.protobuf.Int64Value",
"assignPublicIp": "bool"
}
],
"nextPageToken": "string"
}
Field |
Description |
hosts[] |
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 Redis 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 Redis cluster. The ID is assigned by MDB at creation time. |
zoneId |
string ID of the availability zone where the Redis host resides. |
subnetId |
string ID of the subnet that the host belongs to. |
resources |
Resources allocated to the Redis host. |
role |
enum Role Role of the host in the cluster. If the field has default value, it is not returned in the response.
|
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. |
shardName |
string |
replicaPriority |
A replica with a low priority number is considered better for promotion. |
assignPublicIp |
bool Flag showing public IP assignment status to this host. |
Resources
Field |
Description |
resourcePresetId |
string ID of the preset for computational resources available to a host (CPU, memory etc.). |
diskSize |
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.
|