You need to enable JavaScript to run this app.
Elastic Compute Service

Elastic Compute Service

Copy page
Download PDF
Regions and availability zones
DescribeZones - Queries availability zones
Copy page
Download PDF
DescribeZones - Queries availability zones
Call the DescribeZones operation to query the availability zones in a region.​
Debugging​
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
​
Request parameters​
Only the request parameters specific to this operation and some common parameters are listed below. For more information, refer to Common parameters.​
Action string required Sample value: DescribeZones​
The operation that you want to perform. Value: DescribeZones.​
​
Version string required Sample value: 2020-04-01​
The version of the API. Valid value: 2020-04-01.​
​
ZoneIds.N string[] Optional Sample value: ZoneIds.1=cn-beijing-a​
The availability zone ID. Up to 20 availability zone IDs are supported.​
  • Argument - N: specifies the serial number of the availability zone ID.​
  • Separate multiple availability zone IDs with &.​
​
​
​
Response parameters​
Only the response parameters specific to this operation are listed below. For more information, refer to the response structure.​
Zones object[] Sample value: --​
The availability zone information.​
ZoneId string Sample value: cn-beijing-a​
The availability zone ID.​
​
​
​
​
Sample request​
​
GET /?Action=DescribeZones&Version=2020-04-01 HTTP/1.1​
Host: ecs.cn-beijing.volcengineapi.com​
Region: cn-beijing​
Service: ecs​
​
Sample response​
​
{​
"ResponseMetadata": {​
"RequestId": "202106111445100102252431000052****",​
"Action": "DescribeZones",​
"Version": "2020-04-01",​
"Service": "ecs",​
"Region": "cn-beijing"​
},​
"Result": {​
"Zones": [​
{​
"ZoneId": "cn-beijing-a"​
},​
{​
"ZoneId": "cn-beijing-b"​
}​
]​
}​
}​
​
Error codes​
The table below lists the business-related error codes of the operation. For more information, refer to Common error codes.​
​
Status code​
Error code​
Error message​
Description​
400​
InvalidArgument​
The specified argument is invalid.​
The specified parameter is invalid.​
400​
LimitExceeded.MaximumZoneIds​
You've reached the limit on the number of ZoneIds that you can set.​
The number of specified zone IDs exceeds the upper limit.​
404​
InvalidZone.NotFound​
The specified zone does not exist.​
The specified availability zone does not exist.​
429​
FlowLimitExceeded​
You've reached the limit on request rate of resources.​
Resource request rate exceeds the limit.​
500​
InternalError​
An internal error has occurred.​
An internal error occurred. Try again. If multiple attempts fail, submit a ticket.​
​
​
Last updated: 2026.06.18 17:48:24