查询可用区列表

最近更新时间:2024-08-30 14:42:48

说明:

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

1. 接口描述

本接口 (DescribeAvailabilityZones) 用于查询腾讯云可用区的详细信息。

接口请求域名:cvm.api.qcloud.com

  • 可用区的定义请参看 地域和可用区
  • 内容包括可用区具体的 IDC。
  • 可以指定可用区 ID 来查看单一可用区的信息。
  • 可用区 ID 列表如下:
可用区名称 可用区 ID
广州一区 100001
广州二区 100002
广州三区 100003
广州四区 100004
上海一区 200001
上海二区 200002
香港一区 300001
上海金融一区 700001
上海金融二区 700002
北京一区 800001
北京二区 800002
新加坡一区 900001
深圳金融一区 110001
深圳金融二区 110002
广州Open专区 120001
硅谷一区 150001
成都一区 160001
成都二区 160002
法兰克福一区 170001
首尔一区 180001

2. 输入参数

以下请求参数列表仅列出了接口请求参数,其它参数见 公共请求参数 页面。

参数名称 是否必选 类型 描述
zoneId Int 可用区 ID。

3. 输出参数

参数名称 类型 描述
code Int 错误码(0:成功,其他值:失败)。
message String 错误信息。
totalCount Int 可用区的数目。
zoneSet Array 可用区列表。

zoneSet 是一个可用区信息的集合,单个可用区信息的数据结构如下:

参数名称 类型 描述
zoneId Int 可用区ID。
idcList Array IDC列表。

idcList 是可用区下属 IDC 信息的集合,单个 IDC 信息的数据结构如下:

参数名称 类型 描述
idcId Int IDC的ID值。
idcName String IDC名称。

4. 示例

输入

  https://cvm.api.qcloud.com/v2/index.php?Action=DescribeAvailabilityZones
  &<公共请求参数>
  zoneId=100001

输出

{
    "code": 0,
    "message": "",
    "totalCount": 1,
    "zoneSet": {
        "zoneName": "广州一区",
        "idcList": [{
                "idcId": 685,
                "idcName": "广州电信亚太信息AC2楼"
            },
            {
                "idcId": 737,
                "idcName": "广州电信亚太信息AC4楼02"
            },
            {
                "idcId": 798,
                "idcName": "广州移动南方基地AC2楼"
            },
            {
                "idcId": 834,
                "idcName": "广州电信人民中路AC7楼"
            },
            {
                "idcId": 908,
                "idcName": "广州电信石基AC5楼"
            },
            {
                "idcId": 1035,
                "idcName": "广州电信石基AC4楼M2"
            },
            {
                "idcId": 1327,
                "idcName": "广州电信石基AC4楼M3"
            }
        ],
        "zoneId": 100001
    }
}