有奖捉虫:云通信与企业服务文档专题,速来> HOT
说明:

当前页面接口为旧版 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"
            },
            {
                "Region": "na-toronto",
                "RegionName": "北美地区(多伦多)",
                "RegionState": "AVAILABLE"
            }
        ],
        "RequestId": "C563943B-3BEA-FE92-29FE-591EAEB7871F"
    }
}