You can call this operation to query the most recent region list.
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 | en-US |
The supported natural languages. Valid values:
|
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
Regions | Array |
The list of regions. |
|
Region | |||
LocalName | String | China (Hangzhou) |
The name of the region. |
RegionEndpoint | String | cassandra.aliyuncs.com |
The endpoint of the region. |
RegionId | String | cn-hangzhou |
The ID of the region. Example: cn-hangzhou. |
Zones | Array |
The list of zones. |
|
Zone | |||
Id | String | cn-hangzhou-b |
The ID of the zone. |
RequestId | String | F20BBD34-681D-4613-8EFA-259DF510A897 |
The ID of the request. |
Examples
Sample requests
http(s)://[Endpoint]/? Action=DescribeRegions
&<Common request parameters>
Sample success responses
XML
format
<RequestId>F20BBD34-681D-4613-8EFA-259DF510A897</RequestId>
<Regions>
<Region>
<RegionId>cn-hangzhou</RegionId>
<RegionEndpoint>cassandra.aliyuncs.com</RegionEndpoint>
<LocalName>China (Hangzhou)</LocalName>
<Zones>
<Zone>
<Id>cn-hangzhou-h</Id>
</Zone>
<Zone>
<Id>cn-hangzhou-i</Id>
</Zone>
<Zone>
<Id>cn-hangzhou-b</Id>
</Zone>
<Zone>
<Id>cn-hangzhou-e</Id>
</Zone>
<Zone>
<Id>cn-hangzhou-f</Id>
</Zone>
<Zone>
<Id>cn-hangzhou-g</Id>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>cn-shanghai</RegionId>
<RegionEndpoint>cassandra.aliyuncs.com</RegionEndpoint>
<LocalName>China (Shanghai)</LocalName>
<Zones>
<Zone>
<Id>cn-shanghai-g</Id>
</Zone>
<Zone>
<Id>cn-shanghai-e</Id>
</Zone>
<Zone>
<Id>cn-shanghai-f</Id>
</Zone>
<Zone>
<Id>cn-shanghai-a</Id>
</Zone>
<Zone>
<Id>cn-shanghai-b</Id>
</Zone>
<Zone>
<Id>cn-shanghai-c</Id>
</Zone>
<Zone>
<Id>cn-shanghai-d</Id>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>cn-qingdao</RegionId>
<RegionEndpoint>cassandra.aliyuncs.com</RegionEndpoint>
<LocalName>China (Qingdao)</LocalName>
<Zones>
<Zone>
<Id>cn-qingdao-b</Id>
</Zone>
<Zone>
<Id>cn-qingdao-c</Id>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>cn-beijing</RegionId>
<RegionEndpoint>cassandra.aliyuncs.com</RegionEndpoint>
<LocalName>China (Beijing)</LocalName>
<Zones>
<Zone>
<Id>cn-beijing-h</Id>
</Zone>
<Zone>
<Id>cn-beijing-g</Id>
</Zone>
<Zone>
<Id>cn-beijing-f</Id>
</Zone>
<Zone>
<Id>cn-beijing-a</Id>
</Zone>
<Zone>
<Id>cn-beijing-b</Id>
</Zone>
<Zone>
<Id>cn-beijing-c</Id>
</Zone>
<Zone>
<Id>cn-beijing-d</Id>
</Zone>
<Zone>
<Id>cn-beijing-e</Id>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>cn-shenzhen</RegionId>
<RegionEndpoint>cassandra.aliyuncs.com</RegionEndpoint>
<LocalName>China (Shenzhen)</LocalName>
<Zones>
<Zone>
<Id>cn-shenzhen-d</Id>
</Zone>
<Zone>
<Id>cn-shenzhen-e</Id>
</Zone>
<Zone>
<Id>cn-shenzhen-a</Id>
</Zone>
<Zone>
<Id>cn-shenzhen-b</Id>
</Zone>
<Zone>
<Id>cn-shenzhen-c</Id>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>cn-hongkong</RegionId>
<RegionEndpoint>cassandra.aliyuncs.com</RegionEndpoint>
<LocalName>China (Hong Kong)</LocalName>
<Zones>
<Zone>
<Id>cn-hongkong-b</Id>
</Zone>
<Zone>
<Id>cn-hongkong-c</Id>
</Zone>
</Zones>
</Region>
<Region>
<RegionId>ap-southeast-1</RegionId>
<RegionEndpoint>cassandra.aliyuncs.com</RegionEndpoint>
<LocalName>Singapore</LocalName>
<Zones>
<Zone>
<Id>ap-southeast-1c</Id>
</Zone>
<Zone>
<Id>ap-southeast-1a</Id>
</Zone>
<Zone>
<Id>ap-southeast-1b</Id>
</Zone>
</Zones>
</Region>
</Regions>
JSON
format
{
"RequestId": "F20BBD34-681D-4613-8EFA-259DF510A897",
"Regions": {
"Region": [
{
"RegionId": "cn-hangzhou",
"RegionEndpoint": "cassandra.aliyuncs.com",
"LocalName":"China (Hangzhou)",
"Zones": {
"Zone": [
{
"Id": "cn-hangzhou-h"
},
{
"Id": "cn-hangzhou-i"
},
{
"Id": "cn-hangzhou-b"
},
{
"Id": "cn-hangzhou-e"
},
{
"Id": "cn-hangzhou-f"
},
{
"Id": "cn-hangzhou-g"
}
]
}
},
{
"RegionId": "cn-shanghai",
"RegionEndpoint": "cassandra.aliyuncs.com",
"LocalName":"China (Shanghai)",
"Zones": {
"Zone": [
{
"Id": "cn-shanghai-g"
},
{
"Id": "cn-shanghai-e"
},
{
"Id": "cn-shanghai-f"
},
{
"Id": "cn-shanghai-a"
},
{
"Id": "cn-shanghai-b"
},
{
"Id": "cn-shanghai-c"
},
{
"Id": "cn-shanghai-d"
}
]
}
},
{
"RegionId": "cn-qingdao",
"RegionEndpoint": "cassandra.aliyuncs.com",
"LocalName":"China (Qingdao)",
"Zones": {
"Zone": [
{
"Id": "cn-qingdao-b"
},
{
"Id": "cn-qingdao-c"
}
]
}
},
{
"RegionId": "cn-beijing",
"RegionEndpoint": "cassandra.aliyuncs.com",
"LocalName":"China (Beijing)",
"Zones": {
"Zone": [
{
"Id": "cn-beijing-h"
},
{
"Id": "cn-beijing-g"
},
{
"Id": "cn-beijing-f"
},
{
"Id": "cn-beijing-a"
},
{
"Id": "cn-beijing-b"
},
{
"Id": "cn-beijing-c"
},
{
"Id": "cn-beijing-d"
},
{
"Id": "cn-beijing-e"
}
]
}
},
{
"RegionId": "cn-shenzhen",
"RegionEndpoint": "cassandra.aliyuncs.com",
"LocalName":"China (Shenzhen)",
"Zones": {
"Zone": [
{
"Id": "cn-shenzhen-d"
},
{
"Id": "cn-shenzhen-e"
},
{
"Id": "cn-shenzhen-a"
},
{
"Id": "cn-shenzhen-b"
},
{
"Id": "cn-shenzhen-c"
}
]
}
},
{
"RegionId": "cn-hongkong",
"RegionEndpoint": "cassandra.aliyuncs.com",
"LocalName": "China (Hong Kong)"
"Zones": {
"Zone": [
{
"Id": "cn-hongkong-b"
},
{
"Id": "cn-hongkong-c"
}
]
}
},
{
"RegionId": "ap-southeast-1",
"RegionEndpoint": "cassandra.aliyuncs.com",
"LocalName": "Singapore",
"Zones": {
"Zone": [
{
"Id": "ap-southeast-1c"
},
{
"Id": "ap-southeast-1a"
},
{
"Id": "ap-southeast-1b"
}
]
}
}
]
}
}
Error codes
For a list of error codes, visit the API Error Center.