文档首页/ 弹性负载均衡 ELB/ API参考（安卡拉区域）/ API（V3）/ 可用区/ 查询可用区列表
更新时间：2025-02-24 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询可用区列表

功能介绍

返回租户创建LB时可使用的可用区集合列表情况。

  • 默认情况下，会返回一个可用区集合。

    在（如创建LB）设置可用区时，填写的可用区必须包含在可用区集合中、为这个可用区集合的子集。

  • 如果传入了loadbalancer_id，则返回该负载均衡器所在集群的可用区集合

  • 特殊场景下，部分客户要求负载均衡只能创建在指定可用区集合中，此时会返回客户定制的可用区集合。

    返回可用区集合可能为一个也可能为多个，比如列表有两个可用区集合[az1,az2],[az2,az3]。

    在创建负载均衡器时，可以选择创建在多个可用区，但所选的多个可用区必须同属于其中一个可用区集合，

    如可以选az2和az3，但不能选择az1和az3。你可以选择多个可用区，只要这些可用区在一个子集中

调用方法

请参见如何调用API。

URI

GET /v3/{project_id}/elb/availability-zones

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：项目ID。
表2 Query参数

参数

是否必选

参数类型

描述

public_border_group

否

String

参数解释：网络公共边界组。

loadbalancer_id

否

String

参数解释：负载均衡器ID。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：IAM鉴权Token。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

request_id

String

参数解释：请求ID。

注：自动生成。

availability_zones

Array<Array<AvailabilityZone>>

参数解释：返回创建LB时可使用的可用区集合列表。如：[[az1,az2],[az2,az3]] ,则在创建LB时，只能从其中的一个子列表中选择一个或多个可用区，不能跨列表选择。在上述例子中，不能选择az1和az3。
表5 AvailabilityZone

参数

参数类型

描述

code

String

参数解释：可用区唯一编码。

state

String

参数解释：可用区状态。

取值范围：ACTIVE。

protocol

Array of strings

参数解释：未售罄的LB规格类别。

取值范围：L4 表示网络型LB未售罄；L7 表示应用型LB未售罄。

public_border_group

String

参数解释：网络公共边界组，如：center

category

Integer

参数解释：范围编码。

取值范围：0表示center，21表示homezone。

请求示例

查询负载均衡可用区列表

GET https://{ELB_Endpoint}/v3/060576782980d5762f9ec014dd2f1148/elb/availability-zones

响应示例

状态码：200

操作正常返回。

{
  "availability_zones" : [ [ {
    "state" : "ACTIVE",
    "code" : "az1",
    "protocol" : [ "L4", "L7" ],
    "public_border_group" : "center",
    "category" : 0
  }, {
    "state" : "ACTIVE",
    "code" : "az2",
    "protocol" : [ "L4" ],
    "public_border_group" : "center",
    "category" : 0
  }, {
    "state" : "ACTIVE",
    "code" : "az3",
    "protocol" : [ "L7" ],
    "public_border_group" : "center",
    "category" : 0
  }, {
    "state" : "ACTIVE",
    "code" : "homezone.az0",
    "protocol" : [ "L4" ],
    "public_border_group" : "homezone.azg",
    "category" : 21
  } ] ],
  "request_id" : "0d799435-259e-459f-b2bc-0beee06f6a77"
}

状态码

状态码

描述

200

操作正常返回。

错误码

请参见错误码。

父主题： 可用区