Queries available regions.

Make the API call

You can use OpenAPI Explorer to make API calls, search for API calls, perform debugging, and generate SDK example code.

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 returned value. Valid values:

  • zh-CN(Default): Chinese
  • en-US: English

Response parameters

Parameter Type Example value Description
Regions Array

A list of available regions.

Region

A list of available regions.

LocalName String  China (Qingdao)

The name of the region.

RegionEndpoint String  vpc.aliyuncs.com

The endpoint of the region service.

RegionId String  cn-qingdao

The ID of the region.

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

The ID of the request.

Examples

Request example


http(s)://vpc.aliyuncs.com/? Action=DescribeRegions
&<CommonParameters>

Response example

XML format

<DescribeRegionsResponse> 
  <RequestId>2F026E79-30AD-47B6-9E7D-D1D4BA77F1F1</RequestId>
  <Regions>
        <Region>
              <RegionId>cn-qingdao</RegionId>
              <RegionEndpoint>vpc.aliyuncs.com</RegionEndpoint>
              <LocalName>China (Qingdao)</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 (Qingdao)"
			},
			{
				"RegionId":"eu-central-1",
				"RegionEndpoint":"vpc.eu-central-1.aliyuncs.com",
				"LocalName":"Germany (Frankfurt)"
			}
		]
	}
}

Errors

For a list of error codes, visit the API Error Center.