Chapter 44. loadbalancer


This chapter describes the commands under the loadbalancer command.

44.1. loadbalancer amphora list

Usage:

openstack loadbalancer amphora list [-h]

                                         [-f {csv,json,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent]
                                         [--quote {all,minimal,none,nonnumeric}]
                                         [--sort-column SORT_COLUMN]
                                         [--loadbalancer <loadbalancer>]
                                         [--compute-id <compute-id>]
                                         [--role {MASTER,BACKUP,STANDALONE}]
                                         [--status {PENDING_DELETE,DELETED,ERROR,PENDING_CREATE,BOOTING,READY,ALLOCATED}]
Copy to Clipboard Toggle word wrap

List amphorae

Expand
Table 44.1. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--loadbalancer <loadbalancer>

Filter by load balancer (name or ID).

--compute-id <compute-id>

Filter by compute ID.

--role {MASTER,BACKUP,STANDALONE}

Filter by role.

--status {PENDING_DELETE,DELETED,ERROR,PENDING_CREATE,BOOTING,READY,ALLOCATED}, --provisioning-status {PENDING_DELETE,DELETED,ERROR,PENDING_CREATE,BOOTING,READY,ALLOCATED}

Filter by amphora provisioning status.

Expand
Table 44.2. Output Formatters
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

Expand
Table 44.3. Table Formatter
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.

Expand
Table 44.4. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.5. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.2. loadbalancer amphora show

Usage:

openstack loadbalancer amphora show [-h]

                                         [-f {json,shell,table,value,yaml}]
                                         [-c COLUMN] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--noindent] [--prefix PREFIX]
                                         <amphora-id>
Copy to Clipboard Toggle word wrap

Show the details of a single amphora

Expand
Table 44.6. Positional Arguments
ValueSummary

<amphora-id>

Uuid of the amphora.

Expand
Table 44.7. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.8. Output Formatters
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

Expand
Table 44.9. Table Formatter
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.

Expand
Table 44.10. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.11. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.3. loadbalancer create

Usage:

openstack loadbalancer create [-h] [-f {json,shell,table,value,yaml}]

                                   [-c COLUMN] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--noindent] [--prefix PREFIX]
                                   [--name <name>]
                                   [--description <description>]
                                   [--vip-address <vip_address>]
                                   [--vip-port-id <vip_port_id>]
                                   [--vip-subnet-id <vip_subnet_id>]
                                   [--vip-network-id <vip_network_id>]
                                   [--vip-qos-policy-id <vip_qos_policy_id>]
                                   [--project <project>]
                                   [--enable | --disable]
Copy to Clipboard Toggle word wrap

Create a load balancer

Expand
Table 44.12. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New load balancer name.

--description <description>

Set load balancer description.

--vip-address <vip_address>

Set the VIP IP Address.

--vip-qos-policy-id <vip_qos_policy_id>

Set QoS policy ID for VIP port. Unset with 'None'.

--project <project>

Project for the load balancer (name or id).

--enable

Enable load balancer (default).

--disable

Disable load balancer.

Expand
Table 44.13. Output Formatters
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

Expand
Table 44.14. Table Formatter
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.

Expand
Table 44.15. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.16. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Expand
Table 44.17. VIP Network
ValueSummary

--vip-port-id <vip_port_id>

Set Port for the load balancer (name or ID).

--vip-subnet-id <vip_subnet_id>

Set subnet for the load balancer (name or ID).

--vip-network-id <vip_network_id>

Set network for the load balancer (name or ID).

This command is provided by the python-octaviaclient plugin.

44.4. loadbalancer delete

Usage:

openstack loadbalancer delete [-h] [--cascade] <load_balancer>
Copy to Clipboard Toggle word wrap

Delete a load balancer

Expand
Table 44.18. Positional Arguments
ValueSummary

<load_balancer>

Load balancers to delete (name or id)

Expand
Table 44.19. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--cascade

Cascade the delete to all child elements of the load balancer.

This command is provided by the python-octaviaclient plugin.

44.5. loadbalancer failover

Usage:

openstack loadbalancer failover [-h] <load_balancer>
Copy to Clipboard Toggle word wrap

Trigger load balancer failover

Expand
Table 44.20. Positional Arguments
ValueSummary

<load_balancer>

Name or uuid of the load balancer.

Expand
Table 44.21. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

44.6. loadbalancer healthmonitor create

Usage:

openstack loadbalancer healthmonitor create [-h]

                                                 [-f {json,shell,table,value,yaml}]
                                                 [-c COLUMN]
                                                 [--max-width <integer>]
                                                 [--fit-width]
                                                 [--print-empty]
                                                 [--noindent]
                                                 [--prefix PREFIX]
                                                 [--name <name>] --delay
                                                 <delay>
                                                 [--expected-codes <codes>]
                                                 [--http-method {GET,POST,DELETE,PUT,HEAD,OPTIONS,PATCH,CONNECT,TRACE}]
                                                 --timeout <timeout>
                                                 --max-retries <max_retries>
                                                 [--url-path <url_path>]
                                                 --type
                                                 {PING,HTTP,TCP,HTTPS,TLS-HELLO,UDP-CONNECT}
                                                 [--max-retries-down <max_retries_down>]
                                                 [--enable | --disable]
                                                 <pool>
