Queries zones in a specified region.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeZones

The operation that you want to perform. Set the value to DescribeZones.

RegionId String Yes cn-hangzhou

The ID of the region where zones are queried. You can call the DescribeRegions operation to query the most recent region list.

ZoneType String No AvailabilityZone

The type of the zones to be queried. Default value: AvailabilityZone. This value indicates Alibaba Cloud zones.

AcceptLanguage String No zh-cn

The language used in the LocalName parameter to display the zone names. Valid values:

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

Response parameters

Parameter Type Example Description
Zones Array of Zone

The zones that are returned.

Zone
LocalName String Hangzhou Zone B

The name of the zone.

ZoneId String cn-hangzhou-b

The ID of the zone.

ZoneType String AvailabilityZone

The type of the zones to be queried. Default value: AvailabilityZone. This value indicates Alibaba Cloud zones.

RequestId String 6FEA0CF3-D3B9-43E5-A304-D217037876A8

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeZones
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

<DescribeZonesResponse>
  <RequestId>6FEA0CF3-D3B9-43E5-A304-D217037876A8</RequestId>
  <Zones>
        <Zone>
              <ZoneId>cn-hangzhou-b</ZoneId>
              <ZoneType>AvailabilityZone</ZoneType>
              <LocalName>Hangzhou Zone B</LocalName>
        </Zone>
  </Zones>
</DescribeZonesResponse>

JSON format

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

Error codes

For a list of error codes, visit the API Error Center.