You can call this operation to query the the most recent list of available regions.

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 No DescribeRegions

The operation that you want to perform.

Set the value to DescribeRegions.

AcceptLanguage String No zh-CN

The language of the response. Valid values:

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

Response parameters

Parameter Type Example Description
Regions Array

The most recent list of available regions.
Region
LocalName String China (Shanghai)

The name of the region.
RegionEndpoint String smartag.cn-shanghai.aliyuncs.com

The endpoint of the region.
RegionId String cn-shanghai

The ID of the region.
RequestId String 2F026E79-30AD-47B6-9E7D-D1D4BA77F1F1

The ID of the request.

Examples

Sample requests

http(s)://smartag.cn-shanghai.aliyuncs.com/? Action=DescribeRegions
&<Common request parameters>

Sample success responses

XML format 

<? xml version="1.0" encoding="UTF-8" ? > 
<DescribeRegionsResponse> 
<RequestId>611CB80C-B6A9-43DB-9E38-0B0AC3D9B58F</RequestId>
<Regions>
	<Region>
		<RegionId>cn-shanghai</RegionId>
		<RegionEndpoint>smartag.cn-shanghai.aliyuncs.com</RegionEndpoint>
		<LocalName>China (Shanghai)</LocalName>
	</Region>
<Regions>
</DescribeRegionsResponse>

JSON format 

{
    "RequestId": "2F026E79-30AD-47B6-9E7D-D1D4BA77F1F1", 
    "Regions": {
        "Region": [
            {
                "RegionId": "cn-shanghai", 
                "RegionEndpoint": "smartag.cn-shanghai.aliyuncs.com", 
                "LocalName": "China (Shanghai)"
            }
        ]
    }
}

Error codes

HttpCode Error code Error message Description
403 Forbidden User not authorized to operate on the specified resource. The error message returned because you do not have the permission to manage the specified resource.
501 InnerServiceFailed Call inner service failed. The error message returned because an internal error occurred.

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