DescribeZones - 查询可用区列表 - 云服务器 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	否	根据汉语、英语和日语筛选返回结果。更多信息，请参见 RFC7231 。取值范围： zh-CN en-US ja 默认值：zh-CN	zh-CN

返回参数

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

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

变更历史

变更时间	变更内容概要	操作

暂无变更历史