All Products
Search
Document Center

Virtual Private Cloud:DescribeZones

Last Updated:Nov 13, 2024

Queries zones in a region.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

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
Zonesarray<object>

The zone list.

Zoneobject
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.

Change history

Change timeSummary of changesOperation
2024-03-12API Description Update. The Error code has changedView Change Details