文档首页/ 弹性负载均衡 ELB/ API参考 (巴黎区域)/ API（独享型）/ 规格/ 查询规格列表
更新时间：2024-04-08 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

是否反向查询。

取值：

  • true：查询上一页。

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

使用说明：

  • 必须与limit一起使用。

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

id

否

Array

规格ID。

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

name

否

Array

规格名称。

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

type

否

Array

规格类别。

取值：

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

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

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

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

shared

否

Boolean

是否查询公共规格。true表示公共规格，所有租户可见。false表示私有规格，为当前租户所有。

请求参数

表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

应用型有如下规格：

  • 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

shared

Boolean

是否公共规格。

取值：

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

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

project_id

String

项目ID。

type

String

规格类别。

取值：

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

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

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

最小长度：1

最大长度：32

flavor_sold_out

Boolean

是否售罄。

取值：

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

  • false：未售罄，可购买该规格的LB。
表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
  }, {
    "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
  } ],
  "page_info" : {
    "next_marker" : "03925294-4ae2-4cdb-b912-cf171e782095",
    "previous_marker" : "037418d4-8c9e-40b8-9e54-70ff4848fd82",
    "current_count" : 2
  }
}

状态码

状态码

描述

200

操作正常返回。

错误码

请参见错误码。

父主题： 规格