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

接口说明

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

调试

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

请求参数

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

返回数据

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

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeZones
&RegionId=cn-hangzhou
&InstanceChargeType=PostPaid
&SpotStrategy=NoSpot
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeZonesResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <Zones>
        <Zone>
            <DedicatedHostGenerations>
                <DedicatedHostGeneration>ddh-5</DedicatedHostGeneration>
                <DedicatedHostGeneration>ddh-6</DedicatedHostGeneration>
            </DedicatedHostGenerations>
            <AvailableInstanceTypes>
                <InstanceTypes>ecs.g6.xlarge</InstanceTypes>
                <InstanceTypes>ecs.g7t.4xlarge</InstanceTypes>
            </AvailableInstanceTypes>
            <ZoneId>cn-hangzhou-g</ZoneId>
            <AvailableDedicatedHostTypes>
                <DedicatedHostType>ddh.g6</DedicatedHostType>
                <DedicatedHostType>ddh.r6</DedicatedHostType>
            </AvailableDedicatedHostTypes>
            <AvailableResources>
                <ResourcesInfo>
                    <InstanceGenerations>
                        <supportedInstanceGeneration>ecs-5</supportedInstanceGeneration>
                        <supportedInstanceGeneration>ecs-6</supportedInstanceGeneration>
                    </InstanceGenerations>
                    <NetworkTypes>
                        <supportedNetworkCategory>vpc</supportedNetworkCategory>
                    </NetworkTypes>
                    <IoOptimized>true</IoOptimized>
                    <SystemDiskCategories>
                        <supportedSystemDiskCategory>cloud_efficiency</supportedSystemDiskCategory>
                        <supportedSystemDiskCategory>cloud_essd</supportedSystemDiskCategory>
                    </SystemDiskCategories>
                    <InstanceTypes>
                        <supportedInstanceType>ecs.c6.xlarge</supportedInstanceType>
                        <supportedInstanceType>ecs.g5.large</supportedInstanceType>
                    </InstanceTypes>
                    <InstanceTypeFamilies>
                        <supportedInstanceTypeFamily>ecs.r7t</supportedInstanceTypeFamily>
                        <supportedInstanceTypeFamily>ecs.r7</supportedInstanceTypeFamily>
                    </InstanceTypeFamilies>
                    <DataDiskCategories>
                        <supportedDataDiskCategory>cloud_efficiency</supportedDataDiskCategory>
                        <supportedDataDiskCategory>cloud_essd</supportedDataDiskCategory>
                    </DataDiskCategories>
                </ResourcesInfo>
            </AvailableResources>
            <AvailableDiskCategories>
                <DiskCategories>cloud_efficiency</DiskCategories>
                <DiskCategories>cloud_essd</DiskCategories>
            </AvailableDiskCategories>
            <ZoneType>AvailabilityZone</ZoneType>
            <LocalName>华东 1 可用区 G</LocalName>
            <AvailableResourceCreation>
                <ResourceTypes>VSwitch</ResourceTypes>
                <ResourceTypes>IoOptimized</ResourceTypes>
                <ResourceTypes>Instance</ResourceTypes>
                <ResourceTypes>DedicatedHost</ResourceTypes>
                <ResourceTypes>Disk</ResourceTypes>
            </AvailableResourceCreation>
            <AvailableVolumeCategories>
                <VolumeCategories>san_efficiency</VolumeCategories>
            </AvailableVolumeCategories>
        </Zone>
    </Zones>
</DescribeZonesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Zones" : {
    "Zone" : [ {
      "DedicatedHostGenerations" : {
        "DedicatedHostGeneration" : [ "ddh-5", "ddh-6" ]
      },
      "AvailableInstanceTypes" : {
        "InstanceTypes" : [ "ecs.g6.xlarge", "ecs.g7t.4xlarge" ]
      },
      "ZoneId" : "cn-hangzhou-g",
      "AvailableDedicatedHostTypes" : {
        "DedicatedHostType" : [ "ddh.g6", "ddh.r6" ]
      },
      "AvailableResources" : {
        "ResourcesInfo" : [ {
          "InstanceGenerations" : {
            "supportedInstanceGeneration" : [ "ecs-5", "ecs-6" ]
          },
          "NetworkTypes" : {
            "supportedNetworkCategory" : [ "vpc" ]
          },
          "IoOptimized" : true,
          "SystemDiskCategories" : {
            "supportedSystemDiskCategory" : [ "cloud_efficiency", "cloud_essd" ]
          },
          "InstanceTypes" : {
            "supportedInstanceType" : [ "ecs.c6.xlarge", "ecs.g5.large" ]
          },
          "InstanceTypeFamilies" : {
            "supportedInstanceTypeFamily" : [ "ecs.r7t", "ecs.r7" ]
          },
          "DataDiskCategories" : {
            "supportedDataDiskCategory" : [ "cloud_efficiency", "cloud_essd" ]
          }
        } ]
      },
      "AvailableDiskCategories" : {
        "DiskCategories" : [ "cloud_efficiency", "cloud_essd" ]
      },
      "ZoneType" : "AvailabilityZone",
      "LocalName" : "华东 1 可用区 G",
      "AvailableResourceCreation" : {
        "ResourceTypes" : [ "VSwitch", "IoOptimized", "Instance", "DedicatedHost", "Disk" ]
      },
      "AvailableVolumeCategories" : {
        "VolumeCategories" : [ "san_efficiency" ]
      }
    } ]
  }
}

错误码

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

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