Copy to Clipboard Toggle word wrap

Create a health monitor

Expand
Table 44.22. Positional Arguments
ValueSummary

<pool>

Set the pool for the health monitor (name or id).

Expand
Table 44.23. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set the health monitor name.

--delay <delay>

Set the time in seconds, between sending probes to members.

--expected-codes <codes>

Set the list of HTTP status codes expected in response from the member to declare it healthy.

--http-method {GET,POST,DELETE,PUT,HEAD,OPTIONS,PATCH,CONNECT,TRACE}

Set the HTTP method that the health monitor uses for requests.

--timeout <timeout>

Set the maximum time, in seconds, that a monitor waits to connect before it times out. This value must be less than the delay value.

--max-retries <max_retries>

The number of successful checks before changing the operating status of the member to ONLINE.

--url-path <url_path>

Set the HTTP URL path of the request sent by the monitor to test the health of a backend member.

--type {PING,HTTP,TCP,HTTPS,TLS-HELLO,UDP-CONNECT}

Set the health monitor type.

--max-retries-down <max_retries_down>

Set the number of allowed check failures before changing the operating status of the member to ERROR.

--enable

Enable health monitor (default).

--disable

Disable health monitor.

Expand
Table 44.24. Output Formatters
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

Expand
Table 44.25. Table Formatter
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.

Expand
Table 44.26. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.27. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.7. loadbalancer healthmonitor delete

Usage:

openstack loadbalancer healthmonitor delete [-h] <health_monitor>
Copy to Clipboard Toggle word wrap

Delete a health monitor

Expand
Table 44.28. Positional Arguments
ValueSummary

<health_monitor>

Health monitor to delete (name or id).

Expand
Table 44.29. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

44.8. loadbalancer healthmonitor list

Usage:

openstack loadbalancer healthmonitor list [-h]

                                               [-f {csv,json,table,value,yaml}]
                                               [-c COLUMN]
                                               [--max-width <integer>]
                                               [--fit-width] [--print-empty]
                                               [--noindent]
                                               [--quote {all,minimal,none,nonnumeric}]
                                               [--sort-column SORT_COLUMN]
Copy to Clipboard Toggle word wrap

List health monitors

Expand
Table 44.30. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.31. Output Formatters
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

Expand
Table 44.32. Table Formatter
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.

Expand
Table 44.33. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.34. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.9. loadbalancer healthmonitor set

Usage:

openstack loadbalancer healthmonitor set [-h] [--name <name>]

                                              [--delay <delay>]
                                              [--expected-codes <codes>]
                                              [--http-method {GET,POST,DELETE,PUT,HEAD,OPTIONS,PATCH,CONNECT,TRACE}]
                                              [--timeout <timeout>]
                                              [--max-retries <max_retries>]
                                              [--max-retries-down <max_retries_down>]
                                              [--url-path <url_path>]
                                              [--enable | --disable]
                                              <health_monitor>
Copy to Clipboard Toggle word wrap

Update a health monitor

Expand
Table 44.35. Positional Arguments
ValueSummary

<health_monitor>

Health monitor to update (name or id).

Expand
Table 44.36. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set health monitor name.

--delay <delay>

Set the time in seconds, between sending probes to members.

--expected-codes <codes>

Set the list of HTTP status codes expected in response from the member to declare it healthy.

--http-method {GET,POST,DELETE,PUT,HEAD,OPTIONS,PATCH,CONNECT,TRACE}

Set the HTTP method that the health monitor uses for requests.

--timeout <timeout>

Set the maximum time, in seconds, that a monitor waits to connect before it times out. This value must be less than the delay value.

--max-retries <max_retries>

Set the number of successful checks before changing the operating status of the member to ONLINE.

--max-retries-down <max_retries_down>

Set the number of allowed check failures before changing the operating status of the member to ERROR.

--url-path <url_path>

Set the HTTP URL path of the request sent by the monitor to test the health of a backend member.

--enable

Enable health monitor.

--disable

Disable health monitor.

This command is provided by the python-octaviaclient plugin.

44.10. loadbalancer healthmonitor show

Usage:

openstack loadbalancer healthmonitor show [-h]

                                               [-f {json,shell,table,value,yaml}]
                                               [-c COLUMN]
                                               [--max-width <integer>]
                                               [--fit-width] [--print-empty]
                                               [--noindent]
                                               [--prefix PREFIX]
                                               <health_monitor>
Copy to Clipboard Toggle word wrap

Show the details of a single health monitor

Expand
Table 44.37. Positional Arguments
ValueSummary

<health_monitor>

Name or uuid of the health monitor.

Expand
Table 44.38. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.39. Output Formatters
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

Expand
Table 44.40. Table Formatter
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.

Expand
Table 44.41. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.42. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.11. loadbalancer l7policy create

Usage:

