| Method | URI | Description |
|---|---|---|
| POST | /v2/{tenant_id}/os-floating-ips | Allocates a new floating IP address to a tenant or account. |
This table shows the possible response codes for this operation:
| Response Code | Name | Description |
|---|---|---|
| 200 | ||
| 400 |
If there are no floating IPs available, the extension returns an error code 400 with a message indicating that no more floating IPs are available. |
This table shows the URI parameters for the allocate floating ip request:
| Name | Type | Description |
|---|---|---|
| String | The unique identifier of the tenant or account. |
Example 3.194. Allocate floating IP: XML request
<?xml version='1.0' encoding='UTF-8'?> <pool>nova</pool>
This operation does not require a request body.
Example 3.195. Allocate floating IP: JSON response
{
"floating_ip": {
"fixed_ip": null,
"id": 1,
"instance_id": null,
"ip": "10.10.10.1",
"pool": "nova"
}
}Example 3.196. Allocate floating IP: XML response
<?xml version='1.0' encoding='UTF-8'?> <floating_ip instance_id="None" ip="10.10.10.1" fixed_ip="None" id="1" pool="nova"/>
This operation does not return a response body.

