Chapter 30. floating This chapter describes the commands under the floating command. 30.1. floating ip create Create floating IP Usage: Table 30.1. Positional arguments Value Summary <network> Network to allocate floating ip from (name or id) Table 30.2. Command arguments Value Summary -h, --help Show this help message and exit --extra-property type=<property_type>,name=<property_name>,value=<property_value> Additional parameters can be passed using this property. Default type of the extra property is string ( str ), but other types can be used as well. Available types are: dict , list , str , bool , int . In case of list type, value can be semicolon-separated list of values. For dict value is semicolon-separated list of the key:value pairs. --subnet <subnet> Subnet on which you want to create the floating ip (name or ID) --port <port> Port to be associated with the floating ip (name or ID) --floating-ip-address <ip-address> Floating ip address --fixed-ip-address <ip-address> Fixed ip address mapped to the floating ip --qos-policy <qos-policy> Attach qos policy to the floating ip (name or id) --description <description> Set floating ip description --project <project> Owner's project (name or id) --dns-domain <dns-domain> Set dns domain for this floating ip --dns-name <dns-name> Set dns name for this floating ip --project-domain <project-domain> Domain the project belongs to (name or id). this can be used in case collisions between project names exist. --tag <tag> Tag to be added to the floating ip (repeat option to set multiple tags) --no-tag No tags associated with the floating ip Table 30.3. Output formatter options Value Summary -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} The output format, defaults to table -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated to show multiple columns Table 30.4. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 30.5. Shell formatter options Value Summary --prefix PREFIX Add a prefix to all variable names Table 30.6. Table formatter options Value Summary --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. 30.2. floating ip delete Delete floating IP(s) Usage: Table 30.7. Positional arguments Value Summary <floating-ip> Floating ip(s) to delete (ip address or id) Table 30.8. Command arguments Value Summary -h, --help Show this help message and exit 30.3. floating ip list List floating IP(s) Usage: Table 30.9. Command arguments Value Summary -h, --help Show this help message and exit --network <network> List floating ip(s) according to given network (name or ID) --port <port> List floating ip(s) according to given port (name or ID) --fixed-ip-address <ip-address> List floating ip(s) according to given fixed ip address --floating-ip-address <ip-address> List floating ip(s) according to given floating ip address --long List additional fields in output --status <status> List floating ip(s) according to given status ( ACTIVE , DOWN ) --project <project> List floating ip(s) according to given project (name or ID) --project-domain <project-domain> Domain the project belongs to (name or id). this can be used in case collisions between project names exist. --router <router> List floating ip(s) according to given router (name or ID) --tags <tag>[,<tag>,... ] List floating ip which have all given tag(s) (comma- separated list of tags) --any-tags <tag>[,<tag>,... ] List floating ip which have any given tag(s) (comma- separated list of tags) --not-tags <tag>[,<tag>,... ] Exclude floating ip which have all given tag(s) (Comma-separated list of tags) --not-any-tags <tag>[,<tag>,... ] Exclude floating ip which have any given tag(s) (Comma-separated list of tags) Table 30.10. Output formatter options Value Summary -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} The output format, defaults to table -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated to show multiple columns --sort-column SORT_COLUMN Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated --sort-ascending Sort the column(s) in ascending order --sort-descending Sort the column(s) in descending order Table 30.11. CSV formatter options Value Summary --quote {all,minimal,none,nonnumeric} When to include quotes, defaults to nonnumeric Table 30.12. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 30.13. Table formatter options Value Summary --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. 30.4. floating ip pool list List pools of floating IP addresses Usage: Table 30.14. Command arguments Value Summary -h, --help Show this help message and exit Table 30.15. Output formatter options Value Summary -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} The output format, defaults to table -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated to show multiple columns --sort-column SORT_COLUMN Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated --sort-ascending Sort the column(s) in ascending order --sort-descending Sort the column(s) in descending order Table 30.16. CSV formatter options Value Summary --quote {all,minimal,none,nonnumeric} When to include quotes, defaults to nonnumeric Table 30.17. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 30.18. Table formatter options Value Summary --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. 30.5. floating ip port forwarding create Create floating IP port forwarding Usage: Table 30.19. Positional arguments Value Summary <floating-ip> Floating ip that the port forwarding belongs to (ip address or ID) Table 30.20. Command arguments Value Summary -h, --help Show this help message and exit --extra-property type=<property_type>,name=<property_name>,value=<property_value> Additional parameters can be passed using this property. Default type of the extra property is string ( str ), but other types can be used as well. Available types are: dict , list , str , bool , int . In case of list type, value can be semicolon-separated list of values. For dict value is semicolon-separated list of the key:value pairs. --internal-ip-address <internal-ip-address> The fixed ipv4 address of the network port associated to the floating IP port forwarding --port <port> The name or id of the network port associated to the floating IP port forwarding --internal-protocol-port <port-number> The protocol port number of the network port fixed IPv4 address associated to the floating IP port forwarding --external-protocol-port <port-number> The protocol port number of the port forwarding's floating IP address --protocol <protocol> The protocol used in the floating ip port forwarding, for instance: TCP, UDP --description <description> A text to describe/contextualize the use of the port forwarding configuration Table 30.21. Output formatter options Value Summary -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} The output format, defaults to table -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated to show multiple columns Table 30.22. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 30.23. Shell formatter options Value Summary --prefix PREFIX Add a prefix to all variable names Table 30.24. Table formatter options Value Summary --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. 30.6. floating ip port forwarding delete Delete floating IP port forwarding Usage: Table 30.25. Positional arguments Value Summary <floating-ip> Floating ip that the port forwarding belongs to (ip address or ID) <port-forwarding-id> The id of the floating ip port forwarding(s) to delete Table 30.26. Command arguments Value Summary -h, --help Show this help message and exit 30.7. floating ip port forwarding list List floating IP port forwarding Usage: Table 30.27. Positional arguments Value Summary <floating-ip> Floating ip that the port forwarding belongs to (ip address or ID) Table 30.28. Command arguments Value Summary -h, --help Show this help message and exit --port <port> Filter the list result by the id or name of the internal network port --external-protocol-port <port-number> Filter the list result by the protocol port number of the floating IP --protocol protocol Filter the list result by the port protocol Table 30.29. Output formatter options Value Summary -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} The output format, defaults to table -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated to show multiple columns --sort-column SORT_COLUMN Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated --sort-ascending Sort the column(s) in ascending order --sort-descending Sort the column(s) in descending order Table 30.30. CSV formatter options Value Summary --quote {all,minimal,none,nonnumeric} When to include quotes, defaults to nonnumeric Table 30.31. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 30.32. Table formatter options Value Summary --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. 30.8. floating ip port forwarding set Set floating IP Port Forwarding Properties Usage: Table 30.33. Positional arguments Value Summary <floating-ip> Floating ip that the port forwarding belongs to (ip address or ID) <port-forwarding-id> The id of the floating ip port forwarding Table 30.34. Command arguments Value Summary -h, --help Show this help message and exit --extra-property type=<property_type>,name=<property_name>,value=<property_value> Additional parameters can be passed using this property. Default type of the extra property is string ( str ), but other types can be used as well. Available types are: dict , list , str , bool , int . In case of list type, value can be semicolon-separated list of values. For dict value is semicolon-separated list of the key:value pairs. --port <port> The id of the network port associated to the floating IP port forwarding --internal-ip-address <internal-ip-address> The fixed ipv4 address of the network port associated to the floating IP port forwarding --internal-protocol-port <port-number> The tcp/udp/other protocol port number of the network port fixed IPv4 address associated to the floating IP port forwarding --external-protocol-port <port-number> The tcp/udp/other protocol port number of the port forwarding's floating IP address --protocol <protocol> The ip protocol used in the floating ip port forwarding --description <description> A text to describe/contextualize the use of the port forwarding configuration 30.9. floating ip port forwarding show Display floating IP Port Forwarding details Usage: Table 30.35. Positional arguments Value Summary <floating-ip> Floating ip that the port forwarding belongs to (ip address or ID) <port-forwarding-id> The id of the floating ip port forwarding Table 30.36. Command arguments Value Summary -h, --help Show this help message and exit Table 30.37. Output formatter options Value Summary -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} The output format, defaults to table -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated to show multiple columns Table 30.38. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 30.39. Shell formatter options Value Summary --prefix PREFIX Add a prefix to all variable names Table 30.40. Table formatter options Value Summary --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. 30.10. floating ip set Set floating IP Properties Usage: Table 30.41. Positional arguments Value Summary <floating-ip> Floating ip to modify (ip address or id) Table 30.42. Command arguments Value Summary -h, --help Show this help message and exit --extra-property type=<property_type>,name=<property_name>,value=<property_value> Additional parameters can be passed using this property. Default type of the extra property is string ( str ), but other types can be used as well. Available types are: dict , list , str , bool , int . In case of list type, value can be semicolon-separated list of values. For dict value is semicolon-separated list of the key:value pairs. --port <port> Associate the floating ip with port (name or id) --fixed-ip-address <ip-address> Fixed ip of the port (required only if port has multiple IPs) --description <description> Set floating ip description --qos-policy <qos-policy> Attach qos policy to the floating ip (name or id) --no-qos-policy Remove the qos policy attached to the floating ip --tag <tag> Tag to be added to the floating ip (repeat option to set multiple tags) --no-tag Clear tags associated with the floating ip. specify both --tag and --no-tag to overwrite current tags 30.11. floating ip show Display floating IP details Usage: Table 30.43. Positional arguments Value Summary <floating-ip> Floating ip to display (ip address or id) Table 30.44. Command arguments Value Summary -h, --help Show this help message and exit Table 30.45. Output formatter options Value Summary -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} The output format, defaults to table -c COLUMN, --column COLUMN Specify the column(s) to include, can be repeated to show multiple columns Table 30.46. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 30.47. Shell formatter options Value Summary --prefix PREFIX Add a prefix to all variable names Table 30.48. Table formatter options Value Summary --max-width <integer> Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. --fit-width Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable --print-empty Print empty table if there is no data to show. 30.12. floating ip unset Unset floating IP Properties Usage: Table 30.49. Positional arguments Value Summary <floating-ip> Floating ip to disassociate (ip address or id) Table 30.50. Command arguments Value Summary -h, --help Show this help message and exit --extra-property type=<property_type>,name=<property_name>,value=<property_value> Additional parameters can be passed using this property. Default type of the extra property is string ( str ), but other types can be used as well. Available types are: dict , list , str , bool , int . In case of list type, value can be semicolon-separated list of values. For dict value is semicolon-separated list of the key:value pairs. --port Disassociate any port associated with the floating ip --qos-policy Remove the qos policy attached to the floating ip --tag <tag> Tag to be removed from the floating ip (repeat option to remove multiple tags) --all-tag Clear all tags associated with the floating ip

