# Querying Floating IP Addresses

#### Function

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

#### URI

GET /v2.0/eip/floatingips_v6

Example:

    GET https://{Endpoint}/v2.0/eip/floatingips_v6?id={id}&router_id={router_id}&floating_network_id={floating_network_id}&floating_ip_address={floating_ip_address}&port_id={port_id }&fixed_ip_address={fixed_ip_address}&tenant_id={tenant_id}

Table 1 describes the parameters.

Table 1 Parameter description
Parameter | Mandatory | Type | Description
--- | --- | --- | ---
id | Yes | String | Specifies the floating IP address ID.
floating_ip_address | No | String | Specifies the floating IPv6 address.
floating_network_id | No | String | Specifies the external network ID. You can only use fixed external network. You can use GET /v2.0/networks?router:external=True or GET /v2.0/networks?name={floating_network} or run the neutron net-external-list command to obtain information about the external network.
router_id | No | String | Specifies the ID of the belonged router.
port_id | No | String | Specifies the port ID.
fixed_ip_address | No | String | Specifies the private IP address of the associated port.
tenant_id | No | String | Specifies the project ID.

#### Request Message

- Request parameter

  None

- Example request

  None

#### Response Message

- Response parameter

Table 2 Response parameter
Parameter | Type | Description
--- | --- | ---
floatingips | Array of floatingip objects | Specifies the floating IP address list. For details, see Table 3.

Table 3 floatingip objects
Parameter | Type | Description
--- | --- | ---

status

String

Specifies the floating IP address status. The value can be ACTIVE, DOWN, or ERROR.

- ACTIVE indicates that the floating IP address has been bound.
- ERROR indicates that the floating IP address is abnormal.
- DOWN indicates that the floating IP address has not been bound.

id | String | Specifies the floating IP address ID.
floating_ip_address | String | Specifies the floating IPv6 address.
floating_network_id | String | Specifies the external network ID.
router_id | String | Specifies the ID of the belonged router.
port_id | String | Specifies the port ID.
fixed_ip_address | String | Specifies the private IP address of the associated port.
tenant_id | String | Specifies the project ID.
floatingips_links | Array of strings | Specifies the request URL.

- Example response

      {
        "floatingips": [
          {
            "id": "861a4c5b-b17b-4a1d-b653-f3e95dcb3345",
            "status": "DOWN",
            "router_id": null,
            "tenant_id": "26ae5181a416420998eb2093aaed84d9",
            "project_id": "26ae5181a416420998eb2093aaed84d9",
            "floating_network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
            "fixed_ip_address": null,
            "floating_ip_address": "cdcd:910a:2222:5498:8475:1111:c613:16e3",
            "port_id": null,
            "created_at": "2019-03-26T09:52:41",
            "updated_at": "2019-03-26T09:52:45"
          }
        ],
        "floatingips_links": [
          {
            "href": "https://network.region.cn-southwest-2.hwclouds.com/v2.0/floatingips_v6?marker=861a4c5b-b17b-4a1d-b653-f3e95dcb3345&page_reverse=true&page_reverse=True",
            "rel": "previous"
          }
        ]
      }

#### Status Code

See Status Codes.

#### Error Code

See Error Codes.

Parent topic: Floating IP Address (IPv6)