openstack loadbalancer l7policy create [-h]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            [--name <name>]
                                            [--description <description>]
                                            --action
                                            {REDIRECT_TO_URL,REDIRECT_TO_POOL,REJECT}
                                            [--redirect-pool <pool> | --redirect-url <url>]
                                            [--position <position>]
                                            [--enable | --disable]
                                            <listener>
Copy to Clipboard Toggle word wrap

Create a l7policy

Expand
Table 44.43. Positional Arguments
ValueSummary

<listener>

Listener to add l7policy to (name or id).

Expand
Table 44.44. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set the l7policy name.

--description <description>

Set l7policy description.

--action {REDIRECT_TO_URL,REDIRECT_TO_POOL,REJECT}

Set the action of the policy.

--redirect-pool <pool>

Set the pool to redirect requests to (name or ID).

--redirect-url <url>

Set the url to redirect requests to.

--position <position>

Sequence number of this L7 Policy.

--enable

Enable l7policy (default).

--disable

Disable l7policy.

Expand
Table 44.45. Output Formatters
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

Expand
Table 44.46. Table Formatter
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.

Expand
Table 44.47. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.48. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.12. loadbalancer l7policy delete

Usage:

openstack loadbalancer l7policy delete [-h] <policy>
Copy to Clipboard Toggle word wrap

Delete a l7policy

Expand
Table 44.49. Positional Arguments
ValueSummary

<policy>

L7policy to delete (name or id).

Expand
Table 44.50. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

44.13. loadbalancer l7policy list

Usage:

openstack loadbalancer l7policy list [-h]

                                          [-f {csv,json,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent]
                                          [--quote {all,minimal,none,nonnumeric}]
                                          [--sort-column SORT_COLUMN]
Copy to Clipboard Toggle word wrap

List l7policies

Expand
Table 44.51. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.52. Output Formatters
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

Expand
Table 44.53. Table Formatter
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.

Expand
Table 44.54. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.55. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.14. loadbalancer l7policy set

Usage:

openstack loadbalancer l7policy set [-h] [--name <name>]

                                         [--description <description>]
                                         [--action {REDIRECT_TO_URL,REDIRECT_TO_POOL,REJECT}]
                                         [--redirect-pool <pool> | --redirect-url <url>]
                                         [--position <position>]
                                         [--enable | --disable]
                                         <policy>
Copy to Clipboard Toggle word wrap

Update a l7policy

Expand
Table 44.56. Positional Arguments
ValueSummary

<policy>

L7policy to update (name or id).

Expand
Table 44.57. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set l7policy name.

--description <description>

Set l7policy description.

--action {REDIRECT_TO_URL,REDIRECT_TO_POOL,REJECT}

Set the action of the policy.

--redirect-pool <pool>

Set the pool to redirect requests to (name or ID).

--redirect-url <url>

Set the url to redirect requests to.

--position <position>

Set sequence number of this L7 Policy.

--enable

Enable l7policy.

--disable

Disable l7policy.

This command is provided by the python-octaviaclient plugin.

44.15. loadbalancer l7policy show

Usage:

openstack loadbalancer l7policy show [-h]

                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent] [--prefix PREFIX]
                                          <policy>
Copy to Clipboard Toggle word wrap

Show the details of a single l7policy

Expand
Table 44.58. Positional Arguments
ValueSummary

<policy>

Name or uuid of the l7policy.

Expand
Table 44.59. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.60. Output Formatters
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

Expand
Table 44.61. Table Formatter
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.

Expand
Table 44.62. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.63. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.16. loadbalancer l7rule create

Usage:

openstack loadbalancer l7rule create [-h]

                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent] [--prefix PREFIX]
                                          --compare-type
                                          {REGEX,EQUAL_TO,CONTAINS,ENDS_WITH,STARTS_WITH}
                                          [--invert] --value <value>
                                          [--key <key>] --type
                                          {FILE_TYPE,PATH,COOKIE,HOST_NAME,HEADER}
                                          [--enable | --disable]
                                          <l7policy>
Copy to Clipboard Toggle word wrap

Create a l7rule

Expand
Table 44.64. Positional Arguments
ValueSummary

<l7policy>

L7policy to add l7rule to (name or id).

Expand
Table 44.65. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--compare-type {REGEX,EQUAL_TO,CONTAINS,ENDS_WITH,STARTS_WITH}

Set the compare type for the l7rule.

--invert

Invert l7rule.

--value <value>

Set the rule value to match on.

--key <key>

Set the key for the l7rule’s value to match on.

--type {FILE_TYPE,PATH,COOKIE,HOST_NAME,HEADER}

Set the type for the l7rule.

--enable

Enable l7rule (default).

--disable

Disable l7rule.

Expand
Table 44.66. Output Formatters
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

Expand
Table 44.67. Table Formatter
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.

Expand
Table 44.68. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.69. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.17. loadbalancer l7rule delete

Usage:

openstack loadbalancer l7rule delete [-h] <l7policy> <rule_id>
Copy to Clipboard Toggle word wrap

Delete a l7rule

Expand
Table 44.70. Positional Arguments
ValueSummary

<l7policy>

L7policy to delete rule from (name or id).

<rule_id>

L7rule to delete.

Expand
Table 44.71. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

