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

查询规格列表

功能介绍

查询当前region下可用的负载均衡规格列表。

接口约束

  • 分页查询使用的参数为marker、limit、page_reverse。

  • marker和page_reverse只有和limit一起使用时才会生效，单独使用无效。

调用方法

请参见如何调用API。

URI

GET /v3/{project_id}/elb/flavors

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

参数

是否必选

参数类型

描述

marker

否

String

参数解释：上一页最后一条记录的ID。

约束限制：

  • 必须与limit一起使用。

  • 不指定时表示查询第一页。

  • 该字段不允许为空或无效的ID。

limit

否

Integer

参数解释：每页返回的个数。

取值范围：0-2000

默认取值：2000

page_reverse

否

Boolean

参数解释：是否反向查询。

约束限制：

  • 必须与limit一起使用。

  • 当page_reverse=true时，若要查询上一页，marker取值为当前页返回值的previous_marker。

取值范围：

  • true：查询上一页。

  • false：查询下一页，默认。

id

否

Array of strings

参数解释：规格ID。

支持多值查询，查询条件格式：id=xxx&id=xxx。

name

否

Array of strings

参数解释：规格名称。

支持多值查询，查询条件格式：name=xxx&name=xxx。

type

否

Array of strings

参数解释：规格类别。

取值范围：

  • L4和L7 表示四层网络型和七层应用型flavor。

  • L4_elastic和L7_elastic 表示弹性扩缩容实例的下限规格。

  • L4_elastic_max、L7_elastic_max 表示弹性扩缩容实例的上限规格。

支持多值查询，查询条件格式：type=xxx&type=xxx。

shared

否

Boolean

参数解释：是否查询公共规格。

取值范围：true表示公共规格，所有租户可见。false表示私有规格，为当前租户所有。

public_border_group

否

Array of strings

站点pbg。

支持多值查询，查询条件格式：public_border_group=xxx&public_border_group=xxx。

category

否

Array of integers

站点category。

支持多值查询，查询条件格式：category=xxx&category=xxx。

list_all

否

Boolean

设置list_all=true时，返回当前租户所有的弹性上限规格（l4_elastic_max、l7_elastic_max）。否则只返回该租户弹性上限规格中最大的规格（l4类型优先比较cps指标，然后是带宽；l7类型优先比较https cps指标然后是qps指标）。

flavor_sold_out

否

Boolean

参数解释：

是否售罄。

取值范围：

  • true：已售罄，将无法购买该规格的LB。

  • false：未售罄，可购买该规格的LB。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：IAM鉴权Token。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

flavors

Array of Flavor objects

参数解释：规格列表。

page_info

PageInfo object

参数解释：规格分页信息。

request_id

String

参数解释：请求ID。

注：自动生成 。
表5 Flavor

参数

参数类型

描述

id

String

参数解释：规格ID。

info

FlavorInfo object

参数解释：规格相关的指标。

name

String

参数解释：规格名称。

取值范围：

网络型有如下规格：

  • L4_flavor.elb.s1.small: 小型 I

  • L4_flavor.elb.s2.small: 小型 II

  • L4_flavor.elb.s1.medium: 中型 I

  • L4_flavor.elb.s2.medium: 中型 II

  • L4_flavor.elb.s1.large: 大型 I

  • L4_flavor.elb.s2.large: 大型 II

  • L4_flavor.elb.pro.max: 四层弹性规格

应用型有如下规格：

  • L7_flavor.elb.s1.small: 小型 I

  • L7_flavor.elb.s2.small: 小型 II

  • L7_flavor.elb.s1.medium: 中型 I

  • L7_flavor.elb.s2.medium: 中型 II

  • L7_flavor.elb.s1.large: 大型 I

  • L7_flavor.elb.s2.large: 大型 II

  • L7_flavor.elb.s1.extra-large: 超大型 I

  • L7_flavor.elb.s2.extra-large: 超大型 II

  • L7_flavor.elb.pro.max: 七层弹性规格

shared

Boolean

参数解释：是否公共规格。

取值范围：

  • true表示公共规格，所有租户可见。

  • false表示私有规格，为当前租户所有。

project_id

String

参数解释：项目ID。

type

String

参数解释：规格类别。

取值范围：

  • L4和L7 表示四层网络型和七层应用型flavor。

  • L4_elastic和L7_elastic 表示弹性扩缩容实例的下限规格。已废弃，请勿使用。

  • L4_elastic_max、L7_elastic_max 表示弹性扩缩容实例的上限规格。

flavor_sold_out

Boolean

参数解释：

是否售罄。

取值范围：

  • true：已售罄，将无法购买该规格的LB。

  • false：未售罄，可购买该规格的LB。

public_border_group

String

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

category

Integer

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

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

参数

参数类型

描述

connection

Integer

参数解释：并发数。单位：个。

cps

Integer

参数解释：新建数。单位：个。

qps

Integer

参数解释：每秒查询数。单位：个。

约束限制：仅7层LB有该指标。

bandwidth

Integer

参数解释：带宽。单位：Kbit/s。

lcu

Integer

参数解释：当前flavor对应的lcu数量。单位：个。

说明：

LCU是用来衡量独享型ELB处理性能综合指标，LCU值越大，性能越好。

https_cps

Integer

参数解释：https新建连接数。单位：个。

约束限制：仅7层LB有该指标。
表7 PageInfo

参数

参数类型

描述

previous_marker

String

参数解释：分页查询结果中第一条记录的ID。通常用于配合page_reverse=true查询上一页。

next_marker

String

参数解释：分页查询结果中最后一条记录的ID。通常用于查询下一页。

current_count

Integer

参数解释：当前的记录数。

请求示例

查询支持的负载均衡规格列表

GET https://{ELB_Endpoint}/v3/057ef081eb00d2732fd1c01a9be75e6f/elb/flavors?limit=2&marker=179568ef-5ba4-4ca0-8c5e-5d581db779b1

响应示例

状态码：200

操作正常返回。

{
  "request_id" : "01e84c2750b7217e5903b3d3bc9a9fda",
  "flavors" : [ {
    "name" : "L7_flavor.basic.elb.s1.small",
    "shared" : true,
    "project_id" : "060576798a80d5762fafc01a9b5eedc7",
    "info" : {
      "bandwidth" : 50000,
      "connection" : 200000,
      "cps" : 2000,
      "https_cps" : 200,
      "lcu" : 10,
      "qps" : 4000
    },
    "id" : "037418d4-8c9e-40b8-9e54-70ff4848fd82",
    "type" : "L7_basic",
    "flavor_sold_out" : false,
    "public_border_group" : "center",
    "category" : 0
  }, {
    "name" : "L4_flavor.elb.s2.small",
    "shared" : true,
    "project_id" : "8d53f081ea24444aa95e2bfa942ef6ee",
    "info" : {
      "bandwidth" : 100000,
      "connection" : 1000000,
      "cps" : 20000,
      "lcu" : 20
    },
    "id" : "03925294-4ae2-4cdb-b912-cf171e782095",
    "type" : "L4",
    "flavor_sold_out" : false,
    "public_border_group" : "center",
    "category" : 0
  } ],
  "page_info" : {
    "next_marker" : "03925294-4ae2-4cdb-b912-cf171e782095",
    "previous_marker" : "037418d4-8c9e-40b8-9e54-70ff4848fd82",
    "current_count" : 2
  }
}

状态码

状态码

描述

200

操作正常返回。

错误码

请参见错误码。

父主题： 规格