弹性负载均衡 ELB-更新负载均衡器:请求参数

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

IAM 鉴权Token。

最小长度:0

最大长度:4096

表3 请求Body参数

参数

是否必选

参数类型

描述

loadbalancer

UpdateLoadBalancerOption object

负载均衡器对象。

表4 UpdateLoadBalancerOption

参数

是否必选

参数类型

描述

name

String

负载均衡器的名称。

最小长度:0

最大长度:255

admin_state_up

Boolean

负载均衡器的管理状态。只能设置为true。

description

String

负载均衡器的描述。

最小长度:0

最大长度:255

ipv6_vip_virsubnet_id

String

双栈类型负载均衡器所在子网的IPv6网络ID。可以通过GET https://{VPC_Endpoint}/v1/{project_id}/subnets 响应参数中的id得到。

通过更新ipv6_vip_virsubnet_id可以更新负载均衡器所在IPv6子网,且负载均衡器的内网IPv6地址将发生变化。

使用说明:

  • ipv6_vip_virsubnet_id 对应的子网必须属于当前负载均衡器所在VPC,且子网需开启支持IPv6。

  • 只有guaranteed是true的负载均衡器才支持更新ipv6_vip_virsubnet_id。

  • 传入为null表示解绑IPv6子网。

  • 更新IPv6子网不会导致IPv4子网发生变化。

vip_subnet_cidr_id

String

负载均衡器所在的IPv4子网ID。可以通过GET https://{VPC_Endpoint}/v1/{project_id}/subnets 响应参数中的neutron_subnet_id得到。

通过更新vip_subnet_cidr_id可以更新负载均衡器所在IPv4子网,并且负载均衡器的内网IPv4地址将发生变化。

使用说明:

  • 若同时设置了vip_address,则必须保证vip_address对应的IP在vip_subnet_cidr_id的子网网段中。

  • vip_subnet_cidr_id对应的子网必须属于当前负载均衡器vpc_id对应的VPC。

  • 只有guaranteed是true的负载均衡器才支持更新vip_subnet_cidr_id。

  • 传入null表示解绑IPv4子网。

  • 更新IPv子网不会导致IPv4子网发生变化。

最小长度:1

最大长度:36

vip_address

String

负载均衡器的IPv4虚拟IP。该地址必须包含在所在子网的IPv4网段内,且未被占用。

注:仅当guaranteed是true的场合,才支持更新。

最小长度:1

最大长度:36

l4_flavor_id

String

四层Flavor ID。

使用说明:

  • 仅当guaranteed是true的场合,才支持更新。

  • 不允许非null变成null,null变成非null,即不配置七层规格和配置七层规格之间不允许切换;

  • 可以支持规格改大改小,注意改小过程中可能会造成部分长连接中断,影响部分链接的新建,

  • autoscaling.enable=true时,修改无意义,不生效。

  • 当传入的规格类型为L4,表示该实例为固定规格实例,按规格计费。

  • 当传入的规格类型为L4_elastic_max,表示该实例为弹性实例,按LCU计费。

最小长度:1

最大长度:255

l7_flavor_id

String

七层Flavor ID。

使用说明:

  • 仅当guaranteed是true的场合,才支持更新。

  • 不允许非null变成null,null变成非null,即不配置七层规格和配置七层规格之间不允许切换;

  • 可以支持规格改大改小,注意改小过程中可能会造成部分长连接中断,影响部分链接的新建,

  • autoscaling.enable=true时,修改无意义,不生效。

  • 当传入的规格类型为L7,表示该实例为固定规格实例,按规格计费。

  • 当传入的规格类型为L7_elastic_max,表示该实例为弹性实例,按LCU计费。

最小长度:1

最大长度:36

ipv6_bandwidth

BandwidthRef object

带宽对象ID,仅在创建或更新公网IPv6负载均衡器时有效。若选择创建新EIP并指定共享带宽时,此EIP会被分进共享带宽里面。

ip_target_enable

Boolean

是否启用跨VPC后端转发。

开启跨VPC后端转发后,后端服务器组不仅支持添加云上VPC内的服务器,还支持添加其他VPC、其他公有云、云下数据中心的服务器。

