3.12. Managing Floating IP Addresses¶
3.12.1. vinfra service compute floatingip create¶
Create a floating IP address:
usage: vinfra service compute floatingip create [--floating-ip-address <floating-ip-address>]
[--port-id <port-id>]
[--fixed-ip-address <fixed-ip-address>]
[--description description] --network <network>
--floating-ip-address <floating-ip-address>
- Floating IP address
--port-id <port-id>
- ID of the port to be associated with the floating IP address. To learn the port ID of the selected server, use the command vinfra service compute server iface list.
--fixed-ip-address <fixed-ip-address>
- Port IP address (required only if the port has multiple IP addresses)
--description description
- Description of the floating IP address
--network <network>
- ID or name of the network from which to allocate the floating IP
Example:
# vinfra service compute floatingip create 720e45bc-4225-49de-9346-26513d8d1262 \
--port-id 418c8c9e-aaa5-42f2-8da7-24bfead6f28b --fixed-ip-address 192.168.128.5
+---------------------+--------------------------------------+
| Field | Value |
+---------------------+--------------------------------------+
| attached_to | a172cb6a-1c7b-4157-9e86-035f3077646f |
| description | |
| fixed_ip_address | 192.168.128.5 |
| floating_ip_address | 10.94.129.72 |
| floating_network_id | 720e45bc-4225-49de-9346-26513d8d1262 |
| id | a709f884-c43f-4a9a-a243-a340d7682ef8 |
| port_id | 418c8c9e-aaa5-42f2-8da7-24bfead6f28b |
| project_id | 894696133031439f8aaa7e4868dcbd4d |
| router_id | f7f86029-a553-4d61-b7ec-6f581d9c5f5f |
| status | DOWN |
+---------------------+--------------------------------------+
This command creates a floating IP address from the public network with the ID 720e45bc-4225-49de-9346-26513d8d1262
and assigns it to a server on port with the ID 418c8c9e-aaa5-42f2-8da7-24bfead6f28b
and the private IP address 192.168.128.5
.
3.12.2. vinfra service compute floatingip list¶
List floating IP addresses:
usage: vinfra service compute floatingip list
Example:
# vinfra service compute floatingip list -c id -c fixed_ip_address -c port_id \
-c floating_ip_address -c floating_network_id
+----------------+------------------+----------------+---------------------+---------------------+
| id | fixed_ip_address | port_id | floating_ip_address | floating_network_id |
+----------------+------------------+----------------+---------------------+---------------------+
| a709f884-<...> | 192.168.128.5 | 418c8c9e-<...> | 10.94.129.72 | 720e45bc-<...> |
+----------------+------------------+----------------+---------------------+---------------------+
This command lists floating IP addresses used in the compute cluster. (The output is abridged to fit on page.)
3.12.3. vinfra service compute floatingip show¶
Display information about a floating IP address:
usage: vinfra service compute floatingip show <floatingip>
<floatingip>
- ID of the floating IP address
Example:
# vinfra service compute floatingip show a709f884-c43f-4a9a-a243-a340d7682ef8
+---------------------+--------------------------------------+
| Field | Value |
+---------------------+--------------------------------------+
| attached_to | a172cb6a-1c7b-4157-9e86-035f3077646f |
| description | |
| fixed_ip_address | 192.168.128.5 |
| floating_ip_address | 10.94.129.72 |
| floating_network_id | 720e45bc-4225-49de-9346-26513d8d1262 |
| id | a709f884-c43f-4a9a-a243-a340d7682ef8 |
| port_id | 418c8c9e-aaa5-42f2-8da7-24bfead6f28b |
| project_id | 894696133031439f8aaa7e4868dcbd4d |
| router_id | f7f86029-a553-4d61-b7ec-6f581d9c5f5f |
| status | ACTIVE |
+---------------------+--------------------------------------+
This command shows the details of the floating IP address with the ID a709f884-c43f-4a9a-a243-a340d7682ef8
.
3.12.4. vinfra service compute floatingip set¶
Modify parameters of a floating IP address:
usage: vinfra service compute floatingip set [--port-id <port-id>]
[--fixed-ip-address <fixed-ip-address>]
[--description <description>] <floatingip>
--port-id <port-id>
- ID of the port to be associated with the floating IP address
--fixed-ip-address <fixed-ip-address>
- Port IP address (required only if the port has multiple IP addresses)
--description <description>
- Description of the floating IP address
<floatingip>
- ID of the floating IP address
Example:
# vinfra service compute floatingip set a709f884-c43f-4a9a-a243-a340d7682ef8 \
--description "Floating IP for myvm"
+---------------------+--------------------------------------+
| Field | Value |
+---------------------+--------------------------------------+
| attached_to | a172cb6a-1c7b-4157-9e86-035f3077646f |
| description | Floating IP for myvm |
| fixed_ip_address | 192.168.128.5 |
| floating_ip_address | 10.94.129.72 |
| floating_network_id | 720e45bc-4225-49de-9346-26513d8d1262 |
| id | a709f884-c43f-4a9a-a243-a340d7682ef8 |
| port_id | 418c8c9e-aaa5-42f2-8da7-24bfead6f28b |
| project_id | 894696133031439f8aaa7e4868dcbd4d |
| router_id | f7f86029-a553-4d61-b7ec-6f581d9c5f5f |
| status | ACTIVE |
+---------------------+--------------------------------------+
This command adds a description for the floating IP address with the ID a709f884-c43f-4a9a-a243-a340d7682ef8
.
3.12.5. vinfra service compute floatingip delete¶
Delete a floating IP address:
usage: vinfra service compute floatingip delete <floatingip>
<floatingip>
- ID of the floating IP address
Example:
# vinfra service compute floatingip delete a709f884-c43f-4a9a-a243-a340d7682ef8
Operation successful
This command deletes the floating IP address with the ID a709f884-c43f-4a9a-a243-a340d7682ef8
.