DescribeZones查询地域可用区及可用资源-云服务器 ECS-阿里云-云服务器 ECS(ECS)-阿里云帮助中心

根据地域ID、计费方式等参数查询可用区信息列表。

接口说明

DescribeZones 仅查询阿里云提供的可用区列表并返回少量库存信息。如果您需要查询具体可用区下可购买的实例规格和云盘规格，推荐您使用 DescribeAvailableResource 。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	可用区所在的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。	cn-hangzhou
Verbose	boolean	否	是否展示详细信息。 true：展示。 false：不展示。默认值：true。	false
InstanceChargeType	string	否	可用区里支持的资源计费方式。更多信息，请参见计费概述。取值范围： PrePaid：包年包月。 PostPaid：按量付费。默认值：PostPaid。	PostPaid
SpotStrategy	string	否	按量付费实例的竞价策略。当`InstanceChargeType=PostPaid`时，您可以传入该参数。更多信息，请参见抢占式实例。取值范围： NoSpot：正常按量付费实例。 SpotWithPriceLimit：设置上限价格的抢占式实例。 SpotAsPriceGo：系统自动出价，最高按量付费价格。默认值：NoSpot。	NoSpot
AcceptLanguage	string	否	根据汉语、英语和日语筛选返回结果。更多信息，请参见RFC 7231。取值范围： zh-CN：简体中文。 zh-TW：繁体中文。 en-US：英文。 ja：日文。 fr：法语。 de：德语。 ko：韩语。默认值：zh-CN。枚举值： de : 德语 en-US : 英文 ko : 韩语 zh-TW : 繁体中文 ja : 日文 fr : 法语 zh-CN : 简体中文	zh-CN

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Zones	object
Zone	array<object>	可用区及可用区下支持的资源信息集合。
	array<object>
ZoneId	string	可用区 ID。	cn-hangzhou-g
ZoneType	string	可用区类型。可能值： AvailabilityZone：公共云可用区。 CloudBoxZone：云盒可用区。	AvailabilityZone
LocalName	string	可用区本地语言名。	华东 1 可用区 G
AvailableResources	object
ResourcesInfo	array<object>	可供创建的具体资源组成的数组。
	array<object>
IoOptimized	boolean	是否为 I/O 优化实例。	true
SystemDiskCategories	object
supportedSystemDiskCategory	array	系统盘类型列表。
	string	允许创建的系统盘类型。可能值： cloud：普通云盘。 cloud_efficiency：高效云盘。 cloud_ssd：SSD 云盘。 cloud_essd：ESSD 云盘。	cloud_essd
InstanceGenerations	object
supportedInstanceGeneration	array	支持的实例规格族代数列表。
	string	实例规格族代数。	ecs-6
DataDiskCategories	object
supportedDataDiskCategory	array	允许创建的数据盘类型。
	string	数据盘类型。可能值： cloud：普通云盘。 cloud_efficiency：高效云盘。 cloud_ssd：SSD 云盘。 cloud_essd：ESSD 云盘。 ephemeral_ssd：本地 SSD 盘。	cloud_essd
InstanceTypes	object
supportedInstanceType	array	实例规格列表。
	string	当前可用区、网络类型（NetworkTypes）、I/O 优化实例（IoOptimized）下允许创建的实例规格列表。	ecs.g5.large
InstanceTypeFamilies	object
supportedInstanceTypeFamily	array	允许创建的实例规格族列表。
	string	实例规格族。	ecs.r7t
NetworkTypes	object
supportedNetworkCategory	array	支持的网络类型列表。
	string	支持的网络类型。可能值： VPC：专有网络 VPC。 Classic：经典网络。经典网络功能已下线，详情请参见下线公告。	vpc
AvailableResourceCreation	object
ResourceTypes	array	允许创建的资源类型列表。
	string	允许创建的资源类型。可能值： VSwitch：交换机。 IoOptimized：I/O 优化实例。 Instance：实例。 DedicatedHost：专有宿主机。 Disk：云盘。	DedicatedHost
DedicatedHostGenerations	object
DedicatedHostGeneration	array	支持的专有宿主机代数列表。
	string	支持的专有宿主机代数。	ddh-6
AvailableInstanceTypes	object
InstanceTypes	array	当前可用区下可创建的所有规格列表。
	string	当前可用区下可创建的规格。	ecs.g6.xlarge
AvailableDiskCategories	object
DiskCategories	array	允许创建的云盘种类集合。
	string	允许创建的云盘种类。可能值： cloud：普通云盘。 cloud_ssd：SSD 云盘。 cloud_efficiency：高效云盘。 cloud_essd：ESSD 云盘。	cloud
AvailableDedicatedHostTypes	object
DedicatedHostType	array	支持的专有宿主机规格列表。
	string	支持的专有宿主机规格。	ddh.g6
AvailableVolumeCategories	object
VolumeCategories	array	支持的共享存储类型列表。
	string	支持的共享存储类型。	san_efficiency

示例

正常返回示例

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.
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.	您选择的语言类型无效，现在只支持中文、英语和日语。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。