• Native OpenStack API

noa
  1. Help Center
  2. Native OpenStack API
  3. API Reference
  4. Nova
  5. Floating IPs
  6. Querying Floating IP Address Details

Querying Floating IP Address Details

Function Description

This interface is used to query the details about a floating IP address based on the ID of the IP address.

URI

  • URI format

    GET /v2/{tenant_id}/os-floating-ips/{floating_ip_id}

    GET /v2.1/{tenant_id}/os-floating-ips/{floating_ip_id}

  • Parameter description

    Parameter

    Mandatory

    Description

    tenant_id

    Yes

    Specifies the tenant or project ID.

    floating_ip_id

    Yes

    Specifies the ID of the floating IP address.

Restrictions

This interface will become invalid from micro version 2.36. Since this version, the system will return error 404 when you invoke this interface. Using the corresponding network service interface is recommended.

Request

Parameter

Type

Mandatory

Description

tenant_id

String

Yes

Specifies the tenant ID specified in the URI.

The value is in UUID format.

floating_ip_id

String

Yes

Specifies the ID of the floating IP address. Specified in the URI.

The value is in UUID format.

Response

Parameter

Type

Mandatory

Description

floating_ip

Dict

Yes

Specifies the floating IP address. For details, see Table 1.

Table 1 floating_ip objects

Parameter

Type

Mandatory

Description

fixed_ip

String

Yes

Specifies a private IP address.

id

String

Yes

Specifies a floating IP address ID in UUID format.

instance_id

String

Yes

Specifies the ID of a bound ECS in UUID format.

ip

String

Yes

Specifies a floating IP address.

pool

String

Yes

Specifies the name of a network resource pool that provides floating IP addresses.

Request Example

GET /v2/e73621affb8f44e1bc01898747ca09d4/os-floating-ips/05f71f43-f3c9-47ef-ac8d-9f02aef66418
GET /v2.1/e73621affb8f44e1bc01898747ca09d4/os-floating-ips/05f71f43-f3c9-47ef-ac8d-9f02aef66418

Response Example

{
  "floating_ip":{
      "id": "05f71f43-f3c9-47ef-ac8d-9f02aef66418",
      "pool": "external",
      "ip": "10.154.51.235",
      "fixed_ip": "192.168.1.2",
      "instance_id": "8b380f68-5057-4aa2-a33a-170b37218fa8"
    }
}

Returned Values

See General Request Returned Values.