查询可用区列表

最近更新时间:2024-10-18 11:19:17

我的收藏
说明:
当前页面接口为旧版 API,未来可能停止维护,目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范,访问时延下降显著,建议使用 云服务器 API 3.0

1. 接口描述

注:本接口为改版后的 API 接口。如需了解旧接口相关信息,请参见:查询可用区
本接口 (DescribeZones) 用于查询可用区信息。
接口请求域名:cvm.api.qcloud.com

2. 输入参数

本接口无接口请求参数,只需传入公共请求参数即可,见 公共请求参数 页面。
注意:此接口必须传入公共请求参数中的 Region 参数。

3. 输出参数

参数名称
类型
描述
RequestId
String
请求 ID。
TotalCount
Integer
可用区数量。
ZoneSet
array of Zone objects
可用区列表。

4. 错误码

5. 示例

输入
https://cvm.api.qcloud.com/v2/index.php?Action=DescribeZones
&Version=2017-03-12
&Region=ap-guangzhou
输出
{
"Response": {
"TotalCount": 3,
"ZoneSet": [
{
"Zone": "ap-guangzhou-1",
"ZoneName": "广州一区",
"ZoneId": "100001",
"ZoneState": "UNAVAILABLE"
},
{
"Zone": "ap-guangzhou-2",
"ZoneName": "广州二区",
"ZoneId": "100002",
"ZoneState": "AVAILABLE"
},
{
"Zone": "ap-guangzhou-3",
"ZoneName": "广州三区",
"ZoneId": "100003",
"ZoneState": "AVAILABLE"
}
],
"RequestId": "62DDFFC6-FDB5-44F7-20A6-59152E3D129A"
}
}