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 virtual machine, 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 physical network with the ID 720e45bc-4225-49de-9346-26513d8d1262 and assigns it to a virtual machine on port with the ID 418c8c9e-aaa5-42f2-8da7-24bfead6f28b and the virtual IP address 192.168.128.5.
3.12.2. vinfra service compute floatingip list¶
List floating IP addresses:
usage: vinfra service compute floatingip list [--long] [--limit <num>]
                                              [--marker <floating-ip>]
                                              [--ip-address <ip-address>]
                                              [--id <id>]
                                              [--network <network>]
- --long
- Enable access and listing of all fields of objects.
- --limit <num>
- The maximum number of floating IPs to list. To list all floating IPs, set the option to -1.
- --marker <floating-ip>
- List floating IPs after the marker.
- --ip-address <ip-address>
- List floating IPs with the specified IP address or use a filter. Supported filter operator: contains. The filter format is<operator>:<value1>[,<value2>,...].
- --id <id>
- Show a floating IP with the specified ID or list floating IPs using a filter. Supported filter operator: in. The filter format is<operator>:<value1>[,<value2>,...].
- --network <network>
- List floating IPs that have the specified network name or ID.
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.
