功能介绍
本接口用于查看集群内专属宿主机列表信息。
URL
URL构造方法如下：
|
请求方法 |
URI |
|---|---|
|
GET |
/api/v2/dedicatedHost/clusters/{dedicatedHostClusterId}/dedicatedHosts |
请求消息
请求头
|
参数名称 |
参数值 |
|---|---|
|
Content-Type |
application/json |
请求参数
|
参数名称 |
是否必须 |
参数类型 |
参数描述 |
|---|---|---|---|
|
dedicatedHostClusterId |
是 |
String |
专属宿主机集群id |
|
page |
否 |
Integer |
分页起始页 |
|
size |
否 |
Integer |
分页大小，默认为10 |
|
region |
是 |
String |
可用区 |
请求参考示例
请求URL :
https://api-beijing-1.cmecloud.cn:8443/api/v2/dedicatedHost/clusters/291/dedicatedHosts?Version=2016-12-05&AccessKey=a9c86502c65a48a3a1de0729d62f329f&Timestamp=2021-04-02T14:50:13Z&Signature=8f3bf57d4f88d9b0c0155a8cc8c91984c68d9479&SignatureMethod=HmacSHA1&SignatureNonce=4289&SignatureVersion=V2.0&page=0&size=10®ion=RegionOne&dedicatedHostClusterId=291响应消息
响应头
|
参数名称 |
参数描述 |
|---|---|
|
Content-Type |
返回内容的MIME类型 |
响应参数
|
参数名称 |
参数类型 |
参数描述 |
|---|---|---|
|
total |
Integer |
专属宿主机数量 |
|
dedicatedHostClusterId |
String |
专属宿主机集群ID |
|
content |
Array<object> |
宿主机列表 |
|
content.dedicatedHostId |
String |
专属宿主机ID |
|
content.dedicatedHostName |
String |
专属宿主机名称 |
|
content.allocationRatio |
Double |
专属宿主机vCPU超分比 |
|
content.totalCpuNum |
Integer |
专属宿主机vCPU核数总量 |
|
content.totalMemSize |
Long |
专属宿主机内存总量 |
|
content.usedCpuNum |
Integer |
专属宿主机已使用的vCPU核数 |
|
content.usedMemSize |
Long |
专属宿主机内存已使用量 |
|
content.status |
String |
专属宿主机是否启用状态（enabled/disabled） |
|
content.state |
String |
专属宿主机运行状态（UP/DOWN） |
|
content.region |
String |
可用区 |
响应参考示例
{
"requestId": "reqId-547a89fc238bc6639659c-11f2d17c-4",
"state": "OK",
"body": {
"total": 1,
"dedicatedHostClusterId": "291",
"content": [
{
"dedicatedHostId": "1544397e455f4f2a85a8ebeaea311177",
"dedicatedHostName": "test030801-011",
"usedCpuNum": 9,
"totalCpuNum": 48,
"usedMemSize": 10240,
"totalMemSize": 776192,
"status": "enabled",
"state": "up",
"allocationRatio": 2,
"region": "RegionOne"
}
]
}
}