文档首页/弹性公网IP EIP/API参考（联盟区域）/API（OpenStack Neutron V2.0 原生）/浮动IP/创建浮动IP
更新时间：2026-01-08 GMT+08:00
查看PDF
分享

创建浮动IP

功能介绍

创建浮动IP时需要浮动IP的外部网络ID“floating_network_id”。

创建浮动IP时的外部网络UUID，请使用GET /v2.0/networks?router:external=True或neutron net-external-list方式获取。

URI

POST /v2.0/floatingips

请求参数

表1 请求参数

参数名称

类型

必选

说明

floatingip

floatingip object

是

floatingip对象列表，参见表2。

表2 floatingip对象

参数

是否必选

类型

说明

floating_ip_address

否

String

浮动IP地址。

floating_network_id

是

String

外部网络的id。

只能使用固定的外网，外部网络的信息请通过

GET /v2.0/networks?router:external=True或

GET /v2.0/networks?name={floating_network}或

neutron net-external-list方式查询。

port_id

否

String

端口id

fixed_ip_address

否

String

关联端口的私有IP地址。

响应参数

表3 响应参数

参数名称

类型

说明

floatingip

floatingip object

floatingip对象列表，参见表4。

表4 floatingip对象

参数名称

类型

说明

status

String

网络状态，可以为ACTIVE， DOWN或ERROR。

  • DOWN：未绑定
  • ACTIVE：绑定
  • ERROR ：异常

id

String

浮动IP地址的id。

floating_ip_address

String

浮动IP地址。

floating_network_id

String

外部网络的id。

router_id

String

所属路由器id。

port_id

String

端口id

fixed_ip_address

String

关联端口的私有IP地址。

tenant_id

String

项目ID

。

请求示例

创建网络为0a2228f2-7f8a-45f1-8e09-9039e1d09975的浮动IP。

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

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

响应示例

状态码： 201

POST操作正常返回

{
    "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,
    }
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题：浮动IP