DescribeRegions - Auto Scaling - Alibaba Cloud Documentation Center

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

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

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

zh-CN

The language for the response. For more information, see RFC7231. Valid values:

zh-CN: Chinese
en-US: English
ja: Japanese

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: true false
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: true false
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.