44.18. loadbalancer l7rule list

Usage:

openstack loadbalancer l7rule list [-h]

                                        [-f {csv,json,table,value,yaml}]
                                        [-c COLUMN] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--noindent]
                                        [--quote {all,minimal,none,nonnumeric}]
                                        [--sort-column SORT_COLUMN]
                                        <l7policy>
Copy to Clipboard Toggle word wrap

List l7rules for l7policy

Expand
Table 44.72. Positional Arguments
ValueSummary

<l7policy>

L7policy to list rules for (name or id).

Expand
Table 44.73. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.74. Output Formatters
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

Expand
Table 44.75. Table Formatter
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.

Expand
Table 44.76. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.77. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.19. loadbalancer l7rule set

Usage:

openstack loadbalancer l7rule set [-h]

                                       [--compare-type {REGEX,EQUAL_TO,CONTAINS,ENDS_WITH,STARTS_WITH}]
                                       [--invert] [--value <value>]
                                       [--key <key>]
                                       [--type {FILE_TYPE,PATH,COOKIE,HOST_NAME,HEADER}]
                                       [--enable | --disable]
                                       <l7policy> <l7rule_id>
Copy to Clipboard Toggle word wrap

Update a l7rule

Expand
Table 44.78. Positional Arguments
ValueSummary

<l7policy>

L7policy to update l7rule on (name or id).

<l7rule_id>

L7rule to update.

Expand
Table 44.79. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--compare-type {REGEX,EQUAL_TO,CONTAINS,ENDS_WITH,STARTS_WITH}

Set the compare type for the l7rule.

--invert

Invert l7rule.

--value <value>

Set the rule value to match on.

--key <key>

Set the key for the l7rule’s value to match on.

--type {FILE_TYPE,PATH,COOKIE,HOST_NAME,HEADER}

Set the type for the l7rule.

--enable

Enable l7rule.

--disable

Disable l7rule.

This command is provided by the python-octaviaclient plugin.

44.20. loadbalancer l7rule show

Usage:

openstack loadbalancer l7rule show [-h]

                                        [-f {json,shell,table,value,yaml}]
                                        [-c COLUMN] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--noindent] [--prefix PREFIX]
                                        <l7policy> <l7rule_id>
Copy to Clipboard Toggle word wrap

Show the details of a single l7rule

Expand
Table 44.80. Positional Arguments
ValueSummary

<l7policy>

L7policy to show rule from (name or id).

<l7rule_id>

L7rule to show.

Expand
Table 44.81. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.82. Output Formatters
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

Expand
Table 44.83. Table Formatter
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.

Expand
Table 44.84. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.85. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.21. loadbalancer list

Usage:

openstack loadbalancer list [-h] [-f {csv,json,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--quote {all,minimal,none,nonnumeric}]
                                 [--sort-column SORT_COLUMN] [--name <name>]
                                 [--enable | --disable]
                                 [--project <project-id>]
                                 [--vip-network-id <vip_network_id>]
                                 [--vip-subnet-id <vip_subnet_id>]
                                 [--vip-qos-policy-id <vip_qos_policy_id>]
                                 [--vip-port-id <vip_port_id>]
                                 [--provisioning-status {ACTIVE,DELETED,ERROR,PENDING_CREATE,PENDING_UPDATE,PENDING_DELETE}]
                                 [--operating-status {ONLINE,DRAINING,OFFLINE,DEGRADED,ERROR,NO_MONITOR}]
                                 [--provider <provider>]
Copy to Clipboard Toggle word wrap

List load balancers

Expand
Table 44.86. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

List load balancers according to their name.

--enable

List enabled load balancers.

--disable

List disabled load balancers.

--project <project-id>

List load balancers according to their project (name or ID).

--vip-network-id <vip_network_id>

List load balancers according to their VIP network (name or ID).

--vip-subnet-id <vip_subnet_id>

List load balancers according to their VIP subnet (name or ID).

--vip-qos-policy-id <vip_qos_policy_id>

List load balancers according to their VIP Qos policy (name or ID).

--vip-port-id <vip_port_id>

List load balancers according to their VIP port (name or ID).

--provisioning-status {ACTIVE,DELETED,ERROR,PENDING_CREATE,PENDING_UPDATE,PENDING_DELETE}

List load balancers according to their provisioning status.

--operating-status {ONLINE,DRAINING,OFFLINE,DEGRADED,ERROR,NO_MONITOR}

List load balancers according to their operating status.

--provider <provider>

List load balancers according to their provider.

Expand
Table 44.87. Output Formatters
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

Expand
Table 44.88. Table Formatter
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.

Expand
Table 44.89. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.90. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.22. loadbalancer listener create

Usage:

openstack loadbalancer listener create [-h]

                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--noindent] [--prefix PREFIX]
                                            [--name <name>]
                                            [--description <description>]
                                            --protocol
                                            {TCP,HTTP,HTTPS,TERMINATED_HTTPS,UDP}
                                            [--connection-limit <limit>]
                                            [--default-pool <pool>]
                                            [--default-tls-container-ref <container_ref>]
                                            [--sni-container-refs [<container_ref> [<container_ref> ...]]]
                                            [--insert-headers <header=value,...>]
                                            --protocol-port <port>
                                            [--timeout-client-data <timeout>]
                                            [--timeout-member-connect <timeout>]
                                            [--timeout-member-data <timeout>]
                                            [--timeout-tcp-inspect <timeout>]
                                            [--enable | --disable]
                                            <loadbalancer>
