功能介紹
更新浮動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}
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
---|---|---|---|
floatingip_id |
是 |
String |
浮動IP地址的id。 【使用說明】創(chuàng)建浮動IP時不選,查詢,更新,刪除時是必選。 最小長度:0 最大長度:36 |
請求參數(shù)
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
---|---|---|---|
floatingip |
是 |
更新floatingip對象 |
響應參數(shù)
狀態(tài)碼: 200
參數(shù) |
參數(shù)類型 |
描述 |
---|---|---|
fixed_ip_address |
String |
最小長度:0 最大長度:64 |
floating_ip_address |
String |
最小長度:0 最大長度:64 |
floating_network_id |
String |
最小長度:0 最大長度:36 |
id |
String |
最小長度:0 最大長度:36 |
port_id |
String |
最小長度:0 最大長度:36 |
router_id |
String |
最小長度:0 最大長度:36 |
status |
String |
枚舉值:
|
tenant_id |
String |
最小長度:0 最大長度:36 |
dns_name |
String |
最小長度:0 最大長度:255 |
dns_domain |
String |
最小長度: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操作正常返回 |
錯誤碼
請參見錯誤碼。