说明:当前页面接口为旧版 API,未来可能停止维护,目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范,访问时延下降显著,建议使用 云服务器 API 3.0。
1. 接口描述
本接口(DescribeRegions)用于查询地域信息。
接口请求域名:cvm.api.qcloud.com
- 地域的定义详见 地域和可用区。
2. 输入参数
本接口无接口请求参数,只需传入公共请求参数即可,见 公共请求参数 页面。
注意:此接口可以不用传入公共请求参数中的 Region 参数。
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
RequestId | String | 请求 ID。 |
TotalCount | Integer | 地域数量。 |
RegionSet | array of Region objects | 地域列表。 |
4. 错误码
详见 公共错误码。
5. 示例
输入
https://cvm.api.qcloud.com/v2/index.php?Action=DescribeRegions &Version=2017-03-12 &<公共请求参数>
输出
{ "Response": { "TotalCount": 10, "RegionSet": [ { "Region": "ap-beijing", "RegionName": "华北地区(北京)", "RegionState": "AVAILABLE" }, { "Region": "ap-guangzhou", "RegionName": "华南地区(广州)", "RegionState": "AVAILABLE" }, { "Region": "ap-guangzhou-open", "RegionName": "华南地区(广州Open)", "RegionState": "AVAILABLE" }, { "Region": "ap-hongkong", "RegionName": "港澳台地区(中国香港)", "RegionState": "AVAILABLE" }, { "Region": "ap-shanghai", "RegionName": "华东地区(上海)", "RegionState": "AVAILABLE" }, { "Region": "ap-shanghai-fsi", "RegionName": "华东地区(上海金融)", "RegionState": "AVAILABLE" }, { "Region": "ap-shenzhen-fsi", "RegionName": "华南地区(深圳金融)", "RegionState": "AVAILABLE" }, { "Region": "ap-singapore", "RegionName": "亚太东南(新加坡)", "RegionState": "AVAILABLE" }, { "Region": "na-siliconvalley", "RegionName": "美国西部(硅谷)", "RegionState": "AVAILABLE" } ], "RequestId": "C563943B-3BEA-FE92-29FE-591EAEB7871F" } }