Copy to Clipboard Toggle word wrap

Create a listener

Expand
Table 44.91. Positional Arguments
ValueSummary

<loadbalancer>

Load balancer for the listener (name or id).

Expand
Table 44.92. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set the listener name.

--description <description>

Set the description of this listener.

--protocol {TCP,HTTP,HTTPS,TERMINATED_HTTPS,UDP}

The protocol for the listener.

--connection-limit <limit>

Set the maximum number of connections permitted for this listener.

--default-pool <pool>

Set the name or ID of the pool used by the listener if no L7 policies match.

--default-tls-container-ref <container_ref>

The URI to the key manager service secrets container containing the certificate and key for TERMINATED_TLS listeners.

--sni-container-refs [<container_ref> [<container_ref> …​]]

A list of URIs to the key manager service secrets containers containing the certificates and keys for TERMINATED_TLS the listener using Server Name Indication.

--insert-headers <header=value,…​>

A dictionary of optional headers to insert into the request before it is sent to the backend member.

--protocol-port <port>

Set the protocol port number for the listener.

--timeout-client-data <timeout>

Frontend client inactivity timeout in milliseconds. Default: 50000.

--timeout-member-connect <timeout>

Backend member connection timeout in milliseconds. Default: 5000.

--timeout-member-data <timeout>

Backend member inactivity timeout in milliseconds. Default: 50000.

--timeout-tcp-inspect <timeout>

Time, in milliseconds, to wait for additional TCP packets for content inspection. Default: 0.

--enable

Enable listener (default).

--disable

Disable listener.

Expand
Table 44.93. Output Formatters
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

Expand
Table 44.94. Table Formatter
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.

Expand
Table 44.95. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.96. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.23. loadbalancer listener delete

Usage:

openstack loadbalancer listener delete [-h] <listener>
Copy to Clipboard Toggle word wrap

Delete a listener

Expand
Table 44.97. Positional Arguments
ValueSummary

<listener>

Listener to delete (name or id)

Expand
Table 44.98. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

44.24. loadbalancer listener list

Usage:

openstack loadbalancer listener list [-h]

                                          [-f {csv,json,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent]
                                          [--quote {all,minimal,none,nonnumeric}]
                                          [--sort-column SORT_COLUMN]
                                          [--name <name>]
                                          [--loadbalancer <loadbalancer>]
                                          [--enable | --disable]
                                          [--project <project>]
Copy to Clipboard Toggle word wrap

List listeners

Expand
Table 44.99. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

List listeners by listener name.

--loadbalancer <loadbalancer>

Filter by load balancer (name or ID).

--enable

List enabled listeners.

--disable

List disabled listeners.

--project <project>

List listeners by project id.

Expand
Table 44.100. Output Formatters
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

Expand
Table 44.101. Table Formatter
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.

Expand
Table 44.102. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.103. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.25. loadbalancer listener set

Usage:

openstack loadbalancer listener set [-h] [--name <name>]

                                         [--description <description>]
                                         [--connection-limit <limit>]
                                         [--default-pool <pool>]
                                         [--default-tls-container-ref <container-ref>]
                                         [--sni-container-refs [<container-ref> [<container-ref> ...]]]
                                         [--insert-headers <header=value>]
                                         [--timeout-client-data <timeout>]
                                         [--timeout-member-connect <timeout>]
                                         [--timeout-member-data <timeout>]
                                         [--timeout-tcp-inspect <timeout>]
                                         [--enable | --disable]
                                         <listener>
Copy to Clipboard Toggle word wrap

Update a listener

Expand
Table 44.104. Positional Arguments
ValueSummary

<listener>

Listener to modify (name or id).

Expand
Table 44.105. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set the listener name.

--description <description>

Set the description of this listener.

--connection-limit <limit>

The maximum number of connections permitted for this listener. Default value is -1 which represents infinite connections.

--default-pool <pool>

The ID of the pool used by the listener if no L7 policies match.

--default-tls-container-ref <container-ref>

The URI to the key manager service secrets container containing the certificate and key for TERMINATED_TLSlisteners.

--sni-container-refs [<container-ref> [<container-ref> …​]]

A list of URIs to the key manager service secrets containers containing the certificates and keys for TERMINATED_TLS the listener using Server Name Indication.

--insert-headers <header=value>

A dictionary of optional headers to insert into the request before it is sent to the backend member.

--timeout-client-data <timeout>

Frontend client inactivity timeout in milliseconds. Default: 50000.

--timeout-member-connect <timeout>

Backend member connection timeout in milliseconds. Default: 5000.

--timeout-member-data <timeout>

Backend member inactivity timeout in milliseconds. Default: 50000.

--timeout-tcp-inspect <timeout>

Time, in milliseconds, to wait for additional TCP packets for content inspection. Default: 0.

--enable

Enable listener.

--disable

Disable listener.

This command is provided by the python-octaviaclient plugin.

44.26. loadbalancer listener show

Usage:

openstack loadbalancer listener show [-h]

                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent] [--prefix PREFIX]
                                          <listener>
