接口说明
本接口用于查询宿主机集群在预定义规格下可创建的云主机数量。容量统计需要一定时间,为了保证数据准确性,建议有资源变动后,2分钟后进行查询。
URL
POST https://ecloud.10086.cn/api/openapi-ddh/customer/v3/dedicatedHost/cloudApi/v2/cluster/capacity
请求参数
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
clusterCapacityReq
|
查询专属宿主机集群容量请求体
|
是
|
clusterCapacityReq |
|
cpu
|
integer(int32)
|
是
|
CPU大小 |
|
dedicatedHostClusterId
|
string
|
是
|
宿主机集群的ID |
|
ram
|
integer(int32)
|
是
|
内存大小(单位G) |
|
region
|
string
|
是
|
可用区,可通过查询属地的可用区信息获取。 |
请求示例
POST https://ecloud.10086.cn/api/openapi-ddh/customer/v3/dedicatedHost/cloudApi/v2/cluster/capacity
{
"cpu":"",
"dedicatedHostClusterId":"",
"ram":"",
"region":""
}
返回参数
返回码:200
OK
|
参数名称
|
类型
|
描述
|
|
body
|
查询专属宿主机集群容量返求体
|
请求成功时返回的数据 |
|
allowedCreateNum
|
integer(int32)
|
可创建资源个数 |
|
errorCode
|
string
|
统一错误码 |
|
errorMessage
|
string
|
页面国际化错误提示 |
|
errorParams
|
<string> array
|
统一错误码的自定义参数 |
|
requestId
|
string
|
每个请求的序列号 |
|
state
|
enum(OK,ERROR,EXCEPTION,ALARM,FORBIDDEN)
|
返回状态码,返回正常:OK,返回错误:ERROR,返回异常:EXCEPTION,需要告警实现的:ALARM,禁止访问:FORBIDDEN |
返回示例
返回码:200
OK
{
"body":{
"allowedCreateNum":""
},
"errorCode":"",
"errorMessage":"",
"errorParams":[
""
],
"requestId":"",
"state":""
}