Commands:
openstack floating ip create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--extra-property type=<property_type>,name=<property_name>,value=<property_value>] [--subnet <subnet>] [--port <port>] [--floating-ip-address <ip-address>] [--fixed-ip-address <ip-address>] [--qos-policy <qos-policy>] [--description <description>] [--project <project>] [--dns-domain <dns-domain>] [--dns-name <dns-name>] [--project-domain <project-domain>] [--tag <tag> | --no-tag] <network>
openstack floating ip delete [-h] <floating-ip> [<floating-ip> ...]
openstack floating ip list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN] [--quote {all,minimal,none,nonnumeric}] [--noindent] [--max-width <integer>] [--fit-width] [--print-empty] [--sort-column SORT_COLUMN] [--sort-ascending | --sort-descending] [--network <network>] [--port <port>] [--fixed-ip-address <ip-address>] [--floating-ip-address <ip-address>] [--long] [--status <status>] [--project <project>] [--project-domain <project-domain>] [--router <router>] [--tags <tag>[,<tag>,...]] [--any-tags <tag>[,<tag>,...]] [--not-tags <tag>[,<tag>,...]] [--not-any-tags <tag>[,<tag>,...]]
openstack floating ip pool list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN] [--quote {all,minimal,none,nonnumeric}] [--noindent] [--max-width <integer>] [--fit-width] [--print-empty] [--sort-column SORT_COLUMN] [--sort-ascending | --sort-descending]
openstack floating ip port forwarding create [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] [--extra-property type=<property_type>,name=<property_name>,value=<property_value>] --internal-ip-address <internal-ip-address> --port <port> --internal-protocol-port <port-number> --external-protocol-port <port-number> --protocol <protocol> [--description <description>] <floating-ip>
openstack floating ip port forwarding delete [-h] <floating-ip> <port-forwarding-id> [<port-forwarding-id> ...]
openstack floating ip port forwarding list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN] [--quote {all,minimal,none,nonnumeric}] [--noindent] [--max-width <integer>] [--fit-width] [--print-empty] [--sort-column SORT_COLUMN] [--sort-ascending | --sort-descending] [--port <port>] [--external-protocol-port <port-number>] [--protocol protocol] <floating-ip>
openstack floating ip port forwarding set [-h] [--extra-property type=<property_type>,name=<property_name>,value=<property_value>] [--port <port>] [--internal-ip-address <internal-ip-address>] [--internal-protocol-port <port-number>] [--external-protocol-port <port-number>] [--protocol <protocol>] [--description <description>] <floating-ip> <port-forwarding-id>
openstack floating ip port forwarding show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <floating-ip> <port-forwarding-id>
openstack floating ip set [-h] [--extra-property type=<property_type>,name=<property_name>,value=<property_value>] [--port <port>] [--fixed-ip-address <ip-address>] [--description <description>] [--qos-policy <qos-policy> | --no-qos-policy] [--tag <tag>] [--no-tag] <floating-ip>
openstack floating ip show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent] [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty] <floating-ip>
openstack floating ip unset [-h] [--extra-property type=<property_type>,name=<property_name>,value=<property_value>] [--port] [--qos-policy] [--tag <tag> | --all-tag] <floating-ip>