Copy to Clipboard Toggle word wrap

Show the details of a single listener

Expand
Table 44.106. Positional Arguments
ValueSummary

<listener>

Name or uuid of the listener

Expand
Table 44.107. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.108. Output Formatters
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

Expand
Table 44.109. Table Formatter
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.

Expand
Table 44.110. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.111. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.27. loadbalancer listener stats show

Usage:

openstack loadbalancer listener stats show [-h]

                                                [-f {json,shell,table,value,yaml}]
                                                [-c COLUMN]
                                                [--max-width <integer>]
                                                [--fit-width]
                                                [--print-empty] [--noindent]
                                                [--prefix PREFIX]
                                                <listener>
Copy to Clipboard Toggle word wrap

Shows the current statistics for a listener.

Expand
Table 44.112. Positional Arguments
ValueSummary

<listener>

Name or uuid of the listener

Expand
Table 44.113. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.114. Output Formatters
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

Expand
Table 44.115. Table Formatter
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.

Expand
Table 44.116. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.117. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.28. loadbalancer member create

Usage:

openstack loadbalancer member create [-h]

                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--noindent] [--prefix PREFIX]
                                          [--name <name>]
                                          [--disable-backup | --enable-backup]
                                          [--weight <weight>] --address
                                          <ip_address>
                                          [--subnet-id <subnet_id>]
                                          --protocol-port <protocol_port>
                                          [--monitor-port <monitor_port>]
                                          [--monitor-address <monitor_address>]
                                          [--enable | --disable]
                                          <pool>
Copy to Clipboard Toggle word wrap

Creating a member in a pool

Expand
Table 44.118. Positional Arguments
ValueSummary

<pool>

Id or name of the pool to create the member for.

Expand
Table 44.119. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Name of the member.

--disable-backup

Disable member backup (default)

--enable-backup

Enable member backup

--weight <weight>

The weight of a member determines the portion of requests or connections it services compared to the other members of the pool.

--address <ip_address>

The IP address of the backend member server

--subnet-id <subnet_id>

The subnet ID the member service is accessible from.

--protocol-port <protocol_port>

The protocol port number the backend member server is listening on.

--monitor-port <monitor_port>

An alternate protocol port used for health monitoring a backend member.

--monitor-address <monitor_address>

An alternate IP address used for health monitoring a backend member.

--enable

Enable member (default)

--disable

Disable member

Expand
Table 44.120. Output Formatters
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

Expand
Table 44.121. Table Formatter
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.

Expand
Table 44.122. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.123. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.29. loadbalancer member delete

Usage:

openstack loadbalancer member delete [-h] <pool> <member>
Copy to Clipboard Toggle word wrap

Delete a member from a pool

Expand
Table 44.124. Positional Arguments
ValueSummary

<pool>

Pool name or id to delete the member from.

<member>

Name or id of the member to be deleted.

Expand
Table 44.125. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

44.30. loadbalancer member list

Usage:

openstack loadbalancer member list [-h]

                                        [-f {csv,json,table,value,yaml}]
                                        [-c COLUMN] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--noindent]
                                        [--quote {all,minimal,none,nonnumeric}]
                                        [--sort-column SORT_COLUMN]
                                        <pool>
Copy to Clipboard Toggle word wrap

List members in a pool

Expand
Table 44.126. Positional Arguments
ValueSummary

<pool>

Pool name or id to list the members of.

Expand
Table 44.127. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.128. Output Formatters
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

Expand
Table 44.129. Table Formatter
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.

Expand
Table 44.130. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.131. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.31. loadbalancer member set

Usage:

openstack loadbalancer member set [-h] [--name <name>]

                                       [--disable-backup | --enable-backup]
                                       [--weight <weight>]
                                       [--monitor-port <monitor_port>]
                                       [--monitor-address <monitor_address>]
                                       [--enable | --disable]
                                       <pool> <member>
Copy to Clipboard Toggle word wrap

Update a member

Expand
Table 44.132. Positional Arguments
ValueSummary

<pool>

Pool that the member to update belongs to (name or ID).

<member>

Name or id of the member to update

Expand
Table 44.133. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set the name of the member

--disable-backup

Disable member backup (default)

--enable-backup

Enable member backup

--weight <weight>

Set the weight of member in the pool

--monitor-port <monitor_port>

An alternate protocol port used for health monitoring a backend member

--monitor-address <monitor_address>

An alternate IP address used for health monitoring a backend member.

--enable

Set the admin_state_up to true

--disable

Set the admin_state_up to false

This command is provided by the python-octaviaclient plugin.

44.32. loadbalancer member show

Usage:

openstack loadbalancer member show [-h]

                                        [-f {json,shell,table,value,yaml}]
                                        [-c COLUMN] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--noindent] [--prefix PREFIX]
                                        <pool> <member>
