華為云計算 云知識 更新浮動IPNeutronUpdateFloatingIp
更新浮動IPNeutronUpdateFloatingIp

 

功能介紹

更新浮動IP。 更新時需在URL中給出浮動IP地址的ID。 port_id 為空,則表示浮動IP從端口解綁。

該接口有以下使用約束:

  • 綁定浮動IP過程中,如果浮動IP處于“error”狀態(tài),請先嘗試執(zhí)行浮動IP解綁定動作。

  • 不支持直接把已經(jīng)綁定浮動IP的端口重新綁定到另外一個浮動IP上,必須先解綁再綁定。

接口約束

綁定浮動IP過程中,如果浮動IP處于“error”狀態(tài),請先嘗試執(zhí)行浮動IP解綁定動作。不支持直接把已經(jīng)綁定端口的浮動ip重新綁定到另外一個端口上,必須先解綁定再綁定。

調(diào)試

您可以在API Explorer中調(diào)試該接口,支持自動認證鑒權(quán)。API Explorer可以自動生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。

URI

PUT /v2.0/floatingips/{floatingip_id}

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

floatingip_id

String

浮動IP地址的id。 【使用說明】創(chuàng)建浮動IP時不選,查詢,更新,刪除時是必選。

最小長度:0

最大長度:36

請求參數(shù)

表2 請求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

floatingip

UpdateFloatingIpOption object

更新floatingip對象

表3 UpdateFloatingIpOption

參數(shù)

是否必選

參數(shù)類型

描述

port_id

String

端口id。

最小長度:0

最大長度:36

響應參數(shù)

狀態(tài)碼: 200

表4 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

floatingip

PostAndPutFloatingIpResp object

floatingip對象

表5 PostAndPutFloatingIpResp

參數(shù)

參數(shù)類型

描述

fixed_ip_address

String

  • 功能說明:關聯(lián)端口的私有IP地址。

最小長度:0

最大長度:64

floating_ip_address

String

  • 功能說明:浮動IP地址。

最小長度:0

最大長度:64

floating_network_id

String

  • 功能說明:外部網(wǎng)絡的id。

最小長度:0

最大長度:36

id

String

  • 功能說明:浮動IP地址的id。

最小長度:0

最大長度:36

port_id

String

  • 功能說明:端口id。

最小長度:0

最大長度:36

router_id

String

  • 功能說明:所屬路由器id。

最小長度:0

最大長度:36

status

String

  • 功能說明:網(wǎng)絡狀態(tài),可以為ACTIVE, DOWN或ERROR

  • 取值范圍:

    • DOWN:未綁定

    • ACTIVE:綁定

    • ERROR:異常

枚舉值:

  • ACTIVE

  • DOWN

  • ERROR

tenant_id

String

  • 功能說明:項目id。

最小長度:0

最大長度:36

dns_name

String

  • 功能說明:DNS名稱,該參數(shù)當前僅在“華南-廣州”開放

最小長度:0

最大長度:255

dns_domain

String

  • 功能說明:DNS域地址,該參數(shù)當前僅在“華南-廣州”開放

最小長度:0

最大長度:255

請求示例

  • 解綁實例。

    {
      "floatingip" : {
        "port_id" : null
      }
    }
  • 綁定實例,port id為f91f5763-c5a2-4458-979d-61e48b3c3fac。

    {
      "floatingip" : {
        "port_id" : "f91f5763-c5a2-4458-979d-61e48b3c3fac"
      }
    }

響應示例

狀態(tài)碼: 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."
  }
}

狀態(tài)碼

狀態(tài)碼

描述

200

GET和PUT操作正常返回

錯誤碼

請參見錯誤碼。