查询伸缩组内的云主机的可用区分布
接口功能介绍
查询伸缩组内的云主机的可用区分布
接口约束
无
URI
POST /v4/scaling/group/instance-az
路径参数
无
Query参数
无
请求参数
请求头header参数
无
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionID | 是 | String | 资源池ID | 81f7728662dd11ec810800155d307d5b | |
groupID | 是 | Integer | 伸缩组ID | 471 |
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 返回码:800表示成功,900表示失败 | 800 | |
errorCode | String | 业务细分码,为product.module.code三段式码 | Scaling.Group.NotFound | 错误码 |
message | String | 失败时的错误描述,一般为英文描述 | scaling group info not found | |
description | String | 失败时的错误描述,一般为中文描述 | 未找到弹性伸缩组信息 | |
returnObj | Object | 成功时返回的数据,参见表returnObj | returnObj |
表 returnObj
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
result | Array of Objects | 云主机可用区信息 | instanceInfo |
表 instanceInfo
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
instanceID | String | 云主机ID | 46e927ef-c85d-f729-a3bb-20a84224701e | |
instanceName | String | 云主机名称 | ecm-e1841 | |
azName | String | 可用区名称,非多可用区资源池的azName返回空字符串 | az1 |
请求示例
请求头header
无
请求体body
{
"regionID": "81f7728662dd11ec810800155d307d5b",
"groupID": 471
}
响应示例
{
"returnObj": {
"result": [
{
"instanceID": "46e927ef-c85d-f729-a3bb-20a84224701e",
"instanceName": "ecm-e1841",
"azName": "az1"
} ,
{
"instanceID": "5d0fd071-b766-30b2-b2e7-823d73f0bb81",
"instanceName": "ecm-e1842",
"azName": "az1"
}
]
},
"errorCode": "",
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
错误码
errorCode | 描述 |
---|---|
Scaling.Group.NotFound | 未找到弹性伸缩组信息 |