Copy to Clipboard Toggle word wrap

Shows details of a single Member

Expand
Table 44.134. Positional Arguments
ValueSummary

<pool>

Pool name or id to show the members of.

<member>

Name or id of the member to show.

Expand
Table 44.135. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.136. Output Formatters
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

Expand
Table 44.137. Table Formatter
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.

Expand
Table 44.138. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.139. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.33. loadbalancer pool create

Usage:

openstack loadbalancer pool create [-h]

                                        [-f {json,shell,table,value,yaml}]
                                        [-c COLUMN] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--noindent] [--prefix PREFIX]
                                        [--name <name>]
                                        [--description <description>]
                                        --protocol
                                        {TCP,HTTP,HTTPS,TERMINATED_HTTPS,PROXY,UDP}
                                        (--listener <listener> | --loadbalancer <load_balancer>)
                                        [--session-persistence <session persistence>]
                                        --lb-algorithm
                                        {SOURCE_IP,ROUND_ROBIN,LEAST_CONNECTIONS}
                                        [--enable | --disable]
Copy to Clipboard Toggle word wrap

Create a pool

Expand
Table 44.140. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set pool name.

--description <description>

Set pool description.

--protocol {TCP,HTTP,HTTPS,TERMINATED_HTTPS,PROXY,UDP}

Set the pool protocol.

--listener <listener>

Listener to add the pool to (name or ID).

--loadbalancer <load_balancer>

Load balncer to add the pool to (name or ID)

--session-persistence <session persistence>

Set the session persistence for the listener (key=value).

--lb-algorithm {SOURCE_IP,ROUND_ROBIN,LEAST_CONNECTIONS}

Load balancing algorithm to use.

--enable

Enable pool (default).

--disable

Disable pool.

Expand
Table 44.141. Output Formatters
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

Expand
Table 44.142. Table Formatter
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.

Expand
Table 44.143. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.144. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.34. loadbalancer pool delete

Usage:

openstack loadbalancer pool delete [-h] <pool>
Copy to Clipboard Toggle word wrap

Delete a pool

Expand
Table 44.145. Positional Arguments
ValueSummary

<pool>

Pool to delete (name or id).

Expand
Table 44.146. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

44.35. loadbalancer pool list

Usage:

openstack loadbalancer pool list [-h] [-f {csv,json,table,value,yaml}]

                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent]
                                      [--quote {all,minimal,none,nonnumeric}]
                                      [--sort-column SORT_COLUMN]
                                      [--loadbalancer <loadbalancer>]
Copy to Clipboard Toggle word wrap

List pools

Expand
Table 44.147. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--loadbalancer <loadbalancer>

Filter by load balancer (name or ID).

Expand
Table 44.148. Output Formatters
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

Expand
Table 44.149. Table Formatter
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.

Expand
Table 44.150. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.151. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.36. loadbalancer pool set

Usage:

openstack loadbalancer pool set [-h] [--name <name>]

                                     [--description <description>]
                                     [--session-persistence <session_persistence>]
                                     [--lb-algorithm {SOURCE_IP,ROUND_ROBIN,LEAST_CONNECTIONS}]
                                     [--enable | --disable]
                                     <pool>
Copy to Clipboard Toggle word wrap

Update a pool

Expand
Table 44.152. Positional Arguments
ValueSummary

<pool>

Pool to update (name or id).

Expand
Table 44.153. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set the name of the pool.

--description <description>

Set the description of the pool.

--session-persistence <session_persistence>

Set the session persistence for the listener (key=value).

--lb-algorithm {SOURCE_IP,ROUND_ROBIN,LEAST_CONNECTIONS}

Set the load balancing algorithm to use.

--enable

Enable pool.

--disable

Disable pool.

This command is provided by the python-octaviaclient plugin.

44.37. loadbalancer pool show

Usage:

openstack loadbalancer pool show [-h]

                                      [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent] [--prefix PREFIX]
                                      <pool>
Copy to Clipboard Toggle word wrap

Show the details of a single pool

Expand
Table 44.154. Positional Arguments
ValueSummary

<pool>

Name or uuid of the pool.

Expand
Table 44.155. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.156. Output Formatters
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

Expand
Table 44.157. Table Formatter
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.

Expand
Table 44.158. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.159. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.38. loadbalancer quota defaults show

Usage:

openstack loadbalancer quota defaults show [-h]

                                                [-f {json,shell,table,value,yaml}]
                                                [-c COLUMN]
                                                [--max-width <integer>]
                                                [--fit-width]
                                                [--print-empty] [--noindent]
                                                [--prefix PREFIX]
Copy to Clipboard Toggle word wrap

Show quota defaults

Expand
Table 44.160. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.161. Output Formatters
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

Expand
Table 44.162. Table Formatter
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.

Expand
Table 44.163. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.164. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.39. loadbalancer quota list

Usage:

openstack loadbalancer quota list [-h] [-f {csv,json,table,value,yaml}]

                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent]
                                       [--quote {all,minimal,none,nonnumeric}]
                                       [--sort-column SORT_COLUMN]
                                       [--project <project-id>]
