Queries the list of zones based on parameters such as the region ID and billing method.
Operation description
DescribeZones queries only the list of zones provided by Alibaba Cloud and returns limited inventory information. To query the available instance types and disk categories in a specific zone, use DescribeAvailableResource.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| RegionId |
string |
Yes |
The region ID of the zone. You can call the DescribeRegions operation to query the latest list of Alibaba Cloud regions. |
cn-hangzhou |
| Verbose |
boolean |
No |
Specifies whether to display detailed information. Valid values:
Default value: true. |
false |
| InstanceChargeType |
string |
No |
The billing method of the resources supported in the zone. For more information, see Billing overview. Valid values:
Default value: PostPaid. |
PostPaid |
| SpotStrategy |
string |
No |
The bidding policy for pay-as-you-go instances. You can specify this parameter when
Default value: NoSpot. |
NoSpot |
| AcceptLanguage |
string |
No |
The language used to filter the returned results, such as Chinese, English, or Japanese. For more information, see RFC 7231. Valid values:
Default value: zh-CN. Valid values:
|
zh-CN |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| RequestId |
string |
The request ID. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
| Zones |
object |
||
| Zone |
array<object> |
The collection of zones and the supported resource information in each zone. |
|
|
array<object> |
|||
| ZoneId |
string |
The zone ID. |
cn-hangzhou-g |
| ZoneType |
string |
The zone type. Valid values:
|
AvailabilityZone |
| LocalName |
string |
The local name of the zone. |
China East 1 Zone G |
| AvailableResources |
object |
||
| ResourcesInfo |
array<object> |
The array of specific resources available for creation. |
|
|
array<object> |
|||
| IoOptimized |
boolean |
Indicates whether the instance is I/O optimized. |
true |
| SystemDiskCategories |
object |
||
| supportedSystemDiskCategory |
array |
The list of supported system disk categories. |
|
|
string |
The allowed system disk categories. Valid values:
|
cloud_essd |
|
| InstanceGenerations |
object |
||
| supportedInstanceGeneration |
array |
The list of supported instance family generations. |
|
|
string |
The instance family generation. |
ecs-6 |
|
| DataDiskCategories |
object |
||
| supportedDataDiskCategory |
array |
The allowed data disk categories. |
|
|
string |
The data disk category. Valid values:
|
cloud_essd |
|
| InstanceTypes |
object |
||
| supportedInstanceType |
array |
The list of supported instance types. |
|
|
string |
The list of instance types that can be created in the current zone, network type (NetworkTypes), and I/O optimization (IoOptimized). |
ecs.g5.large |
|
| InstanceTypeFamilies |
object |
||
| supportedInstanceTypeFamily |
array |
The list of allowed instance families. |
|
|
string |
The instance family. |
ecs.r7t |
|
| NetworkTypes |
object |
||
| supportedNetworkCategory |
array |
The list of supported network types. |
|
|
string |
The supported network type. Valid values:
|
vpc |
|
| AvailableResourceCreation |
object |
||
| ResourceTypes |
array |
The list of allowed resource types. |
|
|
string |
The allowed resource type. Valid values:
|
DedicatedHost |
|
| DedicatedHostGenerations |
object |
||
| DedicatedHostGeneration |
array |
The list of supported dedicated host generations. |
|
|
string |
The supported dedicated host generation. |
ddh-6 |
|
| AvailableInstanceTypes |
object |
||
| InstanceTypes |
array |
The list of all instance types that can be created in the current zone. |
|
|
string |
The instance type that can be created in the current zone. |
ecs.g6.xlarge |
|
| AvailableDiskCategories |
object |
||
| DiskCategories |
array |
The collection of allowed disk categories. |
|
|
string |
The allowed disk category. Valid values:
|
cloud |
|
| AvailableDedicatedHostTypes |
object |
||
| DedicatedHostType |
array |
The list of supported dedicated host types. |
|
|
string |
The supported dedicated host type. |
ddh.g6 |
|
| AvailableVolumeCategories |
object |
||
| VolumeCategories |
array |
The list of supported shared storage types. |
|
|
string |
The supported shared storage type. |
san_efficiency |
Examples
Success response
JSON format
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"Zones": {
"Zone": [
{
"ZoneId": "cn-hangzhou-g",
"ZoneType": "AvailabilityZone",
"LocalName": "China East 1 Zone G",
"AvailableResources": {
"ResourcesInfo": [
{
"IoOptimized": true,
"SystemDiskCategories": {
"supportedSystemDiskCategory": [
"cloud_essd"
]
},
"InstanceGenerations": {
"supportedInstanceGeneration": [
"ecs-6"
]
},
"DataDiskCategories": {
"supportedDataDiskCategory": [
"cloud_essd"
]
},
"InstanceTypes": {
"supportedInstanceType": [
"ecs.g5.large"
]
},
"InstanceTypeFamilies": {
"supportedInstanceTypeFamily": [
"ecs.r7t"
]
},
"NetworkTypes": {
"supportedNetworkCategory": [
"vpc"
]
}
}
]
},
"AvailableResourceCreation": {
"ResourceTypes": [
"DedicatedHost"
]
},
"DedicatedHostGenerations": {
"DedicatedHostGeneration": [
"ddh-6"
]
},
"AvailableInstanceTypes": {
"InstanceTypes": [
"ecs.g6.xlarge"
]
},
"AvailableDiskCategories": {
"DiskCategories": [
"cloud"
]
},
"AvailableDedicatedHostTypes": {
"DedicatedHostType": [
"ddh.g6"
]
},
"AvailableVolumeCategories": {
"VolumeCategories": [
"san_efficiency"
]
}
}
]
}
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidSpotStrategy | The specified SpotStrategy is not valid. | The specified SpotStrategy parameter is invalid. |
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | The specified region ID does not exist. |
| 404 | InvalidRegion.NotFound | The specified parameter RegionId is not valid. | |
| 404 | InvalidInstanceChargeType.NotFound | The InstanceChargeType does not exist in our records. | |
| 404 | InvalidAcceptLanguage.NotFound | Only Chinese (zh-CN), English (en-US), and Japanese (ja) are allowed. | Your selected language is invalid. Only Chinese, English, and Japanese are supported. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.