DescribeZones - Virtual Private Cloud - Alibaba Cloud Documentation Center

Queries zones in a specified 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.

debugging

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The ID of the region where zones are queried. You can call the DescribeRegions operation to query the most recent region list.	cn-hangzhou
ZoneType	string	No	The type of the zones to be queried. Default value: AvailabilityZone. This value indicates Alibaba Cloud zones.	AvailabilityZone
AcceptLanguage	string	No	The language used in the LocalName parameter to display the zone names. Valid values: zh-cn: Chinese en-us: English ja: Japanese	zh-cn

Response parameters

Parameter	Type	Description	Example
	object
RequestId	string	The ID of the request.	6FEA0CF3-D3B9-43E5-A304-D217037876A8
Zones	object []	The zones that are returned.
ZoneId	string	The ID of the zone.	cn-hangzhou-b
LocalName	string	The name of the zone.
ZoneType	string	The type of the zones to be queried. Default value: AvailabilityZone. This value indicates Alibaba Cloud zones.	AvailabilityZone

Examples

Sample success responses

JSONformat

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

Error codes

HTTP status code	Error code	Error message	Description
404	InvalidRegionId.NotFound	The 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.