Queries the available regions and zones of PolarDB.
Debugging
Request parameters
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
| Action | String | No | DescribeRegions |
The operation that you want to perform. Set the value to DescribeRegions. |
Response parameters
| Parameter | Type | Example | Description |
|---|---|---|---|
| Regions | Array of Region |
The list of regions. |
|
| Region | |||
| RegionId | String | cn-hangzhou |
The ID of the region. |
| Zones | Array of Zone |
The list of zones. |
|
| Zone | |||
| VpcEnabled | Boolean | true |
Indicates whether virtual private clouds (VPCs) are supported. |
| ZoneId | String | cn-hangzhou-g |
The ID of the zone. |
| RequestId | String | 3F9E6A3B-C13E-4064-A010-18582A****** |
The ID of the request. |
Examples
Sample requests
http(s)://polardb.aliyuncs.com/? Action=DescribeRegions
&<Common request parameters>Sample success responses
XML format
<DescribeRegionsResponse>
<RequestId>3F9E6A3B-C13E-4064-A010-18582A******</RequestId>
<Regions>
<Region>
<RegionId>cn-hangzhou</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-hangzhou-h</ZoneId>
</Zone>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-hangzhou-i</ZoneId>
</Zone>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-hangzhou-g</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>cn-shanghai</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-shanghai-e</ZoneId>
</Zone>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-shanghai-f</ZoneId>
</Zone>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-shanghai-j</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>cn-qingdao</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-qingdao-b</ZoneId>
</Zone>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-qingdao-c</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>cn-beijing</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-beijing-h</ZoneId>
</Zone>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-beijing-g</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>cn-zhangjiakou</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-zhangjiakou-b</ZoneId>
</Zone>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-zhangjiakou-a</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>cn-huhehaote</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-huhehaote-a</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>cn-shenzhen</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-shenzhen-d</ZoneId>
</Zone>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-shenzhen-e</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>cn-chengdu</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-chengdu-b</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>cn-hongkong</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-hongkong-b</ZoneId>
</Zone>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>cn-hongkong-c</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>ap-southeast-1</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>ap-southeast-1c</ZoneId>
</Zone>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>ap-southeast-1a</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>ap-southeast-2</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>ap-southeast-2b</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>ap-southeast-3</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>ap-southeast-3b</ZoneId>
</Zone>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>ap-southeast-3a</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>ap-southeast-5</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>ap-southeast-5b</ZoneId>
</Zone>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>ap-southeast-5a</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>ap-northeast-1</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>ap-northeast-1b</ZoneId>
</Zone>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>ap-northeast-1a</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>ap-south-1</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>ap-south-1b</ZoneId>
</Zone>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>ap-south-1a</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>eu-central-1</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>eu-central-1b</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>eu-west-1</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>eu-west-1a</ZoneId>
</Zone>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>eu-west-1b</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>us-west-1</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>us-west-1a</ZoneId>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>us-east-1</RegionId>
<Zones>
<Zone>
<VpcEnabled>true</VpcEnabled>
<ZoneId>us-east-1b</ZoneId>
</Zone>
</Zones>
</Region>
</Regions>
</DescribeRegionsResponse>JSON format
{
"RequestId": "3F9E6A3B-C13E-4064-A010-18582A******",
"Regions": {
"Region": [
{
"RegionId": "cn-hangzhou",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "cn-hangzhou-h"
},
{
"VpcEnabled": true,
"ZoneId": "cn-hangzhou-i"
},
{
"VpcEnabled": true,
"ZoneId": "cn-hangzhou-g"
}
]
}
},
{
"RegionId": "cn-shanghai",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "cn-shanghai-e"
},
{
"VpcEnabled": true,
"ZoneId": "cn-shanghai-f"
},
{
"VpcEnabled": true,
"ZoneId": "cn-shanghai-j"
}
]
}
},
{
"RegionId": "cn-qingdao",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "cn-qingdao-b"
},
{
"VpcEnabled": true,
"ZoneId": "cn-qingdao-c"
}
]
}
},
{
"RegionId": "cn-beijing",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "cn-beijing-h"
},
{
"VpcEnabled": true,
"ZoneId": "cn-beijing-g"
}
]
}
},
{
"RegionId": "cn-zhangjiakou",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "cn-zhangjiakou-b"
},
{
"VpcEnabled": true,
"ZoneId": "cn-zhangjiakou-a"
}
]
}
},
{
"RegionId": "cn-huhehaote",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "cn-huhehaote-a"
}
]
}
},
{
"RegionId": "cn-shenzhen",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "cn-shenzhen-d"
},
{
"VpcEnabled": true,
"ZoneId": "cn-shenzhen-e"
}
]
}
},
{
"RegionId": "cn-chengdu",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "cn-chengdu-b"
}
]
}
},
{
"RegionId": "cn-hongkong",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "cn-hongkong-b"
},
{
"VpcEnabled": true,
"ZoneId": "cn-hongkong-c"
}
]
}
},
{
"RegionId": "ap-southeast-1",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "ap-southeast-1c"
},
{
"VpcEnabled": true,
"ZoneId": "ap-southeast-1a"
}
]
}
},
{
"RegionId": "ap-southeast-2",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "ap-southeast-2b"
}
]
}
},
{
"RegionId": "ap-southeast-3",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "ap-southeast-3b"
},
{
"VpcEnabled": true,
"ZoneId": "ap-southeast-3a"
}
]
}
},
{
"RegionId": "ap-southeast-5",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "ap-southeast-5b"
},
{
"VpcEnabled": true,
"ZoneId": "ap-southeast-5a"
}
]
}
},
{
"RegionId": "ap-northeast-1",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "ap-northeast-1b"
},
{
"VpcEnabled": true,
"ZoneId": "ap-northeast-1a"
}
]
}
},
{
"RegionId": "ap-south-1",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "ap-south-1b"
},
{
"VpcEnabled": true,
"ZoneId": "ap-south-1a"
}
]
}
},
{
"RegionId": "eu-central-1",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "eu-central-1b"
}
]
}
},
{
"RegionId": "eu-west-1",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "eu-west-1a"
},
{
"VpcEnabled": true,
"ZoneId": "eu-west-1b"
}
]
}
},
{
"RegionId": "us-west-1",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "us-west-1a"
}
]
}
},
{
"RegionId": "us-east-1",
"Zones": {
"Zone": [
{
"VpcEnabled": true,
"ZoneId": "us-east-1b"
}
]
}
}
]
}
}Error codes
For a list of error codes, visit the API Error Center.