Queries regions. Before you activate Auto Scaling, you can call the DescribeRegions operation to query the regions where Auto Scaling is officially launched. This preliminary step facilitates the strategic selection of both the optimal region and availability zones for activating Auto Scaling, thereby guaranteeing the finest access speeds and operational efficiency within your chosen geographical area.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
Action | String | Yes | DescribeRegions | The operation that you want to perform. Set the value to DescribeRegions. |
AcceptLanguage | String | No | zh-CN | The language for the response. For more information, see RFC7231. Valid values:
Default value: zh-CN. |
Response parameters
Parameter | Type | Example | Description |
RequestId | String | 73469C7-AA6F-4DC5-B3DB-A3DC0DE3**** | The request ID. |
Regions | Array of Region | The collection of region information. | |
Region | |||
ClassicUnavailable | Boolean | false | Indicates whether the current region supports scaling groups that reside in the classic network. Valid values:
|
RegionEndpoint | String | ess.aliyuncs.com | The region endpoint. |
LocalName | String | China (Beijing) | The region name. |
VpcUnavailable | Boolean | false | Indicates whether the current region supports scaling groups that reside in virtual private clouds (VPCs). Valid values:
|
RegionId | String | cn-beijing | The region ID. |
Examples
Sample requests
http(s)://ess.aliyuncs.com/?Action=DescribeRegions
&AcceptLanguage=zh-CN
&<Common request parameters>
Sample success responses
XML
format
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> China (Beijing)</LocalName>
<VpcUnavailable>false</VpcUnavailable>
<RegionId>cn-beijing</RegionId>
</Regions>
</DescribeRegionsResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "73469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"Regions" : [ {
"ClassicUnavailable" : false,
"RegionEndpoint" : "ess.aliyuncs.com",
"LocalName": "China (Beijing)"
"VpcUnavailable" : false,
"RegionId" : "cn-beijing"
} ]
}
Error codes
For a list of error codes, see Service error codes.
HTTP status code | Error code | Error message | Description |
404 | InvalidAcceptLanguage.NotFound | Only Chinese (zh-CN), English (en-US), and Japanese (ja) are allowed. | The specified language is not supported. |