文档首页 > > API参考> OpenStack Neutron API> 浮动IP> 查询浮动IP列表

查询浮动IP列表

分享
更新时间: 2019/11/22 GMT+08:00

功能介绍

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

查询指定的浮动IP的详细信息,可利用查询浮动IP接口进行查询。

URI

GET /v2.0/floatingips

参数说明请参见表1

表1 参数说明

参数

是否必选

类型

说明

id

String

浮动IP地址的id。

floating_ip_address

String

浮动IP地址(IPv6格式)。

floating_network_id

String

外部网络的id。

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

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

GET /v2.0/networks?name={floating_network}或neutron net-external-list方式查询。

router_id

String

所属路由器id。

port_id

String

端口id。

fixed_ip_address

String

关联端口的私有IP地址。

tenant_id

String

项目ID

样例:

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}&tenant_id={tenant_id}

请求消息

无。

响应消息

表2 响应参数

参数名称

类型

说明

floatingips

Array of floatingip objects

floatingip对象列表,参见表3

表3 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

dns_name

String

DNS名称

dns_domain

String

DNS域地址

created_at

String

资源创建时间

采用UTC时间

格式:YYYY-MM-DDTHH:MM:SS

updated_at

String

资源更新时间

采用UTC时间

格式:YYYY-MM-DDTHH:MM:SS

样例

请求样例

GET https://{Endpoint}/v2.0/floatingips?limit=1

响应样例

{
    "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,
            "created_at": "2017-10-19T12:21:28",
            "updated_at": "2018-07-30T12:52:13"
        }
    ]
}

状态码

请参见状态码

错误码

请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区