All Products
Search
Document Center

Elastic Compute Service:DescribeZones

Last Updated:Oct 19, 2026

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

Operation description

DescribeZones queries only the list of zones provided by Alibaba Cloud and returns limited inventory information. To query the available instance types and disk categories 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 region ID of the zone. You can call the DescribeRegions operation to query the latest list of Alibaba Cloud regions.

cn-hangzhou

Verbose

boolean

No

Specifies whether to display detailed information. Valid values:

  • true: Displays detailed information.

  • false: Does not display detailed information.

Default value: true.

false

InstanceChargeType

string

No

The billing method of the resources supported in the 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 is set to PostPaid. For more information, see Spot instances. Valid values:

  • NoSpot: regular pay-as-you-go instance.

  • SpotWithPriceLimit: spot instance with a maximum price.

  • SpotAsPriceGo: spot instance whose price is automatically offered by the system, up to the pay-as-you-go price.

Default value: NoSpot.

NoSpot

AcceptLanguage

string

No

The language used to filter the returned results, such as Chinese, English, or Japanese. 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 zone ID.

cn-hangzhou-g

ZoneType

string

The zone type. Valid values:

  • AvailabilityZone: public cloud zone.

AvailabilityZone

LocalName

string

The local name of the zone.

China East 1 Zone G

AvailableResources

object

ResourcesInfo

array<object>

The array of specific resources available for creation.

array<object>

IoOptimized

boolean

Indicates whether the instance is I/O optimized.

true

SystemDiskCategories

object

supportedSystemDiskCategory

array

The list of supported system disk categories.

string

The allowed system disk categories. Valid values:

  • cloud: basic disk.

  • cloud_efficiency: ultra disk.

  • cloud_ssd: standard SSD.

  • cloud_essd: enterprise SSD.

cloud_essd

InstanceGenerations

object

supportedInstanceGeneration

array

The list of supported instance family generations.

string

The instance family generation.

ecs-6

DataDiskCategories

object

supportedDataDiskCategory

array

The allowed data disk categories.

string

The data disk category. Valid values:

  • cloud: basic disk.

  • cloud_efficiency: ultra disk.

  • cloud_ssd: standard SSD.

  • cloud_essd: enterprise SSD.

  • ephemeral_ssd: local SSD.

cloud_essd

InstanceTypes

object

supportedInstanceType

array

The list of supported instance types.

string

The list of instance types that can be created in the current zone, network type (NetworkTypes), and I/O optimization (IoOptimized).

ecs.g5.large

InstanceTypeFamilies

object

supportedInstanceTypeFamily

array

The list of allowed instance families.

string

The instance family.

ecs.r7t

NetworkTypes

object

supportedNetworkCategory

array

The list of supported network types.

string

The supported network type. Valid values:

  • VPC: virtual private cloud (VPC).

  • Classic: classic network. The classic network feature is retired. For more information, see Retirement notice.

vpc

AvailableResourceCreation

object

ResourceTypes

array

The list of allowed resource types.

string

The allowed resource type. Valid values:

  • VSwitch: vSwitch.

  • IoOptimized: I/O optimized instance.

  • Instance: instance.

  • DedicatedHost: dedicated host.

  • Disk: disk.

DedicatedHost

DedicatedHostGenerations

object

DedicatedHostGeneration

array

The list of supported dedicated host generations.

string

The supported dedicated host generation.

ddh-6

AvailableInstanceTypes

object

InstanceTypes

array

The list of all instance types that can be created in the current zone.

string

The instance type that can be created in the current zone.

ecs.g6.xlarge

AvailableDiskCategories

object

DiskCategories

array

The collection of allowed disk categories.

string

The allowed disk category. Valid values:

  • cloud: basic disk.

  • cloud_ssd: standard SSD.

  • cloud_efficiency: ultra disk.

  • cloud_essd: enterprise SSD.

cloud

AvailableDedicatedHostTypes

object

DedicatedHostType

array

The list of supported dedicated host types.

string

The supported dedicated host type.

ddh.g6

AvailableVolumeCategories

object

VolumeCategories

array

The list of supported shared storage types.

string

The supported shared storage type.

san_efficiency

Examples

Success response

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Zones": {
    "Zone": [
      {
        "ZoneId": "cn-hangzhou-g",
        "ZoneType": "AvailabilityZone",
        "LocalName": "China East 1 Zone 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.