调用DescribeZones查询一个阿里云地域下的可用区。
接口说明
DescribeZones仅查询阿里云提供的可用区列表并返回少量库存信息。如果您需要查询具体可用区下可购买的实例规格和云盘规格,推荐您使用DescribeAvailableResource。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeZones |
系统规定参数。取值:DescribeZones |
RegionId | String | 是 | cn-hangzhou |
可用区所在的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
InstanceChargeType | String | 否 | PostPaid |
可用区里支持的资源计费方式。更多详情,请参见计费概述。取值范围:
|
SpotStrategy | String | 否 | NoSpot |
按量付费实例的竞价策略。当InstanceChargeType为PostPaid时,您可以传入该参数。更多详情,请参见抢占式实例。取值范围:
|
AcceptLanguage | String | 否 | zh-CN |
根据汉语、英语和日语筛选返回结果。更多详情,请参见RFC7231。取值范围:
默认值:zh-CN |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求ID。 |
Zones | Array of Zone |
数据中心信息Zone组成的集合。 |
|
Zone | |||
AvailableDedicatedHostTypes | List | 计算型 |
支持的专有宿主机规格,参数数据类型为List。 |
AvailableDiskCategories | List | cloud |
支持的磁盘种类集合,参数数据类型为List。 |
AvailableInstanceTypes | List | c5 |
允许创建的实例规格类型,参数数据类型为List。 |
AvailableResourceCreation | List | DedicatedHost |
允许创建的资源类型集合,参数数据类型为List。 |
AvailableResources | Array of ResourcesInfo |
可供创建的具体资源,ResourcesInfo组成的数组。 |
|
ResourcesInfo | |||
DataDiskCategories | List | cloud_ssd |
数据盘类型,参数数据类型为List。可能值:
|
InstanceGenerations | List | Ⅳ |
实例规格族代数,参数数据类型为List。 |
InstanceTypeFamilies | List | ["d1", "d1ne"] |
由实例规格族supportedInstanceTypeFamily组成的集合,参数数据类型为List。 |
InstanceTypes | List | ["ecs.g5.large"] |
实例规格,参数数据类型为List。 |
IoOptimized | Boolean | true |
是否为I/O优化实例。 |
NetworkTypes | List | VPC |
网络类型,参数数据类型为List。可能值:
|
SystemDiskCategories | List | cloud_ssd |
系统盘类型,参数数据类型为List。可能值:
|
AvailableVolumeCategories | List | san_ssd |
可以使用的共享存储类型,参数数据类型为List。 |
DedicatedHostGenerations | List | I |
专有宿主机代数,参数数据类型为List。 |
LocalName | String | 华东 1 可用区G |
可用区本地语言名。 |
ZoneId | String | cn-hangzhou-g |
可用区ID。 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=DescribeZones
&RegionId=cn-hangzhou
&InstanceChargeType=PostPaid
&SpotStrategy=NoSpot
&<公共请求参数>
正常返回示例
XML
格式
<DescribeZonesResponse>
<Zones>
<Zone>
<AvailableResourceCreation>
<ResourceTypes>Instance</ResourceTypes>
<ResourceTypes>Disk</ResourceTypes>
</AvailableResourceCreation>
<LocalName></LocalName>
<ZoneId>cn-hangzhou-d</ZoneId>
<AvailableDiskCategories>
<DiskCategories>cloud</DiskCategories>
</AvailableDiskCategories>
</Zone>
<Zone>
<AvailableResourceCreation>
<ResourceTypes>Instance</ResourceTypes>
<ResourceTypes>Disk</ResourceTypes>
</AvailableResourceCreation>
<LocalName></LocalName>
<ZoneId>cn-hangzhou-b</ZoneId>
<AvailableDiskCategories>
<DiskCategories>cloud</DiskCategories>
</AvailableDiskCategories>
</Zone>
</Zones>
<RequestId>6DB97BCC-92BA-424D-A7C8-3F6486612BAE</RequestId>
</DescribeZonesResponse>
JSON
格式
{
"RequestId": "A347EF0E-BBCC-4EFA-BD79-27AA3ACFD1BF",
"Zones": {
"Zone": [
{
"AvailableDiskCategories": {
"DiskCategories": [
"cloud"
]
},
"AvailableResourceCreation": {
"ResourceTypes": [
"Instance",
"Disk"
]
},
"LocalName": "",
"ZoneId": "cn-hangzhou-d"
},
{
"AvailableDiskCategories": {
"DiskCategories": [
"cloud"
]
},
"AvailableResourceCreation": {
"ResourceTypes": [
"Instance",
"Disk"
]
},
"LocalName": "",
"ZoneId": "cn-hangzhou-b"
}
]
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | 指定的地域ID不存在。 |
404 | InvalidInstanceChargeType.NotFound | The InstanceChargeType does not exist in our records | 指定的实例计费方式不存在。 |
400 | InvalidSpotStrategy | The specified SpotStrategy is not valid. | 指定的SpotStrategy参数无效。 |
404 | InvalidAcceptLanguage.NotFound | Only Chinese (zh-CN), English (en-US), and Japanese (ja) are allowed. | 您选择的语言类型无效,现在只支持中文、英语和日语。 |
访问错误中心查看更多错误码。