更新时间:2024-12-13 GMT+08:00
分享

升级负载均衡器类型

功能介绍

升级负载均衡器类型。支持将共享型ELB升级为独享型ELB,但不支持独享型降级为共享型。

调用方法

请参见如何调用API

URI

POST /v3/{project_id}/elb/loadbalancers/{loadbalancer_id}/upgrade

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

负载均衡器所在的项目ID。

loadbalancer_id

String

负载均衡器ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:IAM鉴权Token。

表3 请求Body参数

参数

是否必选

参数类型

描述

action

String

升级操作:

  • start:开始升级,仅负载均衡器的provisioning_status为ACTIVE时支持。

  • complete:升级完成确认,仅实例的provision_status为UPGRADED时支持。确认后,实例无法再执行回退。

  • rollback:回滚,仅实例的provision_status为UPGRADED,UPGRADE_FAILED,ROLLBACK_FAILED时支持。

l4_flavor_id

String

四层规格ID。仅action为start时生效。

负载均衡器有四层监听器时该字段必须指定。

l4_flavor_id和l7_flavor_id不能同时为空。

l7_flavor_id

String

七层规格ID。仅action为start时生效。

负载均衡器有七层监听器时该字段必须指定。

l4_flavor_id和l7_flavor_id不能同时为空。

availability_zone_list

Array of strings

可用区列表。仅在action为start时生效。且action为start时,该字段必传

可通过GET https://{ELB_Endponit}/v3/{project_id}/elb/availability-zones

接口来查询可用区集合列表。创建负载均衡器时,从查询结果选择某一个可用区集合,并从中选择一个或多个可用区。

ipv6_vip_virsubnet_id

String

双栈类型负载均衡器所在子网的IPv6网络ID。

若实例升级到独享型后期望使用IPv6功能,则升级时该字段必传。

可以通过GET

https://{VPC_Endpoint}/v1/{project_id}/subnets 响应参数中的id得到。

使用说明:

ipv6_vip_virsubnet_id需要属于原共享型实例所属VPC。

ipv6_vip_virsubnet_id所属子网需要开启IPv6。

ipv6_vip_address

String

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

使用说明:

传入ipv6_vip_address时必须传入ipv6_vip_virsubnet_id。

不传入ipv6_vip_address,但传入ipv6_vip_virsubnet_id,则自动分配IPv6虚拟IP。

不传入ipv6_vip_address,且不传ipv6_vip_virsubnet_id,则不分配虚拟IP,ipv6_vip_address=null。

elb_virsubnet_ids

Array of strings

下联面子网的网络ID列表。仅action为start时生效。

可以通过GET https://{VPC_Endpoint}/v1/{project_id}/subnets

响应参数中的neutron_network_id得到。

若不指定该字段,则选择vip_subnet_cidr_id子网对应的网络ID。

下联面子网必须属于该LB所在的VPC。

prepaid_options

UpgradePrepaidOption object

参数解释:创建负载均衡器实例的预付费计费配置。若传入该结构体,则创建预付费类型的负载均衡器实例。

表4 UpgradePrepaidOption

参数

是否必选

参数类型

描述

period_type

String

参数解释:预付费实例的订购周期类型,当前支持月和年。

取值范围:

  • month:月。

  • year:年。

period_num

Integer

参数解释:预付费实例的订购周期数。

取值范围:

  • period_type为month时,为[1,9]。

  • period_type为year时,为[1,3]。

resource_package_type

Array of strings

参数解释:购买定向套餐包。

auto_pay

Boolean

参数解释:自动支付开关。下单订购后,是否自动从客户的账户中支付。

约束限制:开启自动支付时,只能使用账户的现金支付;如果要使用代金券,请选择关闭自动支付,然后在用户费用中心,选择代金券支付。

取值范围:

  • true:开启自动支付。

  • false:关闭自动支付。

响应参数

状态码: 202

表5 响应Body参数

参数

参数类型

描述

request_id

String

请求ID。 注:自动生成 。

job_id

String

升级的任务ID。

请求示例

实例1:开始迁移

POST https://{ELB_Endponit}/v3/060576798a80d5762fafc01a9b5eedc7/elb/loadbalancers/2c0b5b97-221b-4136-afc2-15d6570f31cb/upgrade

{
  "action" : "start",
  "availability_zone_list" : [ "AZ1" ],
  "elb_virsubnet_ids" : [ "5eddff5a-f45f-46d7-9f2b-70dc669feff9" ],
  "l4_flavor_id" : "f3c46bc2-1304-40b4-902b-cefae3858d17",
  "l7_flavor_id" : "1b333094-bd31-4cb8-97e2-ea762fde3576"
}

响应示例

状态码: 202

请求已接收,处理中。

{
  "request_id" : "841e0da7-5835-4130-9a47-01688f34a154",
  "job_id" : "062804a2-9e39-4dde-bd9b-271859ee312b"
}

状态码

状态码

描述

202

请求已接收,处理中。

错误码

请参见错误码

相关文档