Chapter 34. floating

This chapter describes the commands under the floating command.

34.1. floating ip create

Create floating IP

Usage:

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>

Table 34.1. Positional arguments

ValueSummary

<network>

Network to allocate floating ip from (name or id)

Table 34.2. Command arguments

ValueSummary

-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

ValueSummary

-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

ValueSummary

--noindent

Whether to disable indenting the json

Table 34.5. Shell formatter options

ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 34.6. Table formatter options

ValueSummary

--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:

openstack floating ip delete [-h] <floating-ip> [<floating-ip> ...]

Table 34.7. Positional arguments

ValueSummary

<floating-ip>

Floating ip(s) to delete (ip address or id)

Table 34.8. Command arguments

ValueSummary

-h, --help

Show this help message and exit

34.3. floating ip list

List floating IP(s)

Usage:

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>,...]]

Table 34.9. Command arguments

ValueSummary

-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

ValueSummary

-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

ValueSummary

--quote {all,minimal,none,nonnumeric}

When to include quotes, defaults to nonnumeric

Table 34.12. JSON formatter options

ValueSummary

--noindent

Whether to disable indenting the json

Table 34.13. Table formatter options

ValueSummary

--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:

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]

Table 34.14. Command arguments

ValueSummary

-h, --help

Show this help message and exit

Table 34.15. Output formatter options

ValueSummary

-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

ValueSummary

--quote {all,minimal,none,nonnumeric}

When to include quotes, defaults to nonnumeric

Table 34.17. JSON formatter options

ValueSummary

--noindent

Whether to disable indenting the json

Table 34.18. Table formatter options

ValueSummary

--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:

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>

Table 34.19. Positional arguments

ValueSummary

<floating-ip>

Floating ip that the port forwarding belongs to (ip address or ID)

Table 34.20. Command arguments

ValueSummary

-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

ValueSummary

-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

ValueSummary

--noindent

Whether to disable indenting the json

Table 34.23. Shell formatter options

ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 34.24. Table formatter options

ValueSummary

--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:

openstack floating ip port forwarding delete [-h]
                                                    <floating-ip>
                                                    <port-forwarding-id>
                                                    [<port-forwarding-id> ...]

Table 34.25. Positional arguments

ValueSummary

<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

ValueSummary

-h, --help

Show this help message and exit

34.7. floating ip port forwarding list

List floating IP port forwarding

Usage:

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>

Table 34.27. Positional arguments

ValueSummary

<floating-ip>

Floating ip that the port forwarding belongs to (ip address or ID)

Table 34.28. Command arguments

ValueSummary

-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

ValueSummary

-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

ValueSummary

--quote {all,minimal,none,nonnumeric}

When to include quotes, defaults to nonnumeric

Table 34.31. JSON formatter options

ValueSummary

--noindent

Whether to disable indenting the json

Table 34.32. Table formatter options

ValueSummary

--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:

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>

Table 34.33. Positional arguments

ValueSummary

<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

ValueSummary

-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:

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>

Table 34.35. Positional arguments

ValueSummary

<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

ValueSummary

-h, --help

Show this help message and exit

Table 34.37. Output formatter options

ValueSummary

-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

ValueSummary

--noindent

Whether to disable indenting the json

Table 34.39. Shell formatter options

ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 34.40. Table formatter options

ValueSummary

--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:

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>

Table 34.41. Positional arguments

ValueSummary

<floating-ip>

Floating ip to modify (ip address or id)

Table 34.42. Command arguments

ValueSummary

-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:

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>

Table 34.43. Positional arguments

ValueSummary

<floating-ip>

Floating ip to display (ip address or id)

Table 34.44. Command arguments

ValueSummary

-h, --help

Show this help message and exit

Table 34.45. Output formatter options

ValueSummary

-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

ValueSummary

--noindent

Whether to disable indenting the json

Table 34.47. Shell formatter options

ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 34.48. Table formatter options

ValueSummary

--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:

openstack floating ip unset [-h] [--port] [--qos-policy]
                                   [--tag <tag> | --all-tag]
                                   <floating-ip>

Table 34.49. Positional arguments

ValueSummary

<floating-ip>

Floating ip to disassociate (ip address or id)

Table 34.50. Command arguments

ValueSummary

-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