You need to enable JavaScript to run this app.
文档中心
云服务器

云服务器

请输入
  • 文档首页
    • 云服务器云服务器ECSAPI参考地域DescribeZones - 查询可用区列表
复制全文
下载 pdf
我的收藏
地域
DescribeZones - 查询可用区列表
复制全文
下载 pdf
我的收藏
DescribeZones - 查询可用区列表
调用 DescribeZones 查询一个地域下的可用区信息。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值：DescribeZones​
要执行的操作，取值：DescribeZones。​
​
Version string 必选 示例值：2020-04-01​
API的版本，取值：2020-04-01。​
​
ZoneIds.N string[] 可选 示例值：ZoneIds.1=cn-beijing-a​
可用区ID，最多支持20个。​
  • 参数 - N：表示可用区ID的序号。​
  • 多个可用区ID之间用&分隔。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
Zones object[] 示例值：--​
可用区信息。​
ZoneId string 示例值：cn-beijing-a​
可用区ID。​
​
​
​
​
请求示例​
​
GET /?Action=DescribeZones&Version=2020-04-01 HTTP/1.1​
Host: ecs.cn-beijing.volcengineapi.com​
Region: cn-beijing​
Service: ecs​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "202106111445100102252431000052****",​
"Action": "DescribeZones",​
"Version": "2020-04-01",​
"Service": "ecs",​
"Region": "cn-beijing"​
},​
"Result": {​
"Zones": [​
{​
"ZoneId": "cn-beijing-a"​
},​
{​
"ZoneId": "cn-beijing-b"​
}​
]​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidArgument​
The specified argument is invalid.​
指定的参数不合法。​
400​
LimitExceeded.MaximumZoneIds​
You've reached the limit on the number of ZoneIds that you can set.​
指定的ZoneIds超过最大限制。​
404​
InvalidZone.NotFound​
The specified zone does not exist.​
指定的可用区不存在。​
429​
FlowLimitExceeded​
You've reach the limit on request rate of resources.​
您已超过资源请求限速。​
500​
InternalError​
An internal error has occurred.​
内部错误，请重试。如果多次尝试失败，请提交工单。​
​
​
最近更新时间：2025.09.04 16:59:40
这个页面对您有帮助吗？
有用
有用
无用
无用