Queries 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 Yes 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
  • ja: Japanese

Response parameters

Parameter Type Example Description
RequestId String 2F026E79-30AD-47B6-9E7D-D1D4BA77F1F1

The ID of the request.

Regions Array of Region

A list of regions.

Region
LocalName String China (Shanghai)

The name of the region.

RegionEndpoint String smartag.cn-shanghai.aliyuncs.com

The endpoint of the Smart Access Gateway (SAG) service in the current region.

RegionId String cn-shanghai

The ID of the region.

Examples

Sample requests

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

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<?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

HTTP/1.1 200 OK
Content-Type:application/json

{
  "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
501 InnerServiceFailed Call inner service failed. The error message returned because an internal error occurred.
403 Forbidden User not authorized to operate on the specified resource. The error message returned because you do not have the permissions to manage the specified resource.

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