.. _Managing Floating IP Addresses: Managing Floating IP Addresses ------------------------------ .. _vinfra service compute floatingip create: vinfra service compute floatingip create ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Create a floating IP address: :: usage: vinfra service compute floatingip create [--floating-ip-address ] [--port-id ] [--fixed-ip-address ] [--description description] --network ``--floating-ip-address `` Floating IP address ``--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 :ref:`vinfra service compute server iface list`. ``--fixed-ip-address `` Port IP address (required only if the port has multiple IP addresses) ``--description description`` Description of the floating IP address ``--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``. .. _vinfra service compute floatingip list: 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.) .. _vinfra service compute floatingip show: vinfra service compute floatingip show ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Display information about a floating IP address: :: usage: vinfra service compute floatingip show ```` 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``. .. _vinfra service compute floatingip set: vinfra service compute floatingip set ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Modify parameters of a floating IP address: :: usage: vinfra service compute floatingip set [--port-id ] [--fixed-ip-address ] [--description ] ``--port-id `` ID of the port to be associated with the floating IP address ``--fixed-ip-address `` Port IP address (required only if the port has multiple IP addresses) ``--description `` Description of the floating IP address ```` 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``. .. _vinfra service compute floatingip delete: vinfra service compute floatingip delete ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Delete a floating IP address: :: usage: vinfra service compute floatingip delete ```` 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``.