• Native OpenStack API

noa
  1. Help Center
  2. Native OpenStack API
  3. API Reference
  4. Neutron
  5. Floating IP Address
  6. Querying Floating IP Addresses

Querying Floating IP Addresses

Function

This interface is used to query all floating IP addresses accessible to the tenant submitting the request.

URI

GET /v2.0/floatingips

Example:

/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}

Request Message

None

Response Message

Table 1 Response parameter

Parameter

Type

Description

floatingips

List(floatingip)

Specifies the floating IP address list. For details, see Object Model.

Example:

Example request

GET /v2.0/floatingips?limit=1

Example response

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

Status Codes

For details, see section Status Codes.