文档首页/ 弹性公网IP EIP/ API参考/ 历史API/ API（OpenStack Neutron V2.0 原生）（废弃）/ 浮动IP（废弃）/ 查询浮动IP列表 - NeutronListFloatingIps
更新时间：2025-10-31 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询浮动IP列表 - NeutronListFloatingIps

功能介绍

查询提交请求的租户有权限操作的所有浮动IP地址。单次查询最多返回2000条数据，超过2000后会返回分页标记。

接口约束

单次查询最多返回2000条数据，超过2000后会返回分页标记。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    eip:nativeFloatingIps:list

    List

    -

    -
    • vpc:publicIps:list
    • vpc:floatingIps:get

    -

URI

GET /v2.0/floatingips

表1 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

  • 功能说明：分页查询每页返回的记录个数

  • 取值范围为0~intmax。

  • 约束：limit需要和marker配合使用，详细规则请见marker的参数说明

最小值：0

最大值：2000

marker

否

String

  • 功能说明：分页查询的起始资源ID，表示从指定资源的下一条记录开始查询。

  • 约束：marker需要和limit配合使用：

    • 如果不传入marker和limit参数，查询结果返回全部资源记录。

    • 如果不传入marker参数，limit为10，查询结果返回第1~10条资源记录。

    • 如果marker为第10条记录的资源ID，limit为10，查询结果返回第11~20条资源记录。

    • 如果marker为第10条记录的资源ID，不传入limit参数，查询结果返回第11条及之后的所有资源记录。

最小长度：0

最大长度：36

page_reverse

否

Boolean

  • 功能说明：False/True，是否设置分页的顺序。

id

否

String

  • 功能说明：浮动IP的id。

最小长度：0

最大长度：36

floating_ip_address

否

String

  • 功能说明：浮动IP地址（IPv4格式）。

最小长度：0

最大长度：64

router_id

否

String

  • 功能说明：所属路由器id。

最小长度：0

最大长度：36

port_id

否

String

  • 功能说明：端口id。

最小长度：0

最大长度：36

fixed_ip_address

否

String

  • 功能说明：关联端口的私有IP地址。

最小长度：0

最大长度：64

tenant_id

否

String

  • 功能说明：项目ID。

最小长度：0

最大长度：36

floating_network_id

否

String

  • 功能说明：外部网络的id。

  • 约束：只能使用固定的外网，外部网络的信息请通过GET /v2.0/networks?router:external=True或GET /v2.0/networks?name={floating_network}或neutron net-external-list方式查询

最小长度：0

最大长度：36

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

floatingips

Array of FloatingIpResp objects

floatingip对象列表

数组长度：0 - 99999

floatingips_links

Array of Pager objects

floatingips_link对象列表

数组长度：0 - 99999
表3 FloatingIpResp

参数

参数类型

描述

fixed_ip_address

String

  • 功能说明：关联端口的私有IP地址。

最小长度：0

最大长度：64

floating_ip_address

String

  • 功能说明：浮动IP地址。

最小长度：0

最大长度：64

floating_network_id

String

  • 功能说明：外部网络id

最小长度：0

最大长度：36

id

String

  • 功能说明：浮动IP地址的id。

最小长度：0

最大长度：36

port_id

String

  • 功能说明：端口id

最小长度：0

最大长度：36

router_id

String

  • 功能说明：所属路由器id。

最小长度：0

最大长度：36

status

String

  • 功能说明：网络状态，可以为ACTIVE， DOWN或ERROR。

  • 取值范围：

    • DOWN：未绑定

    • ACTIVE：绑定

    • ERROR：异常

tenant_id

String

  • 功能说明：项目id。

最小长度：0

最大长度：36

project_id

String

  • 功能说明：项目id。

最小长度：0

最大长度：36

dns_name

String

  • 功能说明：DNS名称，该参数当前仅在“华南-广州”开放

最小长度：0

最大长度：255

dns_domain

String

  • 功能说明：DNS域地址，该参数当前仅在“华南-广州”开放

最小长度：0

最大长度：255

created_at

String

  • 功能说明：资源创建时间，采用UTC时间，格式：YYYY-MM-DDTHH:MM:SS

updated_at

String

  • 功能说明：资源更新时间，采用UTC时间，格式：YYYY-MM-DDTHH:MM:SS
表4 Pager

参数

参数类型

描述

href

String

页码url

最小长度：0

最大长度：256

rel

String

next：下一页

previous：前一页

请求示例

  • GET https://{Endpoint}/v2.0/floatingips?limit=1
  • GET https://{Endpoint}/v2.0/floatingips?id={fip_id}&router_id={router_id}&floating_network_id={net_id}&floating_ip_address={floating_ip}&port_id={port_id}&fixed_ip_address={fixed_ip}&project_id={project_id}

响应示例

状态码：200

GET操作正常返回

{
  "floatingips" : [ {
    "id" : "1a3a2818-d9b4-4a9c-8a19-5252c499d1cd",
    "status" : "DOWN",
    "router_id" : null,
    "tenant_id" : "bbfe8c41dd034a07bebd592bf03b4b0c",
    "project_id" : "bbfe8c41dd034a07bebd592bf03b4b0c",
    "floating_network_id" : "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
    "fixed_ip_address" : null,
    "floating_ip_address" : "99.99.99.84",
    "port_id" : null,
    "dns_name" : "ecs-88-99-103-61",
    "dns_domain" : "compute.myclouds-dns.com.",
    "created_at" : "2017-10-19T12:21:28",
    "updated_at" : "2018-07-30T12:52:13"
  } ],
  "floatingips_links" : [ {
    "href" : "https://network.region.test.clouds.com/v2.0/floatingips.json?limit=2000&marker=000a6144-5010-46f2-bf06-6a1c94477ea3&page_reverse=true",
    "rel" : "previous"
  }, {
    "href" : "https://network.region.test.clouds.com/v2.0/floatingips.json?limit=2000&marker=d445e537-bc81-4039-9c7b-f9c1f5c73c78",
    "rel" : "next"
  } ]
}

状态码

状态码

描述

200

GET操作正常返回

错误码

请参见错误码。

父主题： 浮动IP（废弃）

相关文档