接口功能介绍
该接口供用户查询其所属专属云的统计信息。
接口约束
无
URI
GET /v4/dec/statistics-dec
路径参数
无
Query参数
无
请求参数
请求头header参数
无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 资源池ID，您可以调用regionID查看最新的天翼云资源池列表 | ef901a5734964ce29eedac918c4716a3 | |
| azName | 是 | String | 可用区名称，您可以调用获取资源池信息，查询结果中zoneList内返回存在可用区名称(即多可用区，本字段填写实际可用区名称)，若查询结果中zoneList为空(即为单可用区，本字段填写default)。 | az2 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码(800为成功，900为失败) | 800 | |
| errorCode | String | 业务细分码，为product.module.code三段式码，详见错误码说明 | Openapi.PatternCheck.NotValid | |
| message | String | 失败时的错误描述，一般为英文描述 | SUCCESS | |
| description | String | 失败时的错误描述，一般为中文描述 | 成功 | |
| returnObj | Object | 成功时返回的数据 | returnObj |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| total_memory_mb | Float | 总内存大小 | 1542613.9296875 | |
| vcpus_used | Integer | 已用vcpu数量 | 203 | |
| total_vms | Integer | 总云主机数量 | 25 | |
| host | Integer | 宿主机数量 | 3 | |
| memory_mb_free | Float | 可用内存 | 1035733.9296875 | |
| memory_mb_used | Float | 已用内存 | 506880.0 | |
| vcpus_free | Integer | 可用vcpu数量 | 53 | |
| total_vcpus | Integer | 总vcpu数量 | 256 |
枚举参数
无
请求示例
请求url
示例：查询专属云的统计信息
GET '.../v4/dec/statistics-dec?regionID=bb9fdb42056f11eda1610242ac110002'
请求头header
无
请求体body
无
响应示例
{
"returnObj": {
"totalVMs": 2,
"totalHostCount": 1,
"freeMemSize": 512156.640625,
"usedVCPUs": 2,
"freeVCPUs": 62,
"totalVCPUs": 64,
"usedMemSize": 2048,
"totalMemSize": 514204.640625
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
请参考 状态码
错误码
请参考 错误码