Copy to Clipboard Toggle word wrap

List quotas

Expand
Table 44.165. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--project <project-id>

Name or UUID of the project.

Expand
Table 44.166. Output Formatters
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

Expand
Table 44.167. Table Formatter
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.

Expand
Table 44.168. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.169. CSV Formatter
ValueSummary

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

when to include quotes, defaults to nonnumeric

This command is provided by the python-octaviaclient plugin.

44.40. loadbalancer quota reset

Usage:

openstack loadbalancer quota reset [-h] <project>
Copy to Clipboard Toggle word wrap

Resets quotas to default quotas

Expand
Table 44.170. Positional Arguments
ValueSummary

<project>

Project to reset quotas (name or id)

Expand
Table 44.171. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

44.41. loadbalancer quota set

Usage:

openstack loadbalancer quota set [-h]

                                      [-f {json,shell,table,value,yaml}]
                                      [-c COLUMN] [--max-width <integer>]
                                      [--fit-width] [--print-empty]
                                      [--noindent] [--prefix PREFIX]
                                      [--healthmonitor <health_monitor>]
                                      [--listener <listener>]
                                      [--loadbalancer <load_balancer>]
                                      [--member <member>] [--pool <pool>]
                                      <project>
Copy to Clipboard Toggle word wrap

Update a quota

Expand
Table 44.172. Positional Arguments
ValueSummary

<project>

Name or uuid of the project.

Expand
Table 44.173. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.174. Output Formatters
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

Expand
Table 44.175. Table Formatter
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.

Expand
Table 44.176. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.177. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Expand
Table 44.178. Quota limits
ValueSummary

--healthmonitor <health_monitor>

New value for the health monitor quota. Value -1 means unlimited.

--listener <listener>

New value for the listener quota. Value -1 means unlimited.

--loadbalancer <load_balancer>

New value for the load balancer quota limit. Value -1 means unlimited.

--member <member>

New value for the member quota limit. value -1 means unlimited.

--pool <pool>

New value for the pool quota limit. value -1 means unlimited.

This command is provided by the python-octaviaclient plugin.

44.42. loadbalancer quota show

Usage:

openstack loadbalancer quota show [-h]

                                       [-f {json,shell,table,value,yaml}]
                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent] [--prefix PREFIX]
                                       <project>
Copy to Clipboard Toggle word wrap

Show the quota details for a project

Expand
Table 44.179. Positional Arguments
ValueSummary

<project>

Name or uuid of the project.

Expand
Table 44.180. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.181. Output Formatters
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

Expand
Table 44.182. Table Formatter
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.

Expand
Table 44.183. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.184. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.43. loadbalancer set

Usage:

openstack loadbalancer set [-h] [--name <name>]

                                [--description <description>]
                                [--vip-qos-policy-id <vip_qos_policy_id>]
                                [--enable | --disable]
                                <load_balancer>
Copy to Clipboard Toggle word wrap

Update a load balancer

Expand
Table 44.185. Positional Arguments
ValueSummary

<load_balancer>

Name or uuid of the load balancer to update.

Expand
Table 44.186. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set load balancer name.

--description <description>

Set load balancer description.

--vip-qos-policy-id <vip_qos_policy_id>

Set QoS policy ID for VIP port. Unset with 'None'.

--enable

Enable load balancer.

--disable

Disable load balancer.

This command is provided by the python-octaviaclient plugin.

44.44. loadbalancer show

Usage:

openstack loadbalancer show [-h] [-f {json,shell,table,value,yaml}]

                                 [-c COLUMN] [--max-width <integer>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--prefix PREFIX]
                                 <load_balancer>
Copy to Clipboard Toggle word wrap

Show the details for a single load balancer

Expand
Table 44.187. Positional Arguments
ValueSummary

<load_balancer>

Name or uuid of the load balancer.

Expand
Table 44.188. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.189. Output Formatters
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

Expand
Table 44.190. Table Formatter
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.

Expand
Table 44.191. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.192. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.45. loadbalancer stats show

Usage:

openstack loadbalancer stats show [-h]

                                       [-f {json,shell,table,value,yaml}]
                                       [-c COLUMN] [--max-width <integer>]
                                       [--fit-width] [--print-empty]
                                       [--noindent] [--prefix PREFIX]
                                       <load_balancer>
Copy to Clipboard Toggle word wrap

Shows the current statistics for a load balancer

Expand
Table 44.193. Positional Arguments
ValueSummary

<load_balancer>

Name or uuid of the load balancer.

Expand
Table 44.194. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 44.195. Output Formatters
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

Expand
Table 44.196. Table Formatter
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.

Expand
Table 44.197. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 44.198. shell formatter
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

This command is provided by the python-octaviaclient plugin.

44.46. loadbalancer status show

Usage:

openstack loadbalancer status show [-h] <load_balancer>
Copy to Clipboard Toggle word wrap

Display load balancer status tree in json format

Expand
Table 44.199. Positional Arguments
ValueSummary

<load_balancer>

Name or uuid of the load balancer.

Expand
Table 44.200. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

This command is provided by the python-octaviaclient plugin.

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat