AI 助理
备案控制台
官方文档
输入文档关键字查找
首页 云服务器 ECS 开发参考 API参考（ECS） API目录 地域 DescribeZones - 查询可用区列表

DescribeZones - 查询可用区列表

更新时间：
产品详情
我的收藏

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

接口说明

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

调试

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

授权信息

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

请求参数

名称类型必填描述示例值
RegionIdstring是

可用区所在的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

cn-hangzhou
Verboseboolean否

是否展示详细信息。

  • true：展示。
  • false：不展示。

默认值：true。

false
InstanceChargeTypestring否

可用区里支持的资源计费方式。更多信息，请参见计费概述。取值范围：

  • PrePaid：包年包月。
  • PostPaid：按量付费。

默认值：PostPaid。

PostPaid
SpotStrategystring否

按量付费实例的竞价策略。当InstanceChargeType=PostPaid时，您可以传入该参数。更多信息，请参见抢占式实例。取值范围：

  • NoSpot：正常按量付费实例。
  • SpotWithPriceLimit：设置上限价格的抢占式实例。
  • SpotAsPriceGo：系统自动出价，最高按量付费价格。

默认值：NoSpot。

NoSpot
AcceptLanguagestring否

根据汉语、英语和日语筛选返回结果。更多信息，请参见RFC 7231。取值范围：

  • zh-CN：简体中文。
  • zh-TW：繁体中文。
  • en-US：英文。
  • ja：日文。
  • fr：法语。
  • de：德语。
  • ko：韩语。

默认值：zh-CN。

zh-CN

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Zonesarray<object>

可用区及可用区下支持的资源信息集合。

Zoneobject
ZoneIdstring

可用区 ID。

cn-hangzhou-g
ZoneTypestring

可用区类型。可能值：

  • AvailabilityZone：公共云可用区。
AvailabilityZone
LocalNamestring

可用区本地语言名。

华东 1 可用区 G
AvailableResourcesarray<object>

可供创建的具体资源组成的数组。

ResourcesInfoobject
IoOptimizedboolean

是否为 I/O 优化实例。

true
SystemDiskCategoriesarray

系统盘类型列表。

supportedSystemDiskCategorystring

允许创建的系统盘类型。可能值：

  • cloud：普通云盘。
  • cloud_efficiency：高效云盘。
  • cloud_ssd：SSD 云盘。
  • cloud_essd：ESSD 云盘。
cloud_essd
InstanceGenerationsarray

支持的实例规格族代数列表。

supportedInstanceGenerationstring

实例规格族代数。

ecs-6
DataDiskCategoriesarray

允许创建的数据盘类型。

supportedDataDiskCategorystring

数据盘类型。可能值：

  • cloud：普通云盘。
  • cloud_efficiency：高效云盘。
  • cloud_ssd：SSD 云盘。
  • cloud_essd：ESSD 云盘。
  • ephemeral_ssd：本地 SSD 盘。
cloud_essd
InstanceTypesarray

实例规格列表。

supportedInstanceTypestring

当前可用区、网络类型（NetworkTypes）、I/O 优化实例（IoOptimized）下允许创建的实例规格列表。

ecs.g5.large
InstanceTypeFamiliesarray

允许创建的实例规格族列表。

supportedInstanceTypeFamilystring

实例规格族。

ecs.r7t
NetworkTypesarray

支持的网络类型列表。

supportedNetworkCategorystring

支持的网络类型。可能值：

  • VPC：专有网络 VPC。
  • Classic：经典网络。
vpc
AvailableResourceCreationarray

允许创建的资源类型。可能值：

  • VSwitch：交换机。
  • IoOptimized：I/O 优化实例。
  • Instance：实例。
  • DedicatedHost：专有宿主机。
  • Disk：云盘。
ResourceTypesstring

允许创建的资源类型。可能值：

  • VSwitch：交换机。
  • IoOptimized：I/O 优化实例。
  • Instance：实例。
  • DedicatedHost：专有宿主机。
  • Disk：云盘。
DedicatedHost
DedicatedHostGenerationsarray

支持的专有宿主机代数列表。

DedicatedHostGenerationstring

支持的专有宿主机代数列表。

ddh-6
AvailableInstanceTypesarray

当前可用区下可创建的所有规格列表。

InstanceTypesstring

当前可用区下可创建的所有规格列表。

ecs.g6.xlarge
AvailableDiskCategoriesarray

允许创建的云盘种类集合。可能值：

  • cloud：普通云盘。
  • cloud_ssd：SSD 云盘。
  • cloud_efficiency：高效云盘。
  • cloud_essd：ESSD 云盘。
DiskCategoriesstring

允许创建的云盘种类集合。可能值：

  • cloud：普通云盘。
  • cloud_ssd：SSD 云盘。
  • cloud_efficiency：高效云盘。
  • cloud_essd：ESSD 云盘。
cloud
AvailableDedicatedHostTypesarray

支持的专有宿主机规格列表。

DedicatedHostTypestring

支持的专有宿主机规格列表。

ddh.g6
AvailableVolumeCategoriesarray

支持的共享存储类型。

VolumeCategoriesstring

支持的共享存储类型。

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错误码错误信息描述
400InvalidSpotStrategyThe specified SpotStrategy is not valid.指定的 SpotStrategy 参数无效。
404InvalidRegionId.NotFoundThe specified RegionId does not exist.指定的地域 ID 不存在。
404InvalidRegion.NotFoundThe specified parameter RegionId is not valid.RegionId 参数不合法。
404InvalidInstanceChargeType.NotFoundThe InstanceChargeType does not exist in our records.指定的实例计费方式不存在。
404InvalidAcceptLanguage.NotFoundOnly Chinese (zh-CN), English (en-US), and Japanese (ja) are allowed.您选择的语言类型无效，现在只支持中文、英语和日语。

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

变更历史

变更时间变更内容概要操作
2025-02-27OpenAPI 描述信息更新、OpenAPI 错误码发生变更查看变更详情
上一篇：DescribeRegions - 查询地域列表下一篇：DescribeAvailableResource - 查询可用区的资源库存