更新时间:2022-01-25 GMT+08:00

更新浮动IP

功能介绍

更新浮动IP。

更新时需在URL中给出浮动IP地址的ID。

port_id 为空,则表示浮动IP从端口解绑。

接口约束:

绑定浮动IP过程中,如果浮动IP处于“error”状态,请先尝试执行浮动IP解绑定动作。

不支持直接把已经绑定端口的浮动ip重新绑定到另外一个端口上,必须先解绑定再绑定。

URI

PUT /v2.0/floatingips/{floatingip_id}

参数说明请参见表1

表1 参数说明

参数

是否必选

类型

说明

floatingip_id

String

浮动IP地址的id。

【使用说明】创建浮动IP时不选,查询,更新,删除时是必选。

请求消息

表2 请求参数

参数名称

类型

必选

说明

floatingip

Object

floatingip对象列表,参见表3

表3 floatingip对象

参数

是否必选

类型

说明

port_id

String

端口id。

响应消息

表4 响应参数

参数名称

类型

说明

floatingip

Object

floatingip对象列表,参见表5

表5 floatingip对象

属性

类型

说明

status

String

网络状态,可以为ACTIVE, DOWN或ERROR。

  • DOWN:未绑定
  • ACTIVE:绑定
  • ERROR:异常

id

String

浮动IP地址的id。

floating_ip_address

String

浮动IP地址。

floating_network_id

String

外部网络的id。

router_id

String

所属路由器id。

port_id

String

端口id

fixed_ip_address

String

关联端口的私有IP地址。

tenant_id

String

项目ID

样例

请求样例1(浮动IP与端口绑定)

PUT https://{Endpoint}/v2.0/floatingips/b997e0d4-3359-4c74-8f88-bc0af81cd5a2 
 
{
    "floatingip": {
           "port_id": "f91f5763-c5a2-4458-979d-61e48b3c3fac"
    }
}

响应样例1(浮动IP与端口绑定)

{
    "floatingip": {
        "id": "b997e0d4-3359-4c74-8f88-bc0af81cd5a2",
        "status": "DOWN",
        "router_id": null,
        "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
        "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
        "floating_network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
        "fixed_ip_address": "192.168.10.3",
        "floating_ip_address": "88.88.215.205",
        "port_id": 00587256-27e3-489b-96bf-ea80c1da4aeb,
        "created_at": "2018-09-20T02:10:02",
        "updated_at": "2018-09-20T02:10:07"
    }
}

请求样例2(浮动IP与端口解绑)

PUT https://{Endpoint}/v2.0/floatingips/b997e0d4-3359-4c74-8f88-bc0af81cd5a2

{
    "floatingip": {
        "port_id": null
    }
}

响应样例2(浮动IP与端口解绑)

{
    "floatingip": {
        "id": "b997e0d4-3359-4c74-8f88-bc0af81cd5a2",
        "status": "DOWN",
        "router_id": null,
        "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
        "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
        "floating_network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
        "fixed_ip_address": null,
        "floating_ip_address": "88.88.215.205",
        "port_id": null,
        "created_at": "2018-09-20T02:10:02",
        "updated_at": "2018-09-20T02:10:07"
    }
}

状态码

请参见状态码

错误码

请参见错误码