接口功能介绍
查询账户指定资源池中可用区的信息。
接口约束
无
URI
POST /v4/ecs/describe-availability-zones
路径参数
无
Query参数
无
请求参数
请求头header参数
无
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionID | 是 | String | 资源池ID,您可以调用查询账户启用的资源池信息查看最新的天翼云资源池列表 | 533649c8eb9a11ebb25f0242ac110008 |
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 返回状态码(800 为成功,900 为失败)。 | ||
默认值 800。 | 800 | |||
errorCode | String | 错误码,为 product.module.code 三段式码。 | ||
message | String | 失败时的错误描述,一般为英文描述。 | Param is null | |
description | String | 失败时的错误描述,一般为中文描述。 | 请求为空 | |
returnObj | Object | 可用区信息。 | returnObj | |
error | String | 错误码,为product.module.code三段式码。请求成功时不返回该字段 |
表 returnObj
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
availabilityZones | Array of Objects | 可用区列表 | availabilityZones |
表 availabilityZones
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
id | String | 可用区ID | 73f321ea-62ff-11ec-a8bc-005056898fe0_az1 | |
name | String | 可用区名称 | az1 |
枚举参数
无
请求示例
请求url
无
请求头header
无
请求体body
{
"regionID": "533649c8eb9a11ebb25f0242ac110008"
}
响应示例
{
"returnObj":{
"availabilityZones":[
{
"id":"73f321ea-62ff-11ec-a8bc-005056898fe0_az1",
"name":"az1"
},
{
"id":"73f321ea-62ff-11ec-a8bc-005056898fe0_az2",
"name":"az2"
},
{
"id":"73f321ea-62ff-11ec-a8bc-005056898fe0_az3",
"name":"az3"
}
]
},
"message": "SUCCESS",
"description": "成功",
"statusCode":800
}
状态码
请参考 状态码
错误码
请参考 错误码