All Products
Search
Document Center

Virtual Private Cloud:DescribeZones

Last Updated:Mar 04, 2024

Queries zones in a region.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The region ID of the zone. You can call the DescribeRegions operation to query the most recent region list.

cn-hangzhou
ZoneTypestringNo

The zone type. Default value: AvailabilityZone.

AvailabilityZone
AcceptLanguagestringNo

The language used in the LocalName parameter. Valid values:

  • zh-cn: Chinese
  • en-us: English
  • ja: Japanese
zh-cn

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The request ID.

6FEA0CF3-D3B9-43E5-A304-D217037876A8
Zonesobject []

The zone list.

ZoneIdstring

The zone ID.

cn-hangzhou-b
LocalNamestring

The zone name.

Hangzhou Zone B
ZoneTypestring

The zone type. Default value: AvailabilityZone.

AvailabilityZone

Examples

Sample success responses

JSONformat

{
  "RequestId": "6FEA0CF3-D3B9-43E5-A304-D217037876A8",
  "Zones": {
    "Zone": [
      {
        "ZoneId": "cn-hangzhou-b",
        "LocalName": "Hangzhou Zone B",
        "ZoneType": "AvailabilityZone"
      }
    ]
  }
}

Error codes

HTTP status codeError codeError messageDescription
404InvalidRegionId.NotFoundThe RegionId provided does not exist in our records.The RegionId parameter is set to an invalid value. Specify a valid value and try again.

For a list of error codes, visit the Service error codes.