華為云計(jì)算 云知識(shí) 創(chuàng)建浮動(dòng)IPNeutronCreateFloatingIp
創(chuàng)建浮動(dòng)IPNeutronCreateFloatingIp

 

功能介紹

創(chuàng)建浮動(dòng)IP的外部網(wǎng)絡(luò)UUID,請(qǐng)使用GET /v2.0/networks?router:external=True或neutron net-external-list方式獲取。

調(diào)試

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

URI

POST /v2.0/floatingips

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

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

參數(shù)

是否必選

參數(shù)類(lèi)型

描述

floatingip

CreateFloatingIpOption2 object

創(chuàng)建floatingip對(duì)象

表2 CreateFloatingIpOption2

參數(shù)

是否必選

參數(shù)類(lèi)型

描述

floating_ip_address

String

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

最大長(zhǎng)度:64

floating_network_id

String

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

  • 約束:只能使用固定的外網(wǎng),外部網(wǎng)絡(luò)的信息請(qǐng)通過(guò)GET /v2.0/networks?router:external=True或GET /v2.0/networks?name={floating_network}或neutron net-external-list方式查詢。

port_id

String

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

最大長(zhǎng)度:36

fixed_ip_address

String

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

最大長(zhǎng)度:64

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

狀態(tài)碼: 201

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

參數(shù)

參數(shù)類(lèi)型

描述

floatingip

PostAndPutFloatingIpResp object

floatingip對(duì)象

表4 PostAndPutFloatingIpResp

參數(shù)

參數(shù)類(lèi)型

描述

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)求示例

創(chuàng)建網(wǎng)絡(luò)為0a2228f2-7f8a-45f1-8e09-9039e1d09975的浮動(dòng)IP。

POST https://{Endpoint}/v2.0/floatingips

{
  "floatingip" : {
    "floating_network_id" : "0a2228f2-7f8a-45f1-8e09-9039e1d09975"
  }
}

響應(yīng)示例

狀態(tài)碼: 201

POST操作正常返回

{
  "floatingip" : {
    "id" : "1a3a2818-d9b4-4a9c-8a19-5252c499d1cd",
    "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)碼

描述

201

POST操作正常返回

錯(cuò)誤碼

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