查询可用区列表

最近更新时间: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"
    }
}