Queries regions.
Debugging
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 supported language. Valid values:
|
RegionId | String | Yes | cn-hangzhou |
The ID of the region. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
Regions | Array of Region |
The list of regions. |
|
Region | |||
RegionId | String | cn-beijing |
The ID of the region. |
LocalName | String | China (Beijing) |
The name of the region. |
RegionEndpoint | String | slb.aliyuncs.com |
The endpoint of the region. |
RequestId | String | 1651FBB6-4FBF-49FF-A9F5-DF5D696C7EC6 |
The ID of the request. |
Examples
Sample requests
http(s)://[Endpoint]/?Action=DescribeRegions
&<Common request parameters>
Sample success responses
XML
format
<DescribeRegionsResponse>
<RequestId>3F4E9DDA-CE30-5A46-AAC0-794CE4527E76</RequestId>
<Regions>
<Region>
<RegionId>cn-hangzhou</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>China (Hangzhou)</LocalName>
</Region>
<Region>
<RegionId>cn-shanghai</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>China (Shanghai)</LocalName>
</Region>
<Region>
<RegionId>cn-qingdao</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>China (Qingdao)</LocalName>
</Region>
<Region>
<RegionId>cn-beijing</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>China (Beijing)</LocalName>
</Region>
<Region>
<RegionId>cn-zhangjiakou</RegionId>
<RegionEndpoint>slb.cn-zhangjiakou.aliyuncs.com</RegionEndpoint>
<LocalName>China (Zhangjiakou)</LocalName>
</Region>
<Region>
<RegionId>cn-huhehaote</RegionId>
<RegionEndpoint>slb.cn-huhehaote.aliyuncs.com</RegionEndpoint>
<LocalName>China (Hohhot)</LocalName>
</Region>
<Region>
<RegionId>cn-wulanchabu</RegionId>
<RegionEndpoint>slb.cn-wulanchabu.aliyuncs.com</RegionEndpoint>
<LocalName>China (Ulanqab)</LocalName>
</Region>
<Region>
<RegionId>cn-shenzhen</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>China (Shenzhen)</LocalName>
</Region>
<Region>
<RegionId>cn-heyuan</RegionId>
<RegionEndpoint>slb.cn-heyuan.aliyuncs.com</RegionEndpoint>
<LocalName>China (Heyuan)</LocalName>
</Region>
<Region>
<RegionId>cn-guangzhou</RegionId>
<RegionEndpoint>slb.cn-guangzhou.aliyuncs.com</RegionEndpoint>
<LocalName>China (Guangzhou)</LocalName>
</Region>
<Region>
<RegionId>cn-chengdu</RegionId>
<RegionEndpoint>slb.cn-chengdu.aliyuncs.com</RegionEndpoint>
<LocalName>China (Chengdu)</LocalName>
</Region>
<Region>
<RegionId>cn-hongkong</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>China (Hong Kong)</LocalName>
</Region>
<Region>
<RegionId>ap-southeast-1</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>Singapore (Singapore)</LocalName>
</Region>
<Region>
<RegionId>ap-southeast-2</RegionId>
<RegionEndpoint>slb.ap-southeast-2.aliyuncs.com</RegionEndpoint>
<LocalName>Australia (Sydney)</LocalName>
</Region>
<Region>
<RegionId>ap-southeast-3</RegionId>
<RegionEndpoint>slb.ap-southeast-3.aliyuncs.com</RegionEndpoint>
<LocalName>Malaysia (Kuala Lumpur)</LocalName>
</Region>
<Region>
<RegionId>ap-southeast-5</RegionId>
<RegionEndpoint>slb.ap-southeast-5.aliyuncs.com</RegionEndpoint>
<LocalName>Indonesia (Jakarta)</LocalName>
</Region>
<Region>
<RegionId>ap-northeast-1</RegionId>
<RegionEndpoint>slb.ap-northeast-1.aliyuncs.com</RegionEndpoint>
<LocalName>Japan (Tokyo)</LocalName>
</Region>
<Region>
<RegionId>ap-south-1</RegionId>
<RegionEndpoint>slb.ap-south-1.aliyuncs.com</RegionEndpoint>
<LocalName>India (Mumbai)</LocalName>
</Region>
<Region>
<RegionId>eu-central-1</RegionId>
<RegionEndpoint>slb.eu-central-1.aliyuncs.com</RegionEndpoint>
<LocalName>Germany (Frankfurt)</LocalName>
</Region>
<Region>
<RegionId>eu-west-1</RegionId>
<RegionEndpoint>slb.eu-west-1.aliyuncs.com</RegionEndpoint>
<LocalName>UK (London)</LocalName>
</Region>
<Region>
<RegionId>us-west-1</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>US (Silicon Valley)</LocalName>
</Region>
<Region>
<RegionId>us-east-1</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>US (Virginia)</LocalName>
</Region>
<Region>
<RegionId>me-east-1</RegionId>
<RegionEndpoint>slb.me-east-1.aliyuncs.com</RegionEndpoint>
<LocalName>UAE (Dubai)</LocalName>
</Region>
<Region>
<RegionId>ap-southeast-6</RegionId>
<RegionEndpoint>slb.ap-southeast-6.aliyuncs.com</RegionEndpoint>
<LocalName>Philippines (Manila)</LocalName>
</Region>
</Regions>
</DescribeRegionsResponse>
JSON
format
{
"RequestId": "3F4E9DDA-CE30-5A46-AAC0-794CE4527E76",
"Regions": {
"Region": [
{
"RegionId": "cn-hangzhou",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "China (Hangzhou)"
},
{
"RegionId": "cn-shanghai",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "China (Shanghai)"
},
{
"RegionId": "cn-qingdao",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "China (Qingdao)"
},
{
"RegionId": "cn-beijing",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "China (Beijing)"
},
{
"RegionId": "cn-zhangjiakou",
"RegionEndpoint": "slb.cn-zhangjiakou.aliyuncs.com",
"LocalName": "China (Zhangjiakou)"
},
{
"RegionId": "cn-huhehaote",
"RegionEndpoint": "slb.cn-huhehaote.aliyuncs.com",
"LocalName": "China (Hohhot)"
},
{
"RegionId": "cn-wulanchabu",
"RegionEndpoint": "slb.cn-wulanchabu.aliyuncs.com",
"LocalName": "China (Ulanqab)"
},
{
"RegionId": "cn-shenzhen",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "China (Shenzhen)"
},
{
"RegionId": "cn-heyuan",
"RegionEndpoint": "slb.cn-heyuan.aliyuncs.com",
"LocalName": "China (Heyuan)"
},
{
"RegionId": "cn-guangzhou",
"RegionEndpoint": "slb.cn-guangzhou.aliyuncs.com",
"LocalName": "China (Guangzhou)"
},
{
"RegionId": "cn-chengdu",
"RegionEndpoint": "slb.cn-chengdu.aliyuncs.com",
"LocalName": "China (Chengdu)"
},
{
"RegionId": "cn-hongkong",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "China (Hong Kong)"
},
{
"RegionId": "ap-southeast-1",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "Singapore (Singapore)"
},
{
"RegionId": "ap-southeast-2",
"RegionEndpoint": "slb.ap-southeast-2.aliyuncs.com",
"LocalName": "Australia (Sydney)"
},
{
"RegionId": "ap-southeast-3",
"RegionEndpoint": "slb.ap-southeast-3.aliyuncs.com",
"LocalName": "Malaysia (Kuala Lumpur)"
},
{
"RegionId": "ap-southeast-5",
"RegionEndpoint": "slb.ap-southeast-5.aliyuncs.com",
"LocalName": "Indonesia (Jakarta)"
},
{
"RegionId": "ap-northeast-1",
"RegionEndpoint": "slb.ap-northeast-1.aliyuncs.com",
"LocalName": "Japan (Tokyo)"
},
{
"RegionId": "ap-south-1",
"RegionEndpoint": "slb.ap-south-1.aliyuncs.com",
"LocalName": "India (Mumbai)"
},
{
"RegionId": "eu-central-1",
"RegionEndpoint": "slb.eu-central-1.aliyuncs.com",
"LocalName": "Germany (Frankfurt)"
},
{
"RegionId": "eu-west-1",
"RegionEndpoint": "slb.eu-west-1.aliyuncs.com",
"LocalName": "UK (London)"
},
{
"RegionId": "us-west-1",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "US (Silicon Valley)"
},
{
"RegionId": "us-east-1",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "US (Virginia)"
},
{
"RegionId": "me-east-1",
"RegionEndpoint": "slb.me-east-1.aliyuncs.com",
"LocalName": "UAE (Dubai)"
},
{
"RegionId": "ap-southeast-6",
"RegionEndpoint": "slb.ap-southeast-6.aliyuncs.com",
"LocalName": "Philippines (Manila)"
}
]
}
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
400 | InvalidParameter | InvalidParameter | The error message returned because a parameter is set to an invalid value. Check the usage notes and change the value accordingly. |
400 | InvalidParameter | Illegal parameter, query.namespace is not auth. | The error message returned because you are unauthorized to perform the operation. Acquire the permissions and try again. |
For a list of error codes, visit the API Error Center.