升级负载均衡器类型
功能介绍
升级负载均衡器类型。支持将共享型ELB升级为独享型ELB,但不支持独享型降级为共享型。
调用方法
请参见如何调用API。
URI
POST /v3/{project_id}/elb/loadbalancers/{loadbalancer_id}/upgrade
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
负载均衡器所在的项目ID。 |
loadbalancer_id |
是 |
String |
负载均衡器ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
参数解释:IAM鉴权Token。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
action |
是 |
String |
升级操作:
|
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 |
参数解释:创建负载均衡器实例的预付费计费配置。若传入该结构体,则创建预付费类型的负载均衡器实例。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
period_type |
是 |
String |
参数解释:预付费实例的订购周期类型,当前支持月和年。 取值范围:
|
period_num |
否 |
Integer |
参数解释:预付费实例的订购周期数。 取值范围:
|
resource_package_type |
是 |
Array of strings |
参数解释:购买定向套餐包。 |
auto_pay |
否 |
Boolean |
参数解释:自动支付开关。下单订购后,是否自动从客户的账户中支付。 约束限制:开启自动支付时,只能使用账户的现金支付;如果要使用代金券,请选择关闭自动支付,然后在用户费用中心,选择代金券支付。 取值范围:
|
响应参数
状态码: 202
参数 |
参数类型 |
描述 |
---|---|---|
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 |
请求已接收,处理中。 |
错误码
请参见错误码。