调用DescribeRegions查询您可以使用的阿里云地域。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeRegions

系统规定参数。取值：DescribeRegions
InstanceChargeType String 否 PrePaid

实例的计费方式，更多详情，请参见计费概述。取值范围：

  • PrePaid：包年包月。此时，您必须确认自己的账号支持余额支付或者信用支付，否则将报错InvalidPayMethod。
  • PostPaid：按量付费。

默认值：PostPaid
ResourceType String 否 instance

资源类型。取值范围：

  • instance：ECS实例
  • disk：磁盘
  • reservedinstance：预留实例券
  • scu：存储容量单位包

默认值：instance
AcceptLanguage String 否 zh-CN

根据汉语、英语和日语筛选返回结果。更多详情，请参见RFC7231。取值范围：

  • zh-CN：中文
  • en-US：英文
  • ja：日文

默认值：zh-CN

返回数据

名称 类型 示例值 描述
Regions Array

地域信息集合。
Region
LocalName String China (Qingdao)

地域名称。
RegionEndpoint String ecs.aliyuncs.com

地域对应的接入地址（Endpoint）。
RegionId String cn-qingdao-et2-bo1

地域ID。
Status String available

集群是否售罄。可能值：

  • available
  • soldOut
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeRegions
&RegionId=cn-qingdao
&InstanceChargeType=PrePaid
&ResourceType=Instance
&AcceptLanguage=en-US
&<公共请求参数>

正常返回示例

XML 格式 

<DescribeRegionsResponse>
      <RequestId>38EC7366-F5A9-46B1-BDB1-0FDC2E296397</RequestId>
      <Regions>
            <Region>
                  <RegionId>cn-qingdao-et2-bo1</RegionId>
                  <RegionEndpoint>ecs.aliyuncs.com</RegionEndpoint>
                  <LocalName>China (Qingdao)</LocalName>
            </Region>
            <Region>
                  <RegionId>cn-qingdao-nebula</RegionId>
                  <RegionEndpoint>ecs.cn-qingdao-nebula.aliyuncs.com</RegionEndpoint>
                  <LocalName>cn-qingdao-nebula</LocalName>
            </Region>
      </Regions>
</DescribeRegionsResponse>

JSON 格式 

{
    "RequestId": "38EC7366-F5A9-46B1-BDB1-0FDC2E296397",
    "Regions": {
        "Region": [
            {
                "RegionId": "cn-qingdao-et2-b01",
                "RegionEndpoint": "ecs.aliyuncs.com",
                "LocalName": "China (Qingdao)"
            },
            {
                "RegionId": "cn-qingdao-nebula",
                "RegionEndpoint": "ecs.cn-qingdao-nebula.aliyuncs.com",
                "LocalName": "cn-qingdao-nebula"
            }
        ]
    }
}

错误码

HttpCode 错误码 错误信息 描述
403 Unauthorized.EmptyRegion The specified account has no access authority to any region. 当前账号未被授权访问任何地域，请您授权后再重试。
404 InvalidAcceptLanguage.NotFound Only Chinese (zh-CN), English (en-US), and Japanese (ja) are allowed. 您选择的语言类型无效，现在只支持中文、英语和日语。
404 InvalidResourceType.NotFound The ResourceType provided does not exist in our records. 指定的资源类型不存在。

访问错误中心查看更多错误码。