接口约束
4.5 预占 IP
"id" : "3588b525-63ed-4b8f-8a03-6aaa9ad1c36a", "name" : "L7_flavor.slb.s2.large",
"type" : "L7",
"flavor_sold_out" : false
}, "request_id" : "3b9fb516-b7bb-4760-9128-4a23dd36ae10"
}
状态码
状态码 描述
200 操作正常返回。
错误码
请参见错误码。
4.5 预占 IP
4.5.1 计算预占 IP 数
功能介绍
计算以下几种场景的预占用IP数量：
● 计算创建LB的第一个七层监听器后总占用IP数量：传入loadbalancer_id、
l7_flavor_id为空、ip_target_enable不传或为false。
● 计算LB规格变更或开启跨VPC后总占用IP数量：传入参数loadbalancer_id，及 l7_flavor_id不为空或ip_target_enable为true。
● 计算创建LB所需IP数量：传入参数availability_zone_id，及可选参数 l7_flavor_id、ip_target_enable、ip_version，不能传loadbalancer_id。
说明
接口约束
● loadbalancer_id和availability_zone_id必须传入其中一个，若都传入则仅 loadbalancer_id会生效。
调试
您可以在API Explorer中调试该接口。
URI
GET /v3/{project_id}/elb/preoccupy-ip-num
表4-26 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 所属项目id。
表4-27 Query 参数
参数 是否必选 参数类型 描述
l7_flavor_id 否 String 负载均衡器七层规格的ID。传入 该字段表示计算创建该规格的 LB，或变更LB的原七层规格到 该规格所需要的预占IP。
适用场景：创建LB，变更LB规 格。
ip_target_ena
ble 否 Boolean 是否开启跨VPC转发。
取值true表示计算创建或变更为 开启跨VPC转发的LB的预占IP。
取值false表示计算创建或变更 为不开启跨VPC转发的LB的预占 IP。不传等价false。
适用场景：创建LB，变更LB规 格。
ip_version 否 Integer 负载均衡器IP地址类型，取值 4，6 。
取值4表示计算创建支持IPv4地 址的LB的预占IP。
取值6表示计算创建支持IPv6地 址的LB的预占IP。
适用场景：创建LB。
参数 是否必选 参数类型 描述 loadbalancer_
id 否 String 负载均衡器ID。计算LB规格变
更或创建LB中的第一个七层监 听器的预占IP。
适用场景：变更LB规格，创建 LB中的第一个七层监听器。
availability_zo
ne_id 否 Array 计算创建AZ列表为
availability_zone_id的负载局衡 器实例的预占IP。
适用场景：创建LB。
使用说明：
● 传入loadbalancer_id时，该 参数无效。
请求参数
表4-28 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String IAM鉴权Token。
响应参数
状态码： 200
表4-29 响应 Body 参数
参数 参数类型 描述
preoccupy_ip PreoccupyIp
object 预占IP信息 request_id String 请求ID。
注：自动生成 。
表4-30 PreoccupyIp
参数 参数类型 描述
total Integer 预占IP总数
请求示例
● 查询变更LB的七层规格需要预占的ip数
https://{ELB_Endpoint}/v3/060576782980d5762f9ec014dd2f1148/elb/preoccupy-ip-num?
loadbalancer_id=aff4fc31-d635-4f59-a862-edadf32e407d&l7_flavor_id=0051bc4c-a562-4b7c-953b-a250b51d992b
{ "preoccupy_ip" : { "total" : 6
}, "request_id" : "8844e9a0-6a2d-44b7-aad9-15a7f75e4059"
}
● 查询创建一个双az且开启跨VPC的LB需要预占的IP数
GET
/v3/{project_id}/elb/preoccupy-ip-num?l7_flavor_id=8278944d- f92c-4393-82b2-6fb9cc1d7e53&availability_zone_id=br-iaas-odin1a&availability_zone_id=br-iaas-odin1b&ip_target_enable=true
{ "preoccupy_ip" : { "total" : 20
}, "request_id" : "63388ec8-fa3c-4c99-b9c8-d2c83b2a9a68"
}
● 查询指定LB中创建第一个7层监听器所需预占的IP数
GET /v3/{project_id}/elb/preoccupy-ip-num?loadbalancer_id=aff4fc31-d635-4f59-a862-edadf32e407d { "preoccupy_ip" : {
"total" : 2
}, "request_id" : "febfce48-318d-45ba-a9d9-855462123f3b"
}
响应示例
状态码： 200 操作正常返回。
{ "preoccupy_ip" : { "total" : 20
}, "request_id" : "63388ec8-fa3c-4c99-b9c8-d2c83b2a9a68"
}
状态码
状态码 描述
200 操作正常返回。
错误码
请参见错误码。