Queries the Alibaba Cloud regions available to you.
For more information, see Regions and zones.
Debug
Request parameters
| Name | Type | Required | Example | Description |
| Action | String | Yes | DescribeRegions |
The operation to perform. Set this parameter to DescribeRegions. |
For more information about common request parameters, see Common parameters.
Response parameters
| Name | Type | Example | Description |
| RequestId | String | 4ABAEA6E-C740-5CE2-A003-643E551964F5 |
The request ID. |
| Regions | Object |
The returned regions. |
|
| Region | Array of Region |
Region |
|
| RegionId | String | cn-shanghai |
The region ID. |
Examples
Sample request
http(s)://[Endpoint]/?Action=DescribeRegions
&<Common request parameters>
Sample responses
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeRegionsResponse>
<RequestId>4ABAEA6E-C740-5CE2-A003-643E551964F5</RequestId>
<Regions>
<Region>
<RegionId>cn-hangzhou</RegionId>
</Region>
<Region>
<RegionId>cn-shanghai</RegionId>
</Region>
<Region>
<RegionId>cn-nanjing</RegionId>
</Region>
<Region>
<RegionId>cn-fuzhou</RegionId>
</Region>
<Region>
<RegionId>cn-qingdao</RegionId>
</Region>
<Region>
<RegionId>cn-beijing</RegionId>
</Region>
<Region>
<RegionId>cn-zhangjiakou</RegionId>
</Region>
<Region>
<RegionId>cn-huhehaote</RegionId>
</Region>
<Region>
<RegionId>cn-wulanchabu</RegionId>
</Region>
<Region>
<RegionId>cn-shenzhen</RegionId>
</Region>
<Region>
<RegionId>cn-heyuan</RegionId>
</Region>
<Region>
<RegionId>cn-guangzhou</RegionId>
</Region>
<Region>
<RegionId>cn-chengdu</RegionId>
</Region>
<Region>
<RegionId>cn-hongkong</RegionId>
</Region>
<Region>
<RegionId>ap-southeast-1</RegionId>
</Region>
<Region>
<RegionId>ap-southeast-2</RegionId>
</Region>
<Region>
<RegionId>ap-northeast-2</RegionId>
</Region>
<Region>
<RegionId>ap-southeast-3</RegionId>
</Region>
<Region>
<RegionId>ap-southeast-5</RegionId>
</Region>
<Region>
<RegionId>ap-northeast-1</RegionId>
</Region>
<Region>
<RegionId>eu-central-1</RegionId>
</Region>
<Region>
<RegionId>eu-west-1</RegionId>
</Region>
<Region>
<RegionId>us-west-1</RegionId>
</Region>
<Region>
<RegionId>us-east-1</RegionId>
</Region>
<Region>
<RegionId>me-east-1</RegionId>
</Region>
<Region>
<RegionId>ap-southeast-7</RegionId>
</Region>
<Region>
<RegionId>ap-south-1</RegionId>
</Region>
</Regions>
</DescribeRegionsResponse>
JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "4ABAEA6E-C740-5CE2-A003-643E551964F5",
"Regions" : {
"Region" : [ {
"RegionId" : "cn-hangzhou"
}, {
"RegionId" : "cn-shanghai"
}, {
"RegionId" : "cn-nanjing"
}, {
"RegionId" : "cn-fuzhou"
}, {
"RegionId" : "cn-qingdao"
}, {
"RegionId" : "cn-beijing"
}, {
"RegionId" : "cn-zhangjiakou"
}, {
"RegionId" : "cn-huhehaote"
}, {
"RegionId" : "cn-wulanchabu"
}, {
"RegionId" : "cn-shenzhen"
}, {
"RegionId" : "cn-heyuan"
}, {
"RegionId" : "cn-guangzhou"
}, {
"RegionId" : "cn-chengdu"
}, {
"RegionId" : "cn-hongkong"
}, {
"RegionId" : "ap-southeast-1"
}, {
"RegionId" : "ap-southeast-2"
}, {
"RegionId" : "ap-northeast-2"
}, {
"RegionId" : "ap-southeast-3"
}, {
"RegionId" : "ap-southeast-5"
}, {
"RegionId" : "ap-northeast-1"
}, {
"RegionId" : "eu-central-1"
}, {
"RegionId" : "eu-west-1"
}, {
"RegionId" : "us-west-1"
}, {
"RegionId" : "us-east-1"
}, {
"RegionId" : "me-east-1"
}, {
"RegionId" : "ap-southeast-7"
}, {
"RegionId" : "ap-south-1"
} ]
}
}
Error codes
For a list of error codes, visit the API Error Center.