DescribeRegions

在使用弹性伸缩前,您可以先通过调用API DescribeRegions查询可以在哪些地域使用弹性伸缩服务,方便您选择最适合的地域和可用区来使用弹性伸缩服务,确保在所选地域内获得良好的访问性能。

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String DescribeRegions

系统规定参数。取值:DescribeRegions

AcceptLanguage String zh-CN

根据所选语言筛选返回结果,更多信息,请参见RFC7231。取值范围:

  • zh-CN:根据汉语筛选。
  • en-US:根据英语筛选。
  • ja:根据日语筛选。

默认值:zh-CN。

返回数据

名称

类型

示例值

描述

RequestId String 73469C7-AA6F-4DC5-B3DB-A3DC0DE3****

请求ID。

Regions Array of Region

地域信息的集合。

Region
ClassicUnavailable Boolean false

当前地域是否支持经典网络类型的伸缩组。取值范围:

  • true:不支持。
  • false:支持。
RegionEndpoint String ess.aliyuncs.com

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

LocalName String 华北2 (北京)

地域名称。

VpcUnavailable Boolean false

当前地域是否支持VPC网络类型的伸缩组。取值范围:

  • true:不支持。
  • false:支持。
RegionId String cn-beijing

地域ID。

示例

请求示例

http(s)://ess.aliyuncs.com/?Action=DescribeRegions
&AcceptLanguage=zh-CN
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeRegionsResponse>
    <RequestId>73469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
    <Regions>
        <ClassicUnavailable>false</ClassicUnavailable>
        <RegionEndpoint>ess.aliyuncs.com</RegionEndpoint>
        <LocalName>华北2 (北京)</LocalName>
        <VpcUnavailable>false</VpcUnavailable>
        <RegionId>cn-beijing</RegionId>
    </Regions>
</DescribeRegionsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "73469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "Regions" : [ {
    "ClassicUnavailable" : false,
    "RegionEndpoint" : "ess.aliyuncs.com",
    "LocalName" : "华北2 (北京)",
    "VpcUnavailable" : false,
    "RegionId" : "cn-beijing"
  } ]
}

错误码

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

HttpCode

错误码

错误信息

描述

404

InvalidAcceptLanguage.NotFound

Only Chinese (zh-CN), English (en-US), and Japanese (ja) are allowed.

不支持指定的语言。