华为云计算 云知识 更新浮动IPNeutronUpdateFloatingIp
更新浮动IPNeutronUpdateFloatingIp

 

功能介绍

更新浮动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}

表1 路径参数

参数

是否必选

参数类型

描述

floatingip_id

String

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

最小长度:0

最大长度:36

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

floatingip

UpdateFloatingIpOption object

更新floatingip对象

表3 UpdateFloatingIpOption

参数

是否必选

参数类型

描述

port_id

String

端口id。

最小长度:0

最大长度:36

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

floatingip

PostAndPutFloatingIpResp object

floatingip对象

表5 PostAndPutFloatingIpResp

参数

参数类型

描述

fixed_ip_address

String

  • 功能说明:关联端口的私有IP地址。

最小长度:0

最大长度:64

floating_ip_address

String

  • 功能说明:浮动IP地址。

最小长度:0

最大长度:64

floating_network_id

String

  • 功能说明:外部网络的id。

最小长度:0

最大长度:36

id

String

  • 功能说明:浮动IP地址的id。

最小长度:0

最大长度:36

port_id

String

  • 功能说明:端口id。

最小长度:0

最大长度:36

router_id

String

  • 功能说明:所属路由器id。

最小长度:0

最大长度:36

status

String

  • 功能说明:网络状态,可以为ACTIVE, DOWN或ERROR

  • 取值范围:

    • DOWN:未绑定

    • ACTIVE:绑定

    • ERROR:异常

枚举值:

  • ACTIVE

  • DOWN

  • ERROR

tenant_id

String

  • 功能说明:项目id。

最小长度:0

最大长度:36

dns_name

String

  • 功能说明:DNS名称,该参数当前仅在“华南-广州”开放

最小长度:0

最大长度:255

dns_domain

String

  • 功能说明:DNS域地址,该参数当前仅在“华南-广州”开放

最小长度: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操作正常返回

错误码

请参见错误码

 

上一篇:什么是镜像 下一篇: CDN服务器是什么