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
.