DescribeZones--负载均衡-火山引擎

文档中心

立即注册

导航

负载均衡

DescribeZones

最近更新时间：2025.08.08 15:31:59首次发布时间：2022.09.26 14:17:01

请求说明

API 名称：DescribeZones
API 描述：查询 ALB 在当前地域下可部署的可用区列表。

使用限制

节流限制：每秒最多提交 40 个 API 请求。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

URI 参数

在使用该部分 API 提交请求时必须包含以下 URI 参数。

除了 URI 参数，该 API 请求还需要包含签名参数。关于更多签名参数的信息，参见公共请求参数。

名称	类型	是否必选	格式	说明
Action	string	是	[a-zA-Z]+	API 名称，如 DescribeZones 。
Version	string	是	YYYY-MM-DD	API 版本信息。该参数的取值是 2020-04-01 。
X-Expires	int	否	900	表示签名的有效时间，单位是秒，默认值是900。

返回参数

参数	类型	参数说明	示例值
RequestId	String	请求ID。	20210811152539010225146063030****
Zones	Array	ALB 在当前地域下可部署的可用区列表。具体参见下表 Zones。	-

Zones

参数	类型	参数说明	示例值
ZoneId	String	可用区。	cn-beijing-a

示例

请求示例

GET /?Action=DescribeZones&Version=2020-04-01 HTTP/1.1
Host: alb.cn-beijing.volcengineapi.com
Region: cn-beijing
ServiceName: alb

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202507111053454B874C715A063AC6****",
        "Action": "DescribeZones",
        "Version": "2020-04-01",
        "Service": "alb",
        "Region": "cn-beijing"
    },
    "Result": {
        "RequestId": "202507111053454B874C715A063AC6****",
        "Zones": [
            {
                "ZoneId": "cn-beijing-a"
            },
            {
                "ZoneId": "cn-beijing-b"
            },
            {
                "ZoneId": "cn-beijing-c"
            },
            {
                "ZoneId": "cn-beijing-d"
            },
            {
                "ZoneId": "cn-beijing-e"
            }
        ]
    }
}

错误码

如果响应正文包含 Error 字段，则表示 API 请求失败。关于更多错误码的信息，参见错误码。