根据地域ID、计费方式等参数查询可用区信息列表。
接口说明
DescribeZones 仅查询阿里云提供的可用区列表并返回少量库存信息。如果您需要查询具体可用区下可购买的实例规格和云盘规格，推荐您使用 DescribeAvailableResource 。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试授权信息
当前API暂无授权信息透出。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 可用区所在的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
| Verbose | boolean | 否 | 是否展示详细信息。
默认值：true。 | false |
| InstanceChargeType | string | 否 | 可用区里支持的资源计费方式。更多信息，请参见计费概述。取值范围：
默认值：PostPaid。 | PostPaid |
| SpotStrategy | string | 否 | 按量付费实例的竞价策略。当
默认值：NoSpot。 | NoSpot |
| AcceptLanguage | string | 否 | 根据汉语、英语和日语筛选返回结果。更多信息，请参见RFC 7231。取值范围：
默认值：zh-CN。 | zh-CN |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"Zones": {
"Zone": [
{
"ZoneId": "cn-hangzhou-g",
"ZoneType": "AvailabilityZone",
"LocalName": "华东 1 可用区 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"
]
}
}
]
}
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidSpotStrategy | The specified SpotStrategy is not valid. | 指定的 SpotStrategy 参数无效。 |
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | 指定的地域 ID 不存在。 |
| 404 | InvalidRegion.NotFound | The specified parameter RegionId is not valid. | RegionId 参数不合法。 |
| 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. | 您选择的语言类型无效，现在只支持中文、英语和日语。 |
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2025-02-27 | OpenAPI 描述信息更新、OpenAPI 错误码发生变更 | 查看变更详情 |