- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
- 用户指南
- 最佳实践
- API参考
- SDK参考
- 场景代码示例
- 常见问题
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
更新浮动IP
功能介绍
更新浮动IP。
更新时需在URL中给出浮动IP地址的ID。
port_id 为空,则表示浮动IP从端口解绑。
该接口有以下使用约束:
-
绑定浮动IP过程中,如果浮动IP处于“error”状态,请先尝试执行浮动IP解绑定动作。
-
不支持直接把已经绑定浮动IP的端口重新绑定到另外一个浮动IP上,必须先解绑再绑定。
接口约束
绑定浮动IP过程中,如果浮动IP处于“error”状态,请先尝试执行浮动IP解绑定动作。不支持直接把已经绑定端口的浮动ip重新绑定到另外一个端口上,必须先解绑定再绑定。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。
URI
PUT /v2.0/floatingips/{floatingip_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
floatingip_id |
是 |
String |
浮动IP地址的id。 【使用说明】创建浮动IP时不选,查询,更新,删除时是必选。 最小长度:0 最大长度:36 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
floatingip |
是 |
UpdateFloatingIpOption object |
更新floatingip对象 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
floatingip |
PostAndPutFloatingIpResp object |
floatingip对象 |
参数 |
参数类型 |
描述 |
---|---|---|
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" } }
响应示例
状态码: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.myclouds-dns.com."
}
}
状态码
状态码 |
描述 |
---|---|
200 |
GET和PUT操作正常返回 |
错误码
请参见错误码。