更新负载均衡器
功能介绍
更新负载均衡器。
调用方法
请参见如何调用API。
URI
PUT /v3/{project_id}/elb/loadbalancers/{loadbalancer_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
loadbalancer_id |
是 |
String |
负载均衡器ID。 |
project_id |
是 |
String |
负载均衡器所在的项目ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
参数解释:IAM鉴权Token。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
loadbalancer |
是 |
UpdateLoadBalancerOption object |
参数解释:负载均衡器对象。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
否 |
String |
参数解释:负载均衡器的名称。 |
admin_state_up |
否 |
Boolean |
参数解释:负载均衡器的启用状态。 取值范围:
|
description |
否 |
String |
参数解释:负载均衡器的描述。 |
ipv6_vip_virsubnet_id |
否 |
String |
参数解释:双栈类型负载均衡器所在子网的IPv6网络ID,也称为该负载均衡器实例的前端子网。可以通过GET https://{VPC_Endpoint}/v1/{project_id}/subnets 响应参数中的neutron_network_id得到。 通过更新ipv6_vip_virsubnet_id可以更新负载均衡器所在IPv6子网,且负载均衡器的内网IPv6地址将发生变化。 约束限制:
|
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 |
否 |
String |
参数解释:负载均衡器的IPv4虚拟IP。 约束限制:该地址必须包含在所在子网的IPv4网段内,且未被占用。 注:仅当guaranteed是true的场合,才支持更新。 |
l4_flavor_id |
否 |
String |
参数解释:网络型规格ID。 约束限制:
|
l7_flavor_id |
否 |
String |
参数解释:应用型ID。 约束限制:
|
ipv6_bandwidth |
否 |
BandwidthRef object |
参数解释:带宽对象ID。 约束限制:
|
ip_target_enable |
否 |
Boolean |
参数解释:是否启用跨VPC后端转发。 开启跨VPC后端转发后,后端服务器组不仅支持添加云上VPC内的服务器,还支持添加其他VPC、其他公有云、云下数据中心的服务器。 约束限制:
取值范围:
|
elb_virsubnet_ids |
否 |
Array of strings |
参数解释:下联面子网的网络ID列表。 可以通过GET https://{VPC_Endpoint}/v1/{project_id}/subnets 响应参数中的neutron_network_id得到。 约束限制:
|
deletion_protection_enable |
否 |
Boolean |
参数解释:是否开启删除保护。 约束限制:退场时需要先关闭所有资源的删除保护开关。 取值范围:false不开启,true开启。 |
autoscaling |
否 |
参数解释:弹性扩缩容配置信息。负载均衡器开启弹性扩缩容后,可根据负载情况自动调整负载均衡器的规格。 约束限制:
该字段已经废弃,但仍然保留兼容性支持,建议不要使用该字段。如果传入该字段,创建的弹性实例将会有保底规格并产生对应保底规格的费用。 |
|
ipv6_vip_address |
否 |
String |
参数解释:双栈类型负载均衡器的IPv6地址。 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
loadbalancer |
LoadBalancer object |
参数解释:负载均衡器对象。(包周期规格变更场景不返回该字段) |
request_id |
String |
参数解释:请求ID。 注:自动生成 。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
参数解释:负载均衡器ID。 |
description |
String |
参数解释:负载均衡器描述信息。 |
provisioning_status |
String |
参数解释:负载均衡器的配置状态。 取值范围:
|
admin_state_up |
Boolean |
参数解释:负载均衡器的启用状态。 取值范围:
|
provider |
String |
参数解释:负载均衡器的生产者名称。固定为vlb。 |
pools |
Array of PoolRef objects |
参数解释:负载均衡器直接关联的后端服务器组的ID列表。 |
listeners |
Array of ListenerRef objects |
参数解释:负载均衡器关联的监听器的ID列表。 |
operating_status |
String |
参数解释:负载均衡器的操作状态。 取值范围:
|
name |
String |
参数解释:负载均衡器的名称。 |
project_id |
String |
参数解释:负载均衡器所属的项目ID。 |
vip_subnet_cidr_id |
String |
参数解释:负载均衡器所在子网的IPv4子网ID,也称为该负载均衡器实例的前端子网。 |
vip_address |
String |
参数解释:负载均衡器的IPv4虚拟IP地址。 |
vip_port_id |
String |
参数解释:负载均衡器的IPv4对应的port ID。 |
tags |
Array of Tag objects |
参数解释:负载均衡的标签列表。 |
created_at |
String |
参数解释:负载均衡器的创建时间。 取值范围: 格式:yyyy-MM-dd'T'HH:mm:ss'Z' |
updated_at |
String |
参数解释:负载均衡器的更新时间。 取值范围; 格式:yyyy-MM-dd'T'HH:mm:ss'Z' |
guaranteed |
Boolean |
参数解释:是否独享型LB。 取值范围:
|
vpc_id |
String |
参数解释:负载均衡器所在VPC ID。 |
eips |
Array of EipInfo objects |
参数解释:负载均衡器绑定的EIP。 约束限制:只支持绑定一个EIP。 注:该字段与publicips一致。 |
ipv6_vip_address |
String |
参数解释:双栈类型负载均衡器的IPv6地址。 |
ipv6_vip_virsubnet_id |
String |
参数解释:双栈类型负载均衡器所在子网的IPv6网络ID,也称为该负载均衡器实例的前端子网。 |
ipv6_vip_port_id |
String |
参数解释:双栈类型负载均衡器的IPv6对应的port ID。 |
availability_zone_list |
Array of strings |
参数解释:负载均衡器所在的可用区列表。 |
enterprise_project_id |
String |
参数解释:企业项目ID。创建时不传则返回"0",表示资源属于default企业项目。 注意:"0"并不是真实存在的企业项目ID,在创建、更新和查询时不能作为请求参数传入。 |
billing_info |
String |
参数解释:资源账单信息。 取值范围:
|
l4_flavor_id |
String |
参数解释:网络型规格ID。 对于弹性扩缩容实例,表示上限规格。 约束限制:
|
l4_scale_flavor_id |
String |
参数解释:四层弹性Flavor ID。 不支持该字段,请勿使用。 |
l7_flavor_id |
String |
参数解释:应用型ID。 对于弹性扩缩容实例,表示上限规格ID。 约束限制:
|
l7_scale_flavor_id |
String |
参数解释:七层弹性Flavor ID。 不支持该字段,请勿使用。 |
publicips |
Array of PublicIpInfo objects |
参数解释:负载均衡器绑定的公网IP。只支持绑定一个公网IP。 注:该字段与eips一致。 |
global_eips |
Array of GlobalEipInfo objects |
参数解释:负载均衡器绑定的global eip。 约束限制:只支持绑定一个globaleip。 |
elb_virsubnet_ids |
Array of strings |
参数解释:下联面子网的网络ID列表。 |
elb_virsubnet_type |
String |
参数解释:下联面子网类型。 取值范围:
|
ip_target_enable |
Boolean |
参数解释:是否启用跨VPC后端转发。 开启跨VPC后端转发后,后端服务器组不仅支持添加云上VPC内的服务器,还支持添加其他VPC、其他公有云、云下数据中心的服务器。 约束限制:
取值范围:
|
frozen_scene |
String |
参数解释:负载均衡器的冻结场景。 若负载均衡器有多个冻结场景,用逗号分隔。 取值范围:
|
ipv6_bandwidth |
BandwidthRef object |
参数解释:带宽对象ID。 约束限制:
|
deletion_protection_enable |
Boolean |
参数解释:是否开启删除保护。 约束限制:
取值范围:
|
autoscaling |
AutoscalingRef object |
参数解释:弹性扩缩容配置信息。负载均衡器开启弹性扩缩容后,可根据负载情况自动调整负载均衡器的规格。 约束限制:
该字段已经废弃,但仍然保留兼容性支持,建议不要使用该字段。如果传入该字段,创建的弹性实例将会有保底规格并产生对应保底规格的费用。 |
public_border_group |
String |
参数解释:LB所属AZ组。 |
waf_failure_action |
String |
参数解释:WAF故障时的流量处理策略。 约束限制:只有绑定了waf的LB实例,该字段才会生效。 取值范围:discard:丢弃,forward: 转发到后端。 默认取值:forward |
参数 |
参数类型 |
描述 |
---|---|---|
eip_id |
String |
参数解释:弹性IP的ID。 |
eip_address |
String |
参数解释:弹性IP的IP地址。 |
ip_version |
Integer |
参数解释:IP版本号。 取值范围:
|
参数 |
参数类型 |
描述 |
---|---|---|
publicip_id |
String |
参数解释:弹性公网ip配置id |
publicip_address |
String |
参数解释:IP地址 |
ip_version |
Integer |
参数解释:IP版本信息。 取值范围:4和6 4:IPv4 6:IPv6 |
请求示例
更新负载均衡器的描述和名称
PUT https://{ELB_Endpoint}/v3/{project_id}/elb/loadbalancers/{loadbalancer_id} { "loadbalancer" : { "description" : "loadbalancer", "name" : "loadbalancer-update" } }
响应示例
状态码:200
操作正常返回。
{ "request_id" : "010dad1e-32a3-4405-ab83-62a1fc5f8722", "loadbalancer" : { "id" : "2e073bf8-edfe-4e51-a699-d915b0b8af89", "project_id" : "b2782e6708b8475c993e6064bc456bf8", "name" : "loadbalancer-update", "description" : "loadbalancer", "vip_port_id" : null, "vip_address" : null, "admin_state_up" : true, "provisioning_status" : "ACTIVE", "operating_status" : "ONLINE", "listeners" : [ { "id" : "41937176-bf64-4b58-8e0d-9ff2d0d32c54" }, { "id" : "abc6ac93-ad0e-4765-bd5a-eec632efde56" }, { "id" : "b9d8ba97-6d60-467d-838d-f3550b54c22a" }, { "id" : "fd797ebd-263d-4b18-96e9-e9188d36c69e" } ], "pools" : [ { "id" : "0aabcaa8-c35c-4ddc-a60c-9032d0ac0b80" }, { "id" : "165d9092-396e-4a8d-b398-067496a447d2" } ], "tags" : [ ], "provider" : "vlb", "created_at" : "2019-04-20T03:10:37Z", "updated_at" : "2019-05-24T02:11:58Z", "vpc_id" : "2037c5bb-e04b-4de2-9300-9051af18e417", "enterprise_project_id" : "0", "availability_zone_list" : [ "AZ1", "AZ2", "dc3" ], "ipv6_vip_address" : null, "ipv6_vip_virsubnet_id" : null, "ipv6_vip_port_id" : null, "eips" : [ ], "guaranteed" : true, "billing_info" : null, "l4_flavor_id" : null, "l4_scale_flavor_id" : null, "l7_flavor_id" : null, "l7_scale_flavor_id" : null, "vip_subnet_cidr_id" : null, "deletion_protection_enable" : false, "public_border_group" : "center" } }
状态码
状态码 |
描述 |
---|---|
200 |
操作正常返回。 |
错误码
请参见错误码。