Chapter 34. floating This chapter describes the commands under the floating command. 34.1. floating ip create Create floating IP Usage: Table 34.1. Positional arguments Value Summary <network> Network to allocate floating ip from (name or id) Table 34.2. Command arguments Value Summary -h, --help Show this help message and exit --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 34.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 Table 34.4. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 34.5. Shell formatter options Value Summary --prefix PREFIX Add a prefix to all variable names Table 34.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. 34.2. floating ip delete Delete floating IP(s) Usage: Table 34.7. Positional arguments Value Summary <floating-ip> Floating ip(s) to delete (ip address or id) Table 34.8. Command arguments Value Summary -h, --help Show this help message and exit 34.3. floating ip list List floating IP(s) Usage: Table 34.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 34.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 --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 Table 34.11. CSV formatter options Value Summary --quote {all,minimal,none,nonnumeric} When to include quotes, defaults to nonnumeric Table 34.12. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 34.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. 34.4. floating ip pool list List pools of floating IP addresses Usage: Table 34.14. Command arguments Value Summary -h, --help Show this help message and exit Table 34.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 --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 Table 34.16. CSV formatter options Value Summary --quote {all,minimal,none,nonnumeric} When to include quotes, defaults to nonnumeric Table 34.17. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 34.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. 34.5. floating ip port forwarding create Create floating IP port forwarding Usage: Table 34.19. Positional arguments Value Summary <floating-ip> Floating ip that the port forwarding belongs to (ip address or ID) Table 34.20. Command arguments Value Summary -h, --help Show this help message and exit --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 Table 34.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 Table 34.22. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 34.23. Shell formatter options Value Summary --prefix PREFIX Add a prefix to all variable names Table 34.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. 34.6. floating ip port forwarding delete Delete floating IP port forwarding Usage: Table 34.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 34.26. Command arguments Value Summary -h, --help Show this help message and exit 34.7. floating ip port forwarding list List floating IP port forwarding Usage: Table 34.27. Positional arguments Value Summary <floating-ip> Floating ip that the port forwarding belongs to (ip address or ID) Table 34.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 34.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 --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 Table 34.30. CSV formatter options Value Summary --quote {all,minimal,none,nonnumeric} When to include quotes, defaults to nonnumeric Table 34.31. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 34.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. 34.8. floating ip port forwarding set Set floating IP Port Forwarding Properties Usage: Table 34.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 34.34. Command arguments Value Summary -h, --help Show this help message and exit --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 34.9. floating ip port forwarding show Display floating IP Port Forwarding details Usage: Table 34.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 34.36. Command arguments Value Summary -h, --help Show this help message and exit Table 34.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 Table 34.38. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 34.39. Shell formatter options Value Summary --prefix PREFIX Add a prefix to all variable names Table 34.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. 34.10. floating ip set Set floating IP Properties Usage: Table 34.41. Positional arguments Value Summary <floating-ip> Floating ip to modify (ip address or id) Table 34.42. Command arguments Value Summary -h, --help Show this help message and exit --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) --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 34.11. floating ip show Display floating IP details Usage: Table 34.43. Positional arguments Value Summary <floating-ip> Floating ip to display (ip address or id) Table 34.44. Command arguments Value Summary -h, --help Show this help message and exit Table 34.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 Table 34.46. JSON formatter options Value Summary --noindent Whether to disable indenting the json Table 34.47. Shell formatter options Value Summary --prefix PREFIX Add a prefix to all variable names Table 34.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. 34.12. floating ip unset Unset floating IP Properties Usage: Table 34.49. Positional arguments Value Summary <floating-ip> Floating ip to disassociate (ip address or id) Table 34.50. Command arguments Value Summary -h, --help Show this help message and exit --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] [--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] [--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]
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] --internal-ip-address <internal-ip-address> --port <port> --internal-protocol-port <port-number> --external-protocol-port <port-number> --protocol <protocol> <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] [--port <port>] [--external-protocol-port <port-number>] [--protocol protocol] <floating-ip>
openstack floating ip port forwarding set [-h] [--port <port>] [--internal-ip-address <internal-ip-address>] [--internal-protocol-port <port-number>] [--external-protocol-port <port-number>] [--protocol <protocol>] <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] [--port <port>] [--fixed-ip-address <ip-address>] [--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] [--port] [--qos-policy] [--tag <tag> | --all-tag] <floating-ip>