華為云計(jì)算 云知識(shí) 更新浮動(dòng)IPNeutronUpdateFloatingIp
更新浮動(dòng)IPNeutronUpdateFloatingIp
時(shí)間: 2023-10-12 15:49:27
猜你想看：
實(shí)時(shí)語(yǔ)音識(shí)別 云服務(wù)器配置 CDN是什么意思 視頻點(diǎn)播加速 什么是云桌面

 

功能介紹

更新浮動(dòng)IP。 更新時(shí)需在URL中給出浮動(dòng)IP地址的ID。 port_id 為空，則表示浮動(dòng)IP從端口解綁。

該接口有以下使用約束：

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

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

接口約束

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

調(diào)試

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

URI

PUT /v2.0/floatingips/{floatingip_id}

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

floatingip_id

是

String

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

最小長(zhǎng)度：0

最大長(zhǎng)度：36

請(qǐng)求參數(shù)

表2 請(qǐng)求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

floatingip

是

UpdateFloatingIpOption object

更新floatingip對(duì)象
表3 UpdateFloatingIpOption

參數(shù)

是否必選

參數(shù)類型

描述

port_id

否

String

端口id。

最小長(zhǎng)度：0

最大長(zhǎng)度：36

響應(yīng)參數(shù)

狀態(tài)碼： 200

表4 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

floatingip

PostAndPutFloatingIpResp object

floatingip對(duì)象
表5 PostAndPutFloatingIpResp

參數(shù)

參數(shù)類型

描述

fixed_ip_address

String

  • 功能說(shuō)明：關(guān)聯(lián)端口的私有IP地址。

最小長(zhǎng)度：0

最大長(zhǎng)度：64

floating_ip_address

String

  • 功能說(shuō)明：浮動(dòng)IP地址。

最小長(zhǎng)度：0

最大長(zhǎng)度：64

floating_network_id

String

  • 功能說(shuō)明：外部網(wǎng)絡(luò)的id。

最小長(zhǎng)度：0

最大長(zhǎng)度：36

id

String

  • 功能說(shuō)明：浮動(dòng)IP地址的id。

最小長(zhǎng)度：0

最大長(zhǎng)度：36

port_id

String

  • 功能說(shuō)明：端口id。

最小長(zhǎng)度：0

最大長(zhǎng)度：36

router_id

String

  • 功能說(shuō)明：所屬路由器id。

最小長(zhǎng)度：0

最大長(zhǎng)度：36

status

String

  • 功能說(shuō)明：網(wǎng)絡(luò)狀態(tài)，可以為ACTIVE， DOWN或ERROR

  • 取值范圍：

    • DOWN：未綁定

    • ACTIVE：綁定

    • ERROR：異常

枚舉值：

  • ACTIVE

  • DOWN

  • ERROR

tenant_id

String

  • 功能說(shuō)明：項(xiàng)目id。

最小長(zhǎng)度：0

最大長(zhǎng)度：36

dns_name

String

  • 功能說(shuō)明：DNS名稱，該參數(shù)當(dāng)前僅在“華南-廣州”開(kāi)放

最小長(zhǎng)度：0

最大長(zhǎng)度：255

dns_domain

String

  • 功能說(shuō)明：DNS域地址，該參數(shù)當(dāng)前僅在“華南-廣州”開(kāi)放

最小長(zhǎng)度：0

最大長(zhǎng)度：255

請(qǐng)求示例

  • 解綁實(shí)例。

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

  • 綁定實(shí)例，port id為f91f5763-c5a2-4458-979d-61e48b3c3fac。

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

響應(yīng)示例

狀態(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操作正常返回

錯(cuò)誤碼

請(qǐng)參見(jiàn)錯(cuò)誤碼。

 

猜你喜歡
更新浮動(dòng)IPNeutronUpdateFloatingIp

意見(jiàn)反饋

0/200

提交 取消

提交成功！非常感謝您的反饋，我們會(huì)繼續(xù)努力做到更好 反饋提交失?。≌?qǐng)稍后重試！