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

调试

前往【API Explorer】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。

请求参数

名称 类型 是否必选 示例值 描述
AcceptLanguage String zh-CN

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

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

默认值:zh-CN。

Action String DescribeRegions

系统规定参数。取值:DescribeRegions

InstanceChargeType String PrePaid

实例的计费方式,更多详情,请参阅 计费概述。取值范围:

  • PrePaid:预付费,即包年包月。此时,您必须确认自己的账号支持余额支付或者信用支付,否则将报错 InvalidPayMethod。
  • PostPaid(默认):按量付费。
ResourceType String Instance

资源类型。

返回参数

名称 类型 示例值 描述
Regions

地域信息集合

  └LocalName String 华北 1

地域名称

  └RegionEndpoint String ecs.aliyuncs.com

地域对应的接入地址(Endpoint)

  └RegionId String cn-shanghai-et2-bo1

地域 ID

  └Status String available

集群是否售罄,可能值:

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

请求 ID

示例

请求示例


https://ecs.aliyuncs.com/?Action=DescribeRegions
&InstanceChargeType=PrePaid
&ResourceType=Instance
&AcceptLanguage=null
&<公共请求参数>

正常返回示例

XML 格式

<DescribeRegionsResponse>
  <RequestId>38EC7366-F5A9-46B1-BDB1-0FDC2E296397</RequestId>
  <Regions>
    <Region>
      <RegionId>cn-shanghai-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-shanghai-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. 不支持指定的语言。

查看本产品错误码