Use DescribeZones to query zones and available resources - Elastic Compute Service - Alibaba Cloud - Elastic Compute Service

Queries the list of active zones based on parameters such as region ID and billing method.

Operation description

DescribeZones only queries the list of zones provided by Alibaba Cloud and returns limited inventory information. To query the instance types and disk categories available for purchase in a specific zone, use DescribeAvailableResource.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The ID of the region where the zones are located. You can call DescribeRegions to query the most recent region list.	cn-hangzhou
Verbose	boolean	No	Specifies whether to display detailed information. true: Display detailed information. false: Do not display detailed information. Default value: true.	false
InstanceChargeType	string	No	The billing method supported by resources in the active zone. For more information, see Billing overview. Valid values: PrePaid: subscription. PostPaid: pay-as-you-go. Default value: PostPaid.	PostPaid
SpotStrategy	string	No	The bidding policy for pay-as-you-go instances. You can specify this parameter when `InstanceChargeType=PostPaid`. For more information, see Spot instances. Valid values: NoSpot: regular pay-as-you-go instance. SpotWithPriceLimit: spot instance with a maximum price limit. SpotAsPriceGo: spot instance priced at the market price with the pay-as-you-go price as the upper limit. Default value: NoSpot.	NoSpot
AcceptLanguage	string	No	The natural language that is used to filter response results. For more information, see RFC 7231. Valid values: zh-CN: simplified Chinese. zh-TW: traditional Chinese. en-US: English. ja: Japanese. fr: French. de: German. ko: Korean. Default value: zh-CN. Valid values: de : German. en-US : English. ko : Korean. zh-TW : Traditional Chinese. ja : Japanese. fr : French. zh-CN : Simplified Chinese.	zh-CN

Response elements

Element	Type	Description	Example
	object
RequestId	string	The request ID.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Zones	object
Zone	array<object>	The collection of zones and the supported resource information in each zone.
	array<object>
ZoneId	string	The ID of the zone.	cn-hangzhou-g
ZoneType	string	The type of the zone. Valid values: AvailabilityZone: zone for the Alibaba Cloud public cloud CloudBoxZone: zone for CloudBox	AvailabilityZone
LocalName	string	The name of the zone in the local language.	华东 1 可用区 G
AvailableResources	object
ResourcesInfo	array<object>	Details about the resources that can be created in the zone.
	array<object>
IoOptimized	boolean	Indicates whether the instance is I/O optimized.	true
SystemDiskCategories	object
supportedSystemDiskCategory	array	The categories of system disks that can be created.
	string	The category of system disks that can be created. Valid values: cloud: basic disk cloud_efficiency: ultra disk cloud_ssd: standard SSD cloud_essd: Enterprise SSD (ESSD)	cloud_essd
InstanceGenerations	object
supportedInstanceGeneration	array	The supported generations of instance families.
	string	The supported generation of instance families.	ecs-6
DataDiskCategories	object
supportedDataDiskCategory	array	The categories of data disks that can be created.
	string	The category of data disks that can be created. Valid values: cloud: basic disk cloud_efficiency: ultra disk cloud_ssd: standard SSD cloud_essd: ESSD ephemeral_ssd: local SSD	cloud_essd
InstanceTypes	object
supportedInstanceType	array	The supported instance types.
	string	The instance type of I/O optimized instances of different network types that can be created in the zone.	ecs.g5.large
InstanceTypeFamilies	object
supportedInstanceTypeFamily	array	The supported instance families.
	string	The supported instance family.	ecs.r7t
NetworkTypes	object
supportedNetworkCategory	array	The supported network types.
	string	The supported network type. Valid values: VPC: Virtual Private Cloud (VPC) Classic: classic network	vpc
AvailableResourceCreation	object
ResourceTypes	array	The types of resources that can be created. Valid values: VSwitch: vSwitch IoOptimized: I/O optimized instance Instance: instance DedicatedHost: dedicated host disk: cloud disk
	string	The type of resources that can be created. Valid values: VSwitch: vSwitch IoOptimized: I/O optimized instance Instance: instance DedicatedHost: dedicated host disk: cloud disk	DedicatedHost
DedicatedHostGenerations	object
DedicatedHostGeneration	array	The supported generations of dedicated hosts.
	string	The supported generation of dedicated hosts.	ddh-6
AvailableInstanceTypes	object
InstanceTypes	array	The supported instance types.
	string	The supported instance type.	ecs.g6.xlarge
AvailableDiskCategories	object
DiskCategories	array	The categories of cloud disks that can be created. Valid values: cloud: basic disk cloud_ssd: standard SSD cloud_efficiency: ultra disk cloud_essd: ESSD
	string	The category of cloud disks that can be created. Valid values: cloud: basic disk. cloud_ssd: standard SSD cloud_efficiency: ultra disk cloud_essd: ESSD	cloud
AvailableDedicatedHostTypes	object
DedicatedHostType	array	The supported dedicated host types.
	string	The supported dedicated host type.	ddh.g6
AvailableVolumeCategories	object
VolumeCategories	array	The supported Shared Block Storage device categories.
	string	The supported Shared Block Storage device category.	san_efficiency

Examples

Success response

JSON format

{
  "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"
          ]
        }
      }
    ]
  }
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidSpotStrategy	The specified SpotStrategy is not valid.	The specified SpotStrategy parameter is invalid.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	The specified region ID does not exist.
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.	Your selected language is invalid. Only Chinese, English, and Japanese are supported.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.