Queries one or more regions.

Debug

By using API Explorer, you can easily debug APIs, automatically generate SDK code examples, and quickly search for APIs.

Request parameters

Parameter  Type Required? Example value Description
Action  String   Yes DescribeRegions

The name of this action.  Value: 

DescribeRegions

AcceptLanguage String  No zh-CN The language of the return value. Valid values:
  • zh-CN (default) : Chinese
  • en-US: English
ProductType String No vpc

The product type.

Response parameters

Parameter Type Example value Description
Regions

A list of regions.

 └LocalName String China Qingdao

The name of the region.

 └RegionEndpoint String vpc.aliyuncs.com

The endpoint of the service in this region.

 └RegionId String cn-qingdao

The ID of the region.

RequestId String 611CB80C-B6A9-43DB-9E38-0B0AC3D9B58F

The ID of the request.

Examples

Request example


https://vpc.aliyuncs.com/?<CommonParameters>
Response example

XML format

<? xml version="1.0" encoding="UTF-8" ? > 
<DescribeRegionsResponse> 
<RequestId>611CB80C-B6A9-43DB-9E38-0B0AC3D9B58F</RequestId>
<Regions>
	<Region>
		<RegionId>cn-qingdao</RegionId>
		<RegionEndpoint>vpc.aliyuncs.com</RegionEndpoint>
		<LocalName>China North 1</LocalName>
	</Region>
	<Region>
		<RegionId>eu-central-1</RegionId>
		<RegionEndpoint>vpc.eu-central-1.aliyuncs.com</RegionEndpoint>
		<LocalName>Germany (Frankfurt)</LocalName>
	</Region>
<Regions>
</DescribeRegionsResponse>

JSON format

{
    "RequestId": "2F026E79-30AD-47B6-9E7D-D1D4BA77F1F1", 
    "Regions": {
        "Region": [
            {
                "RegionId": "cn-qingdao", 
                "RegionEndpoint": "vpc.aliyuncs.com", 
                "LocalName": "China North 1"
            }, 
            {
                "RegionId": "eu-central-1", 
                "RegionEndpoint": "vpc.eu-central-1.aliyuncs.com", 
                "LocalName": "Germany (Frankfurt)"
            }
        ]
    }
}

Error codes

See common error codes