All Products
Search
Document Center

Virtual Private Cloud:DescribeZones

Last Updated:Oct 26, 2026

Queries a list of zones in a specified region.

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 retrieve region IDs.

cn-hangzhou

ZoneType

string

No

The type of the zone to query. Default value: AvailabilityZone, which indicates a regular cloud zone.

AvailabilityZone

AcceptLanguage

string

No

The language in which the LocalName parameter is returned. Valid values:

  • zh-cn: Chinese.

  • en-us: English.

  • ja: Japanese.

zh-cn

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

6FEA0CF3-D3B9-43E5-A304-D217037876A8

Zones

object

Zone

array<object>

The zones.

object

ZoneId

string

The zone ID.

cn-hangzhou-b

LocalName

string

The zone name.

China East 1 Zone B

ZoneType

string

The type of the queried zone. Default value: AvailabilityZone, which indicates a regular cloud zone.

AvailabilityZone

Examples

Success response

JSON format

{
  "RequestId": "6FEA0CF3-D3B9-43E5-A304-D217037876A8",
  "Zones": {
    "Zone": [
      {
        "ZoneId": "cn-hangzhou-b",
        "LocalName": "华东 1 可用区 B",
        "ZoneType": "AvailabilityZone"
      }
    ]
  }
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidRegionId.NotFound The RegionId provided does not exist in our records. The specified RegionId does not exist. Check whether the service is available in the region.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.