All Products
Search
Document Center

Virtual Private Cloud:DescribeZones

Last Updated:Aug 27, 2026

Queries zones in a 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 query the most recent region list.

cn-hangzhou

ZoneType

string

No

The zone type. Default value: AvailabilityZone.

AvailabilityZone

AcceptLanguage

string

No

The language used in the LocalName parameter. 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 zone list.

object

ZoneId

string

The zone ID.

cn-hangzhou-b

LocalName

string

The zone name.

华东 1 可用区 B

ZoneType

string

The zone type. Default value: AvailabilityZone.

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.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.