功能介绍
更新浮动IP。 更新时需在URL中给出浮动IP地址的ID。 port_id 为空，则表示浮动IP从端口解绑。
该接口有以下使用约束：
-
绑定浮动IP过程中，如果浮动IP处于“error”状态，请先尝试执行浮动IP解绑定动作。
-
不支持直接把已经绑定浮动IP的端口重新绑定到另外一个浮动IP上，必须先解绑再绑定。
接口约束
绑定浮动IP过程中，如果浮动IP处于“error”状态，请先尝试执行浮动IP解绑定动作。不支持直接把已经绑定端口的浮动ip重新绑定到另外一个端口上，必须先解绑定再绑定。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
PUT /v2.0/floatingips/{floatingip_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
floatingip_id |
是 |
String |
浮动IP地址的id。 【使用说明】创建浮动IP时不选，查询，更新，删除时是必选。 最小长度：0 最大长度：36 |
请求参数
响应参数
状态码： 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
fixed_ip_address |
String |
最小长度：0 最大长度：64 |
|
floating_ip_address |
String |
最小长度：0 最大长度：64 |
|
floating_network_id |
String |
最小长度：0 最大长度：36 |
|
id |
String |
最小长度：0 最大长度：36 |
|
port_id |
String |
最小长度：0 最大长度：36 |
|
router_id |
String |
最小长度：0 最大长度：36 |
|
status |
String |
枚举值：
|
|
tenant_id |
String |
最小长度：0 最大长度：36 |
|
dns_name |
String |
最小长度：0 最大长度：255 |
|
dns_domain |
String |
最小长度：0 最大长度：255 |
请求示例
-
解绑实例。
{ "floatingip" : { "port_id" : null } } -
绑定实例，port id为f91f5763-c5a2-4458-979d-61e48b3c3fac。
{ "floatingip" : { "port_id" : "f91f5763-c5a2-4458-979d-61e48b3c3fac" } }
响应示例
状态码： 200
GET和PUT操作正常返回
{
"floatingip" : {
"id" : "b997e0d4-3359-4c74-8f88-bc0af81cd5a2",
"status" : "DOWN",
"router_id" : null,
"tenant_id" : "bbfe8c41dd034a07bebd592bf03b4b0c",
"floating_network_id" : "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
"fixed_ip_address" : null,
"floating_ip_address" : "88.88.215.205",
"port_id" : null,
"dns_name" : "ecs-88-99-103-61",
"dns_domain" : "compute.hwclouds-dns.com."
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
GET和PUT操作正常返回 |
错误码
请参见错误码。
