弹性负载均衡 ELB-创建后端云服务器组:请求消息

时间:2023-12-14 10:47:15

请求消息

表1 请求参数

参数

是否必选

参数类型

描述

pool

Object

后端云服务器组对象。详见表2

表2 pool字段说明

参数

是否必选

参数类型

描述

tenant_id

String

后端云服务器组所属的项目 ID。

获取方法详见获取项目ID

需要和token中的project_id一致。

支持的最大字符长度:255

project_id

String

此参数和tenant_id参数含义一样,均指后端云服务器组所属的项目 ID。

获取方法详见获取项目ID

需要和token中的project_id一致。

name

String

后端云服务器组名称。

支持的最大字符长度:255

description

String

后端云服务器组的描述信息。

支持的最大字符长度:255

protocol

String

后端云服务器组的后端协议。

支持TCP、UDP和HTTP。

当指定listener_id创建后端云服务器组时,后端云服务器组的protocol和它关联的监听器的protocol有如下关系:

  • 监听器的protocol为UDP时,后端云服务器组的protocol必须为UDP;
  • 监听器的protocol为TCP时,后端云服务器组的protocol必须为TCP;
  • 监听器的protocol为HTTP或TERMINATED_HTTPS时,后端云服务器组的protocol必须为HTTP。

lb_algorithm

String

后端云服务器组的负载均衡算法。

取值范围:
  • ROUND_ROBIN:加权轮询算法。
  • LEAST_CONNECTIONS:加权最少连接算法。
  • SOURCE_IP:源IP算法。

当该字段的取值为SOURCE_IP时,后端云服务器组绑定的后端云服务器的weight字段无效。

admin_state_up

Boolean

后端云服务器组的管理状态。

该字段为预留字段,暂未启用。默认为true。

listener_id

String

后端云服务器组关联的监听器的ID。

listener_id和loadbalancer_id中至少指定一个。

loadbalancer_id

String

后端云服务器组关联的负载均衡器ID。

listener_id和loadbalancer_id中至少指定一个。

session_persistence

Object

会话持久性。详细参见表3

取值为null时,表示会话保持关闭。

表3 session_persistence字段说明

参数

是否必选

参数类型

描述

type

String

会话保持的类型。

取值范围:
  • SOURCE_IP:根据请求的源IP,将同一IP的请求发送到同一个后端云服务器上。
  • HTTP_COOKIE:客户端第一次发送请求时,负载均衡器自动生成cookie并将该cookie插入响应消息中,后续请求会发送到处理第一个请求的后端云服务器上。
  • APP_COOKIE:客户端第一次发送请求时,后端服务器生成cookie并将该cookie插入响应消息中,后续请求会发送到处理第一个请求的后端云服务器上。

当后端云服务器组的protocol为TCP时,只按SOURCE_IP生效;当后端云服务器组的protocol为HTTP时,只按HTTP_COOKIE、APP_COOKIE生效。

cookie_name

String

cookie名称。

当会话保持类型是APP_COOKIE时,为必选字段,其它类型时不可指定。

persistence_timeout

Integer

会话保持的超时时间。

当type为APP_COOKIE时不生效。

取值范围:
  • [1,60](分钟):当后端云服务器组的protocol为TCP、UDP时。
  • [1,1440](分钟):当后端云服务器组的protocol为HTTP、HTTPS时。
support.huaweicloud.com/api-elb/elb_zq_hz_0001.html