使用共享VPC的实例使用此特性时,需确保共享资源所有者已开通VPC对等连接,否则通信异常。

仅独享型负载均衡器支持该特性。

取值:

  • true:开启。

  • false:不开启。

使用说明:

  • 开启不能关闭。

elb_virsubnet_ids

Array of strings

下联面子网的网络ID列表。 可以通过GET https://{VPC_Endpoint}/v1/{project_id}/subnets

响应参数中的neutron_network_id得到。

已绑定的下联面子网也在传参elb_virsubnet_ids列表中,则绑定关系保留。

已绑定的下联面子网若不在传参elb_virsubnet_ids列表中, 则将移除LB与该下联面子网的关联关系。但不允许移除已被ELB使用的子网,否则将报错,不做任何修改。

在传参elb_virsubnet_ids列表中但不在已绑定的下联面子网列表中,则将新增LB与下联面的绑定关系。

使用说明:

  • 所有ID同属于该LB所在的VPC。

  • 不支持边缘云子网。

最小长度:1

最大长度:64

数组长度:0 - 64

deletion_protection_enable

Boolean

是否开启删除保护。

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

说明:

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

prepaid_options

PrepaidUpdateOption object

负载均衡器的包周期规格变更信息

autoscaling

UpdateLoadbalancerAutoscalingOption object

弹性扩缩容配置信息。负载均衡器配置并开启弹性扩缩容后,可根据负载情况自动调整负载均衡器的规格。

使用说明:

  • 仅当租户白名单放开后该字段才有效

  • 开启弹性扩缩容后,l4_flavor_id和l7_flavor_id表示该LB实例弹性规格的上限。

该字段已经废弃,但仍然保留兼容性支持,建议不要使用该字段。如果传入该字段,创建的弹性实例将会有保底规格并产生对应保底规格的费用。

charge_mode

String

计费模式。

取值:

  • flavor:按规格计费

waf_failure_action

String

WAF故障时的流量处理策略。discard:丢弃,forward: 转发到后端(默认)

使用说明:只有绑定了waf的LB实例,该字段才会生效。

最小长度:0

最大长度:36

protection_status

String

修改保护状态, 取值:

  • nonProtection: 不保护

  • consoleProtection: 控制台修改保护

protection_reason

String

设置保护的原因

说明:

仅当protection_status为consoleProtection时有效。

最小长度:0

最大长度:255

ipv6_vip_address

String

双栈类型负载均衡器的IPv6地址。

表5 BandwidthRef

参数

是否必选

参数类型

描述

id

String

共享带宽的id

表6 PrepaidUpdateOption

参数

是否必选

参数类型

描述

auto_pay

Boolean

下单订购后,是否自动从客户的账户中支付; true:自动支付; false:不自动支付(默认)。 自动支付时,只能使用账户的现金支付;如果要使用代金券,请选择不自动支付,然后在用户费用中心,选择代金券支付。

缺省值:false

change_mode

String

规格变更类型: immediate:即时变更,规格变更立即生效。(默认) delay:续费变更,当前周期结束后变更为目标规格。

缺省值:immediate

最小长度:0

最大长度:10

period_num

Integer

订购周期数(默认1),取值会随运营策略变化。(仅在change_mode为delay时生效) period_type为month时,为[1,9], period_type为year时,为[1,3]

最小值:1

最大值:9

缺省值:1

period_type

String

订购周期类型,当前支持包月和包年: (仅在change_mode为delay时生效) month:月(默认); year:年;

缺省值:month

表7 UpdateLoadbalancerAutoscalingOption

参数

是否必选

参数类型

描述

enable

Boolean

当前负载均衡器是否开启弹性扩缩容。

取值:

  • true:开启。

  • false:不开启。

缺省值:false

min_l7_flavor_id

String

弹性扩缩容的最小七层规格ID(规格类型L7_elastic),有七层监听器时,该字段不能为空。

该字段已经废弃,但仍然保留兼容性支持,建议不要使用该字段。如果传入该字段,创建的弹性实例将会有保底规格并产生对应保底规格的费用。

最小长度:1

最大长度:36

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