文档

DescribeZones - 查询阿里云可用区

更新时间:

调用DescribeZones查询一个阿里云地域下的可用区。

接口说明

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

根据汉语、英语和日语筛选返回结果。更多信息,请参见 RFC7231 。取值范围:

  • zh-CN
  • en-US
  • ja

默认值:zh-CN

zh-CN

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Zonesobject []

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

ZoneIdstring

可用区 ID。

cn-hangzhou-g
ZoneTypestring

可用区类型。可能值:

  • AvailabilityZone:公共云可用区。
  • CloudBoxZone:云盒可用区。
AvailabilityZone
LocalNamestring

可用区本地语言名。

华东 1 可用区 G
AvailableResourcesobject []

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

IoOptimizedboolean

是否为 I/O 优化实例。

true
SystemDiskCategoriesarray

系统盘类型列表。

string

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

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

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

string

实例规格族代数。

ecs-6
DataDiskCategoriesarray

允许创建的数据盘类型。

string

数据盘类型。可能值:

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

实例规格列表。

string

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

ecs.g5.large
InstanceTypeFamiliesarray

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

string

实例规格族。

ecs.r7t
NetworkTypesarray

支持的网络类型列表。

string

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

  • VPC:专有网络 VPC
  • Classic:经典网络
vpc
AvailableResourceCreationarray

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

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

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

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

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

string

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

ddh-6
AvailableInstanceTypesarray

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

string

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

ecs.g6.xlarge
AvailableDiskCategoriesarray

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

  • cloud:普通云盘
  • cloud_ssd:SSD 云盘
  • cloud_efficiency:高效云盘
  • cloud_essd:ESSD 云盘
string

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

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

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

string

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

ddh.g6
AvailableVolumeCategoriesarray

支持的共享存储类型。

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错误码错误信息描述
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.您选择的语言类型无效,现在只支持中文、英语和日语。

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

  • 本页导读 (1)
文档反馈