说明：当前页面接口为旧版 API，未来可能停止维护，目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范，访问时延下降显著，建议使用 云服务器 API 3.0。
1. 接口描述
本接口 (DescribeAvailabilityZones) 用于查询腾讯云可用区的详细信息。
接口请求域名：cvm.api.qcloud.com
- 可用区的定义请参看 地域和可用区。
- 内容包括可用区具体的 IDC。
- 可以指定可用区 ID 来查看单一可用区的信息。
- 可用区 ID 列表如下：
| 可用区名称 | 可用区 ID |
|---|---|
| 广州一区 | 100001 |
| 广州二区 | 100002 |
| 广州三区 | 100003 |
| 广州四区 | 100004 |
| 上海一区 | 200001 |
| 上海二区 | 200002 |
| 香港一区 | 300001 |
| 多伦多一区 | 400001 |
| 上海金融一区 | 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
}
}