弹性负载均衡 ELB-创建后端服务器组:请求参数

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

IAM鉴权Token。

表3 请求Body参数

参数

是否必选

参数类型

描述

pool

CreatePoolOption object

创建pool的请求体。

表4 CreatePoolOption

参数

是否必选

参数类型

描述

admin_state_up

Boolean

后端云服务器组的管理状态,只支持更新为true。

不支持该字段,请勿使用。

description

String

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

最小长度:0

最大长度:255

lb_algorithm

String

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

取值:

  • ROUND_ROBIN:加权轮询算法。

  • LEAST_CONNECTIONS:加权最少连接算法。

  • SOURCE_IP:源IP算法。

  • QUIC_CID:连接ID算法。

使用说明:

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

  • 只有pool的protocol为QUIC时,才支持QUIC_CID算法。

listener_id

String

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

使用说明:

  • listener_id,loadbalancer_id,type至少指定一个。

  • 共享型实例的后端服务器组loadbalancer_id和listener_id至少指定一个。

最小长度:1

最大长度:36

loadbalancer_id

String

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

使用说明:

  • listener_id,loadbalancer_id,type至少指定一个。

  • 共享型实例的后端服务器组loadbalancer_id和listener_id至少指定一个。

最小长度:1

最大长度:36

name

String

后端云服务器组的名称。

最小长度:0

最大长度:255

project_id

String

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

最小长度:32

最大长度:32

protocol

String

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

取值:TCP、UDP、HTTP、HTTPS和QUIC。

使用说明:

  • listener的protocol为UDP时,pool的protocol必须为UDP或QUIC;

  • listener的protocol为TCP时pool的protocol必须为TCP;

  • listener的protocol为HTTP时,pool的protocol必须为HTTP。

  • listener的protocol为HTTPS时,pool的protocol必须为HTTP或HTTPS。

  • listener的protocol为TERMINATED_HTTPS时,pool的protocol必须为HTTP。

  • 若pool的protocol为QUIC,则必须开启session_persistence且type为SOURCE_IP。

最小长度:1

最大长度:255

session_persistence

CreatePoolSessionPersistenceOption object

会话持久性对象。

slow_start

CreatePoolSlowStartOption object

慢启动信息。开启慢启动后,将会在设定的时间段(duration)内对新添加到后端服务器组的后端服务器进行预热,转发到该服务器的请求数量线性增加。

当后端服务器组的协议为HTTP/HTTPS时有效,其他协议传入该字段将报错。

member_deletion_protection_enable

Boolean

是否开启删除保护。

取值:false不开启,true开启,默认false。

说明:

退场时需要先关闭所有资源的删除保护开关。

vpc_id

String

后端云服务器组关联的虚拟私有云的ID。

使用说明:

  • 只能挂载到该虚拟私有云下。

  • 只能添加该虚拟私有云下的后端服务器或跨VPC的后端服务器。

  • type必须指定为instance。

没有指定vpc_id的约束:

  • 后续添加后端服务器时,vpc_id由后端服务器所在的虚拟私有云确定。

最小长度:0

最大长度:36

type

String

后端服务器组的类型。

取值:

  • instance:允许任意类型的后端,type指定为该类型时,vpc_id是必选字段。

  • ip:只能添加跨VPC后端,type指定为该类型时,vpc_id不允许指定。

使用说明:

  • 不传表示允许任意类型的后端,并返回type为空字符串。

  • listener_id,loadbalancer_id,type至少指定一个。

  • 共享型实例的后端服务器组loadbalancer_id和listener_id至少指定一个。

最小长度:0

最大长度:36

ip_version

String

后端云服务器组支持的IP版本。

取值:

  • 共享型:固定为v4;

  • 独享型:取值dualstack、v4、v6。当协议为TCP/UDP时,ip_version为dualstack,表示双栈。

当协议为HTTP时,ip_version为v4。

最小长度:1

最大长度:20

protection_status

String

修改保护状态, 取值:

  • nonProtection: 不保护,默认值为nonProtection

  • consoleProtection: 控制台修改保护

protection_reason

String

设置保护的原因

说明:

仅当protection_status为consoleProtection时有效。

最小长度:0

最大长度:255

any_port_enable

Boolean

后端是否开启端口透传,开启后,后端服务器端口与前端监听器端口保持一致。

使用说明:

  • 仅QUIC,TCP,UDP的pool支持。

表5 CreatePoolSessionPersistenceOption

参数

是否必选

参数类型

描述

cookie_name

String

cookie名称。

共享型LB,支持字母、数字、中划线(-)和下划线(),最大长度64个字符。 独享型LB,支持字母、数字、中划线(-)、下划线()和点号(.),最大长度255个字符。

使用说明:

  • 只有当type为APP_COOKIE时才有效。其他情况下传该字段会报错。

type

String

会话保持类型。

取值范围:SOURCE_IP、HTTP_COOKIE、APP_COOKIE。

使用说明:

  • 当pool的protocol为TCP、UDP,无论type取值如何,都会被忽略,会话保持只按SOURCE_IP生效;

  • 当pool的protocol为HTTP、HTTPS时。如果是独享型负载均衡器的pool, 则type只能为HTTP_COOKIE,其他取值会话保持失效。如果是共享型负载均衡器的pool, 则type可以为HTTP_COOKIE和APP_COOKIE,其他取值会话保持失效。

  • 若pool的protocol为QUIC,则必须开启session_persistence且type为SOURCE_IP。

persistence_timeout

Integer

会话保持的时间。当type为APP_COOKIE时不生效。

适用范围:如果pool的protocol为TCP、UDP则范围为[1,60](分钟),默认值1; 如果pool的protocol为HTTP和HTTPS则范围为[1,1440](分钟),默认值1440。

表6 CreatePoolSlowStartOption

参数

是否必选

参数类型

描述

enable

Boolean

慢启动的开关,默认值:false; true:开启; false:关闭

缺省值:false

duration

Integer

慢启动的持续时间,单位:s。默认:30; 取值范围:30~1200

最小值:30

最大值:1200

缺省值:30

support.huaweicloud.com/api-elb/CreatePool.html