更新时间:2024-04-08 GMT+08:00

查询可用区列表

功能介绍

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

  • 默认情况下,会返回一个可用区集合。 在(如创建LB)设置可用区时,填写的可用区必须包含在可用区集合中、为这个可用区集合的子集。

  • 特殊场景下,部分客户要求负载均衡只能创建在指定可用区集合中,此时会返回客户定制的可用区集合。 返回可用区集合可能为一个也可能为多个,比如列表有两个可用区集合[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

AZ组。

请求参数

表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

操作正常返回。

错误码

请参见错误码