Chapter 49. loadbalancer


This chapter describes the commands under the loadbalancer command.

49.1. loadbalancer amphora configure

Update the amphora agent configuration

Usage:

openstack loadbalancer amphora configure [-h] [--wait] <amphora-id>

Table 49.1. Positional arguments
ValueSummary

<amphora-id>

Uuid of the amphora to configure.

Table 49.2. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for action to complete

49.2. loadbalancer amphora delete

Delete a amphora

Usage:

openstack loadbalancer amphora delete [-h] [--wait] <amphora-id>

Table 49.3. Positional arguments
ValueSummary

<amphora-id>

Uuid of the amphora to delete.

Table 49.4. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for action to complete

49.3. loadbalancer amphora failover

Force failover an amphora

Usage:

openstack loadbalancer amphora failover [-h] [--wait] <amphora-id>

Table 49.5. Positional arguments
ValueSummary

<amphora-id>

Uuid of the amphora.

Table 49.6. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for action to complete

49.4. loadbalancer amphora list

List amphorae

Usage:

openstack loadbalancer amphora list [-h]
                                           [-f {csv,json,table,value,yaml}]
                                           [-c COLUMN]
                                           [--quote {all,minimal,none,nonnumeric}]
                                           [--noindent]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           [--sort-column SORT_COLUMN]
                                           [--sort-ascending | --sort-descending]
                                           [--loadbalancer <loadbalancer>]
                                           [--compute-id <compute-id>]
                                           [--role {BACKUP,MASTER,STANDALONE}]
                                           [--status {ALLOCATED,BOOTING,DELETED,ERROR,PENDING_CREATE,PENDING_DELETE,READY}]
                                           [--long]

Table 49.7. Command 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 {BACKUP,MASTER,STANDALONE}

Filter by role.

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

Filter by amphora provisioning status.

--long

Show additional fields.

Table 49.8. 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 to show multiple columns

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

Sort the column(s) in ascending order

--sort-descending

Sort the column(s) in descending order

Table 49.9. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 49.10. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.11. 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.

49.5. loadbalancer amphora show

Show the details of a single amphora

Usage:

openstack loadbalancer amphora show [-h]
                                           [-f {json,shell,table,value,yaml}]
                                           [-c COLUMN] [--noindent]
                                           [--prefix PREFIX]
                                           [--max-width <integer>]
                                           [--fit-width] [--print-empty]
                                           <amphora-id>

Table 49.12. Positional arguments
ValueSummary

<amphora-id>

Uuid of the amphora.

Table 49.13. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.14. 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 to show multiple columns

Table 49.15. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.16. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.17. 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.

49.6. loadbalancer amphora stats show

Shows the current statistics for an amphora.

Usage:

openstack loadbalancer amphora stats show [-h]
                                                 [-f {json,shell,table,value,yaml}]
                                                 [-c COLUMN] [--noindent]
                                                 [--prefix PREFIX]
                                                 [--max-width <integer>]
                                                 [--fit-width] [--print-empty]
                                                 [--listener <listener>]
                                                 <amphora-id>

Table 49.18. Positional arguments
ValueSummary

<amphora-id>

Uuid of the amphora

Table 49.19. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--listener <listener>

Filter by listener (name or id)

Table 49.20. 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 to show multiple columns

Table 49.21. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.22. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.23. 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.

49.7. loadbalancer availabilityzone create

Create an octavia availability zone

Usage:

openstack loadbalancer availabilityzone create [-h]
                                                      [-f {json,shell,table,value,yaml}]
                                                      [-c COLUMN] [--noindent]
                                                      [--prefix PREFIX]
                                                      [--max-width <integer>]
                                                      [--fit-width]
                                                      [--print-empty] --name
                                                      <name>
                                                      --availabilityzoneprofile
                                                      <availabilityzone_profile>
                                                      [--description <description>]
                                                      [--enable | --disable]

Table 49.24. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New availability zone name.

--availabilityzoneprofile <availabilityzone_profile>

Availability zone profile to add the az to (name or ID).

--description <description>

Set the availability zone description.

--enable

Enable the availability zone.

--disable

Disable the availability zone.

Table 49.25. 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 to show multiple columns

Table 49.26. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.27. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.28. 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.

49.8. loadbalancer availabilityzone delete

Delete an availability zone

Usage:

openstack loadbalancer availabilityzone delete [-h] <availabilityzone>

Table 49.29. Positional arguments
ValueSummary

<availabilityzone>

Name of the availability zone to delete.

Table 49.30. Command arguments
ValueSummary

-h, --help

Show this help message and exit

49.9. loadbalancer availabilityzone list

List availability zones

Usage:

openstack loadbalancer availabilityzone list [-h]
                                                    [-f {csv,json,table,value,yaml}]
                                                    [-c COLUMN]
                                                    [--quote {all,minimal,none,nonnumeric}]
                                                    [--noindent]
                                                    [--max-width <integer>]
                                                    [--fit-width]
                                                    [--print-empty]
                                                    [--sort-column SORT_COLUMN]
                                                    [--sort-ascending | --sort-descending]
                                                    [--name <name>]
                                                    [--availabilityzoneprofile <availabilityzone_profile>]
                                                    [--enable | --disable]

Table 49.31. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

List availability zones according to their name.

--availabilityzoneprofile <availabilityzone_profile>

List availability zones according to their az profile.

--enable

List enabled availability zones.

--disable

List disabled availability zones.

Table 49.32. 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 to show multiple columns

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

Sort the column(s) in ascending order

--sort-descending

Sort the column(s) in descending order

Table 49.33. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 49.34. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.35. 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.

49.10. loadbalancer availabilityzone set

Update an availability zone

Usage:

openstack loadbalancer availabilityzone set [-h]
                                                   [--description <description>]
                                                   [--enable | --disable]
                                                   <availabilityzone>

Table 49.36. Positional arguments
ValueSummary

<availabilityzone>

Name of the availability zone to update.

Table 49.37. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--description <description>

Set the description of the availability zone.

--enable

Enable the availability zone.

--disable

Disable the availability zone.

49.11. loadbalancer availabilityzone show

Show the details for a single availability zone

Usage:

openstack loadbalancer availabilityzone show [-h]
                                                    [-f {json,shell,table,value,yaml}]
                                                    [-c COLUMN] [--noindent]
                                                    [--prefix PREFIX]
                                                    [--max-width <integer>]
                                                    [--fit-width]
                                                    [--print-empty]
                                                    <availabilityzone>

Table 49.38. Positional arguments
ValueSummary

<availabilityzone>

Name of the availability zone.

Table 49.39. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.40. 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 to show multiple columns

Table 49.41. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.42. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.43. 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.

49.12. loadbalancer availabilityzone unset

Clear availability zone settings

Usage:

openstack loadbalancer availabilityzone unset [-h] [--description]
                                                     <availabilityzone>

Table 49.44. Positional arguments
ValueSummary

<availabilityzone>

Name of the availability zone to update.

Table 49.45. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--description

Clear the availability zone description.

49.13. loadbalancer availabilityzoneprofile create

Create an octavia availability zone profile

Usage:

openstack loadbalancer availabilityzoneprofile create
       [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--noindent]
       [--prefix PREFIX] [--max-width <integer>] [--fit-width] [--print-empty]
       --name <name> --provider <provider name> --availability-zone-data
       <availability_zone_data>

Table 49.46. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New octavia availability zone profile name.

--provider <provider name>

Provider name for the availability zone profile.

--availability-zone-data <availability_zone_data>

The json string containing the availability zone metadata.

Table 49.47. 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 to show multiple columns

Table 49.48. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.49. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.50. 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.

49.14. loadbalancer availabilityzoneprofile delete

Delete an availability zone profile

Usage:

openstack loadbalancer availabilityzoneprofile delete
       [-h] <availabilityzone_profile>

Table 49.51. Positional arguments
ValueSummary

<availabilityzone_profile>

Availability zone profile to delete (name or id)

Table 49.52. Command arguments
ValueSummary

-h, --help

Show this help message and exit

49.15. loadbalancer availabilityzoneprofile list

List availability zone profiles

Usage:

openstack loadbalancer availabilityzoneprofile list [-h]
                                                           [-f {csv,json,table,value,yaml}]
                                                           [-c COLUMN]
                                                           [--quote {all,minimal,none,nonnumeric}]
                                                           [--noindent]
                                                           [--max-width <integer>]
                                                           [--fit-width]
                                                           [--print-empty]
                                                           [--sort-column SORT_COLUMN]
                                                           [--sort-ascending | --sort-descending]
                                                           [--name <name>]
                                                           [--provider <provider_name>]

Table 49.53. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

List availabilityzone profiles by profile name.

--provider <provider_name>

List availability zone profiles according to their provider.

Table 49.54. 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 to show multiple columns

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

Sort the column(s) in ascending order

--sort-descending

Sort the column(s) in descending order

Table 49.55. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 49.56. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.57. 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.

49.16. loadbalancer availabilityzoneprofile set

Update an availability zone profile

Usage:

openstack loadbalancer availabilityzoneprofile set [-h] [--name <name>]
                                                          [--provider <provider_name>]
                                                          [--availabilityzone-data <availabilityzone_data>]
                                                          <availabilityzone_profile>

Table 49.58. Positional arguments
ValueSummary

<availabilityzone_profile>

Name or uuid of the availability zone profile to update.

Table 49.59. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set the name of the availability zone profile.

--provider <provider_name>

Set the provider of the availability zone profile.

--availabilityzone-data <availabilityzone_data>

Set the availability zone data of the profile.

49.17. loadbalancer availabilityzoneprofile show

Show the details of a single availability zone profile

Usage:

openstack loadbalancer availabilityzoneprofile show [-h]
                                                           [-f {json,shell,table,value,yaml}]
                                                           [-c COLUMN]
                                                           [--noindent]
                                                           [--prefix PREFIX]
                                                           [--max-width <integer>]
                                                           [--fit-width]
                                                           [--print-empty]
                                                           <availabilityzone_profile>

Table 49.60. Positional arguments
ValueSummary

<availabilityzone_profile>

Name or uuid of the availability zone profile to show.

Table 49.61. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.62. 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 to show multiple columns

Table 49.63. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.64. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.65. 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.

49.18. loadbalancer create

Create a load balancer

Usage:

openstack loadbalancer create [-h] [-f {json,shell,table,value,yaml}]
                                     [-c COLUMN] [--noindent]
                                     [--prefix PREFIX] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     [--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>]
                                     [--provider <provider>]
                                     [--availability-zone <availability_zone>]
                                     [--enable | --disable]
                                     [--flavor <flavor>] [--wait]
                                     [--tag <tag> | --no-tag]

Table 49.66. Command 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).

--provider <provider>

Provider name for the load balancer.

--availability-zone <availability_zone>

Availability zone for the load balancer.

--enable

Enable load balancer (default).

--disable

Disable load balancer.

--flavor <flavor>

The name or id of the flavor for the load balancer.

--wait

Wait for action to complete

--tag <tag>

Tag to be added to the load balancer (repeat option to set multiple tags)

--no-tag

No tags associated with the load balancer

Table 49.67. 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 to show multiple columns

Table 49.68. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.69. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.70. 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.

Table 49.71. VIP Network
ValueSummary

At least one of the following arguments is required.--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).

49.19. loadbalancer delete

Delete a load balancer

Usage:

openstack loadbalancer delete [-h] [--cascade] [--wait] <load_balancer>

Table 49.72. Positional arguments
ValueSummary

<load_balancer>

Load balancers to delete (name or id)

Table 49.73. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--cascade

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

--wait

Wait for action to complete

49.20. loadbalancer failover

Trigger load balancer failover

Usage:

openstack loadbalancer failover [-h] [--wait] <load_balancer>

Table 49.74. Positional arguments
ValueSummary

<load_balancer>

Name or uuid of the load balancer.

Table 49.75. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for action to complete

49.21. loadbalancer flavor create

Create a octavia flavor

Usage:

openstack loadbalancer flavor create [-h]
                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN] [--noindent]
                                            [--prefix PREFIX]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            --name <name> --flavorprofile
                                            <flavor_profile>
                                            [--description <description>]
                                            [--enable | --disable]

Table 49.76. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New flavor name.

--flavorprofile <flavor_profile>

Flavor profile to add the flavor to (name or id).

--description <description>

Set flavor description.

--enable

Enable flavor.

--disable

Disable flavor.

Table 49.77. 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 to show multiple columns

Table 49.78. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.79. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.80. 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.

49.22. loadbalancer flavor delete

Delete a flavor

Usage:

openstack loadbalancer flavor delete [-h] <flavor>

Table 49.81. Positional arguments
ValueSummary

<flavor>

Flavor to delete (name or id)

Table 49.82. Command arguments
ValueSummary

-h, --help

Show this help message and exit

49.23. loadbalancer flavor list

List flavor

Usage:

openstack loadbalancer flavor list [-h]
                                          [-f {csv,json,table,value,yaml}]
                                          [-c COLUMN]
                                          [--quote {all,minimal,none,nonnumeric}]
                                          [--noindent] [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--sort-column SORT_COLUMN]
                                          [--sort-ascending | --sort-descending]
                                          [--name <name>]
                                          [--flavorprofile <flavor_profile>]
                                          [--enable | --disable]

Table 49.83. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

List flavors according to their name.

--flavorprofile <flavor_profile>

List flavors according to their flavor profile.

--enable

List enabled flavors.

--disable

List disabled flavors.

Table 49.84. 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 to show multiple columns

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

Sort the column(s) in ascending order

--sort-descending

Sort the column(s) in descending order

Table 49.85. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 49.86. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.87. 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.

49.24. loadbalancer flavor set

Update a flavor

Usage:

openstack loadbalancer flavor set [-h] [--name <name>]
                                         [--enable | --disable]
                                         <flavor>

Table 49.88. Positional arguments
ValueSummary

<flavor>

Name or uuid of the flavor to update.

Table 49.89. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set the name of the flavor.

--enable

Enable flavor.

--disable

Disable flavor.

49.25. loadbalancer flavor show

Show the details for a single flavor

Usage:

openstack loadbalancer flavor show [-h]
                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN] [--noindent]
                                          [--prefix PREFIX]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          <flavor>

Table 49.90. Positional arguments
ValueSummary

<flavor>

Name or uuid of the flavor.

Table 49.91. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.92. 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 to show multiple columns

Table 49.93. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.94. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.95. 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.

49.26. loadbalancer flavor unset

Clear flavor settings

Usage:

openstack loadbalancer flavor unset [-h] [--description] <flavor>

Table 49.96. Positional arguments
ValueSummary

<flavor>

Flavor to update (name or id).

Table 49.97. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--description

Clear the flavor description.

49.27. loadbalancer flavorprofile create

Create a octavia flavor profile

Usage:

openstack loadbalancer flavorprofile create [-h]
                                                   [-f {json,shell,table,value,yaml}]
                                                   [-c COLUMN] [--noindent]
                                                   [--prefix PREFIX]
                                                   [--max-width <integer>]
                                                   [--fit-width]
                                                   [--print-empty] --name
                                                   <name> --provider <provider
                                                   name> --flavor-data
                                                   <flavor_data>

Table 49.98. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New octavia flavor profile name.

--provider <provider name>

Provider name for the flavor profile.

--flavor-data <flavor_data>

The json string containing the flavor metadata.

Table 49.99. 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 to show multiple columns

Table 49.100. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.101. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.102. 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.

49.28. loadbalancer flavorprofile delete

Delete a flavor profile

Usage:

openstack loadbalancer flavorprofile delete [-h] <flavor_profile>

Table 49.103. Positional arguments
ValueSummary

<flavor_profile>

Flavor profiles to delete (name or id)

Table 49.104. Command arguments
ValueSummary

-h, --help

Show this help message and exit

49.29. loadbalancer flavorprofile list

List flavor profile

Usage:

openstack loadbalancer flavorprofile list [-h]
                                                 [-f {csv,json,table,value,yaml}]
                                                 [-c COLUMN]
                                                 [--quote {all,minimal,none,nonnumeric}]
                                                 [--noindent]
                                                 [--max-width <integer>]
                                                 [--fit-width] [--print-empty]
                                                 [--sort-column SORT_COLUMN]
                                                 [--sort-ascending | --sort-descending]
                                                 [--name <name>]
                                                 [--provider <provider_name>]

Table 49.105. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

List flavor profiles by flavor profile name.

--provider <provider_name>

List flavor profiles according to their provider.

Table 49.106. 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 to show multiple columns

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

Sort the column(s) in ascending order

--sort-descending

Sort the column(s) in descending order

Table 49.107. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 49.108. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.109. 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.

49.30. loadbalancer flavorprofile set

Update a flavor profile

Usage:

openstack loadbalancer flavorprofile set [-h] [--name <name>]
                                                [--provider <provider_name>]
                                                [--flavor-data <flavor_data>]
                                                <flavor_profile>

Table 49.110. Positional arguments
ValueSummary

<flavor_profile>

Name or uuid of the flavor profile to update.

Table 49.111. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

Set the name of the flavor profile.

--provider <provider_name>

Set the provider of the flavor profile.

--flavor-data <flavor_data>

Set the flavor data of the flavor profile.

49.31. loadbalancer flavorprofile show

Show the details for a single flavor profile

Usage:

openstack loadbalancer flavorprofile show [-h]
                                                 [-f {json,shell,table,value,yaml}]
                                                 [-c COLUMN] [--noindent]
                                                 [--prefix PREFIX]
                                                 [--max-width <integer>]
                                                 [--fit-width] [--print-empty]
                                                 <flavor_profile>

Table 49.112. Positional arguments
ValueSummary

<flavor_profile>

Name or uuid of the flavor profile to show.

Table 49.113. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.114. 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 to show multiple columns

Table 49.115. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.116. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.117. 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.

49.32. loadbalancer healthmonitor create

Create a health monitor

Usage:

openstack loadbalancer healthmonitor create [-h]
                                                   [-f {json,shell,table,value,yaml}]
                                                   [-c COLUMN] [--noindent]
                                                   [--prefix PREFIX]
                                                   [--max-width <integer>]
                                                   [--fit-width]
                                                   [--print-empty]
                                                   [--name <name>] --delay
                                                   <delay>
                                                   [--domain-name <domain_name>]
                                                   [--expected-codes <codes>]
                                                   [--http-method {GET,POST,DELETE,PUT,HEAD,OPTIONS,PATCH,CONNECT,TRACE}]
                                                   [--http-version <http_version>]
                                                   --timeout <timeout>
                                                   --max-retries <max_retries>
                                                   [--url-path <url_path>]
                                                   --type
                                                   {PING,HTTP,TCP,HTTPS,TLS-HELLO,UDP-CONNECT,SCTP}
                                                   [--max-retries-down <max_retries_down>]
                                                   [--enable | --disable]
                                                   [--wait]
                                                   [--tag <tag> | --no-tag]
                                                   <pool>

Table 49.118. Positional arguments
ValueSummary

<pool>

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

Table 49.119. Command 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.

--domain-name <domain_name>

Set the domain name, which be injected into the http Host Header to the backend server for HTTP health check.

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

--http-version <http_version>

Set the http version.

--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,SCTP}

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.

--wait

Wait for action to complete

--tag <tag>

Tag to be added to the health monitor (repeat option to set multiple tags)

--no-tag

No tags associated with the health monitor

Table 49.120. 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 to show multiple columns

Table 49.121. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.122. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.123. 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.

49.33. loadbalancer healthmonitor delete

Delete a health monitor

Usage:

openstack loadbalancer healthmonitor delete [-h] [--wait]
                                                   <health_monitor>

Table 49.124. Positional arguments
ValueSummary

<health_monitor>

Health monitor to delete (name or id).

Table 49.125. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for action to complete

49.34. loadbalancer healthmonitor list

List health monitors

Usage:

openstack loadbalancer healthmonitor list [-h]
                                                 [-f {csv,json,table,value,yaml}]
                                                 [-c COLUMN]
                                                 [--quote {all,minimal,none,nonnumeric}]
                                                 [--noindent]
                                                 [--max-width <integer>]
                                                 [--fit-width] [--print-empty]
                                                 [--sort-column SORT_COLUMN]
                                                 [--sort-ascending | --sort-descending]
                                                 [--tags <tag>[,<tag>,...]]
                                                 [--any-tags <tag>[,<tag>,...]]
                                                 [--not-tags <tag>[,<tag>,...]]
                                                 [--not-any-tags <tag>[,<tag>,...]]

Table 49.126. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--tags <tag>[,<tag>,…​]

List health monitor which have all given tag(s) (Comma-separated list of tags)

--any-tags <tag>[,<tag>,…​]

List health monitor which have any given tag(s) (Comma-separated list of tags)

--not-tags <tag>[,<tag>,…​]

Exclude health monitor which have all given tag(s) (Comma-separated list of tags)

--not-any-tags <tag>[,<tag>,…​]

Exclude health monitor which have any given tag(s) (Comma-separated list of tags)

Table 49.127. 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 to show multiple columns

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

Sort the column(s) in ascending order

--sort-descending

Sort the column(s) in descending order

Table 49.128. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 49.129. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.130. 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.

49.35. loadbalancer healthmonitor set

Update a health monitor

Usage:

openstack loadbalancer healthmonitor set [-h] [--name <name>]
                                                [--delay <delay>]
                                                [--domain-name <domain_name>]
                                                [--expected-codes <codes>]
                                                [--http-method {GET,POST,DELETE,PUT,HEAD,OPTIONS,PATCH,CONNECT,TRACE}]
                                                [--http-version <http_version>]
                                                [--timeout <timeout>]
                                                [--max-retries <max_retries>]
                                                [--max-retries-down <max_retries_down>]
                                                [--url-path <url_path>]
                                                [--enable | --disable]
                                                [--wait] [--tag <tag>]
                                                [--no-tag]
                                                <health_monitor>

Table 49.131. Positional arguments
ValueSummary

<health_monitor>

Health monitor to update (name or id).

Table 49.132. Command 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.

--domain-name <domain_name>

Set the domain name, which be injected into the http Host Header to the backend server for HTTP health check.

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

--http-version <http_version>

Set the http version.

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

--wait

Wait for action to complete

--tag <tag>

Tag to be added to the health monitor (repeat option to set multiple tags)

--no-tag

Clear tags associated with the health monitor. specify both --tag and --no-tag to overwrite current tags

49.36. loadbalancer healthmonitor show

Show the details of a single health monitor

Usage:

openstack loadbalancer healthmonitor show [-h]
                                                 [-f {json,shell,table,value,yaml}]
                                                 [-c COLUMN] [--noindent]
                                                 [--prefix PREFIX]
                                                 [--max-width <integer>]
                                                 [--fit-width] [--print-empty]
                                                 <health_monitor>

Table 49.133. Positional arguments
ValueSummary

<health_monitor>

Name or uuid of the health monitor.

Table 49.134. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.135. 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 to show multiple columns

Table 49.136. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.137. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.138. 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.

49.37. loadbalancer healthmonitor unset

Clear health monitor settings

Usage:

openstack loadbalancer healthmonitor unset [-h] [--domain-name]
                                                  [--expected-codes]
                                                  [--http-method]
                                                  [--http-version]
                                                  [--max-retries-down]
                                                  [--name] [--url-path]
                                                  [--wait]
                                                  [--tag <tag> | --all-tag]
                                                  <health_monitor>

Table 49.139. Positional arguments
ValueSummary

<health_monitor>

Health monitor to update (name or id).

Table 49.140. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--domain-name

Clear the health monitor domain name.

--expected-codes

Reset the health monitor expected codes to the api default.

--http-method

Reset the health monitor http method to the api default.

--http-version

Reset the health monitor http version to the api default.

--max-retries-down

Reset the health monitor max retries down to the api default.

--name

Clear the health monitor name.

--url-path

Clear the health monitor url path.

--wait

Wait for action to complete

--tag <tag>

Tag to be removed from the health monitor (repeat option to remove multiple tags)

--all-tag

Clear all tags associated with the health monitor

49.38. loadbalancer l7policy create

Create a l7policy

Usage:

openstack loadbalancer l7policy create [-h]
                                              [-f {json,shell,table,value,yaml}]
                                              [-c COLUMN] [--noindent]
                                              [--prefix PREFIX]
                                              [--max-width <integer>]
                                              [--fit-width] [--print-empty]
                                              [--name <name>]
                                              [--description <description>]
                                              --action
                                              {REDIRECT_TO_URL,REDIRECT_TO_POOL,REDIRECT_PREFIX,REJECT}
                                              [--redirect-pool <pool> | --redirect-url <url> | --redirect-prefix <url>]
                                              [--redirect-http-code <redirect_http_code>]
                                              [--position <position>]
                                              [--enable | --disable] [--wait]
                                              [--tag <tag> | --no-tag]
                                              <listener>

Table 49.141. Positional arguments
ValueSummary

<listener>

Listener to add l7policy to (name or id).

Table 49.142. Command 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,REDIRECT_PREFIX,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.

--redirect-prefix <url>

Set the url prefix to redirect requests to.

--redirect-http-code <redirect_http_code>

Set the http response code for redirect_url orREDIRECT_PREFIX action.

--position <position>

Sequence number of this l7 policy.

--enable

Enable l7policy (default).

--disable

Disable l7policy.

--wait

Wait for action to complete

--tag <tag>

Tag to be added to the l7policy (repeat option to set multiple tags)

--no-tag

No tags associated with the l7policy

Table 49.143. 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 to show multiple columns

Table 49.144. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.145. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.146. 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.

49.39. loadbalancer l7policy delete

Delete a l7policy

Usage:

openstack loadbalancer l7policy delete [-h] [--wait] <policy>

Table 49.147. Positional arguments
ValueSummary

<policy>

L7policy to delete (name or id).

Table 49.148. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for action to complete

49.40. loadbalancer l7policy list

List l7policies

Usage:

openstack loadbalancer l7policy list [-h]
                                            [-f {csv,json,table,value,yaml}]
                                            [-c COLUMN]
                                            [--quote {all,minimal,none,nonnumeric}]
                                            [--noindent]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--sort-column SORT_COLUMN]
                                            [--sort-ascending | --sort-descending]
                                            [--listener LISTENER]
                                            [--tags <tag>[,<tag>,...]]
                                            [--any-tags <tag>[,<tag>,...]]
                                            [--not-tags <tag>[,<tag>,...]]
                                            [--not-any-tags <tag>[,<tag>,...]]

Table 49.149. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--listener LISTENER

List l7policies that applied to the given listener (name or ID).

--tags <tag>[,<tag>,…​]

List l7policy which have all given tag(s) (comma- separated list of tags)

--any-tags <tag>[,<tag>,…​]

List l7policy which have any given tag(s) (comma- separated list of tags)

--not-tags <tag>[,<tag>,…​]

Exclude l7policy which have all given tag(s) (comma- separated list of tags)

--not-any-tags <tag>[,<tag>,…​]

Exclude l7policy which have any given tag(s) (comma- separated list of tags)

Table 49.150. 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 to show multiple columns

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

Sort the column(s) in ascending order

--sort-descending

Sort the column(s) in descending order

Table 49.151. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 49.152. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.153. 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.

49.41. loadbalancer l7policy set

Update a l7policy

Usage:

openstack loadbalancer l7policy set [-h] [--name <name>]
                                           [--description <description>]
                                           [--action {REDIRECT_TO_URL,REDIRECT_TO_POOL,REDIRECT_PREFIX,REJECT}]
                                           [--redirect-pool <pool> | --redirect-url <url> | --redirect-prefix <url>]
                                           [--redirect-http-code <redirect_http_code>]
                                           [--position <position>]
                                           [--enable | --disable] [--wait]
                                           [--tag <tag>] [--no-tag]
                                           <policy>

Table 49.154. Positional arguments
ValueSummary

<policy>

L7policy to update (name or id).

Table 49.155. Command 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,REDIRECT_PREFIX,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.

--redirect-prefix <url>

Set the url prefix to redirect requests to.

--redirect-http-code <redirect_http_code>

Set the http response code for redirect_url orREDIRECT_PREFIX action.

--position <position>

Set sequence number of this l7 policy.

--enable

Enable l7policy.

--disable

Disable l7policy.

--wait

Wait for action to complete

--tag <tag>

Tag to be added to the l7policy (repeat option to set multiple tags)

--no-tag

Clear tags associated with the l7policy. specify both --tag and --no-tag to overwrite current tags

49.42. loadbalancer l7policy show

Show the details of a single l7policy

Usage:

openstack loadbalancer l7policy show [-h]
                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN] [--noindent]
                                            [--prefix PREFIX]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            <policy>

Table 49.156. Positional arguments
ValueSummary

<policy>

Name or uuid of the l7policy.

Table 49.157. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.158. 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 to show multiple columns

Table 49.159. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.160. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.161. 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.

49.43. loadbalancer l7policy unset

Clear l7policy settings

Usage:

openstack loadbalancer l7policy unset [-h] [--description] [--name]
                                             [--redirect-http-code] [--wait]
                                             [--tag <tag> | --all-tag]
                                             <policy>

Table 49.162. Positional arguments
ValueSummary

<policy>

L7policy to update (name or id).

Table 49.163. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--description

Clear the l7policy description.

--name

Clear the l7policy name.

--redirect-http-code

Clear the l7policy redirect http code.

--wait

Wait for action to complete

--tag <tag>

Tag to be removed from the l7policy (repeat option to remove multiple tags)

--all-tag

Clear all tags associated with the l7policy

49.44. loadbalancer l7rule create

Create a l7rule

Usage:

openstack loadbalancer l7rule create [-h]
                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN] [--noindent]
                                            [--prefix PREFIX]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            --compare-type
                                            {REGEX,EQUAL_TO,CONTAINS,ENDS_WITH,STARTS_WITH}
                                            [--invert] --value <value>
                                            [--key <key>] --type
                                            {FILE_TYPE,PATH,COOKIE,HOST_NAME,HEADER,SSL_CONN_HAS_CERT,SSL_VERIFY_RESULT,SSL_DN_FIELD}
                                            [--enable | --disable] [--wait]
                                            [--tag <tag> | --no-tag]
                                            <l7policy>

Table 49.164. Positional arguments
ValueSummary

<l7policy>

L7policy to add l7rule to (name or id).

Table 49.165. Command 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,SSL_CONN_HAS_CERT,SSL_VERIFY_RESULT,SSL_DN_FIELD}

Set the type for the l7rule.

--enable

Enable l7rule (default).

--disable

Disable l7rule.

--wait

Wait for action to complete

--tag <tag>

Tag to be added to the l7rule (repeat option to set multiple tags)

--no-tag

No tags associated with the l7rule

Table 49.166. 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 to show multiple columns

Table 49.167. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.168. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.169. 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.

49.45. loadbalancer l7rule delete

Delete a l7rule

Usage:

openstack loadbalancer l7rule delete [-h] [--wait] <l7policy> <rule_id>

Table 49.170. Positional arguments
ValueSummary

<l7policy>

L7policy to delete rule from (name or id).

<rule_id>

L7rule to delete.

Table 49.171. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for action to complete

49.46. loadbalancer l7rule list

List l7rules for l7policy

Usage:

openstack loadbalancer l7rule list [-h]
                                          [-f {csv,json,table,value,yaml}]
                                          [-c COLUMN]
                                          [--quote {all,minimal,none,nonnumeric}]
                                          [--noindent] [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--sort-column SORT_COLUMN]
                                          [--sort-ascending | --sort-descending]
                                          [--tags <tag>[,<tag>,...]]
                                          [--any-tags <tag>[,<tag>,...]]
                                          [--not-tags <tag>[,<tag>,...]]
                                          [--not-any-tags <tag>[,<tag>,...]]
                                          <l7policy>

Table 49.172. Positional arguments
ValueSummary

<l7policy>

L7policy to list rules for (name or id).

Table 49.173. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--tags <tag>[,<tag>,…​]

List l7rule which have all given tag(s) (comma- separated list of tags)

--any-tags <tag>[,<tag>,…​]

List l7rule which have any given tag(s) (comma- separated list of tags)

--not-tags <tag>[,<tag>,…​]

Exclude l7rule which have all given tag(s) (comma- separated list of tags)

--not-any-tags <tag>[,<tag>,…​]

Exclude l7rule which have any given tag(s) (comma- separated list of tags)

Table 49.174. 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 to show multiple columns

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

Sort the column(s) in ascending order

--sort-descending

Sort the column(s) in descending order

Table 49.175. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 49.176. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.177. 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.

49.47. loadbalancer l7rule set

Update a l7rule

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,SSL_CONN_HAS_CERT,SSL_VERIFY_RESULT,SSL_DN_FIELD}]
                                         [--enable | --disable] [--wait]
                                         [--tag <tag>] [--no-tag]
                                         <l7policy> <l7rule_id>

Table 49.178. Positional arguments
ValueSummary

<l7policy>

L7policy to update l7rule on (name or id).

<l7rule_id>

L7rule to update.

Table 49.179. Command 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,SSL_CONN_HAS_CERT,SSL_VERIFY_RESULT,SSL_DN_FIELD}

Set the type for the l7rule.

--enable

Enable l7rule.

--disable

Disable l7rule.

--wait

Wait for action to complete

--tag <tag>

Tag to be added to the l7rule (repeat option to set multiple tags)

--no-tag

Clear tags associated with the l7rule. specify both --tag and --no-tag to overwrite current tags

49.48. loadbalancer l7rule show

Show the details of a single l7rule

Usage:

openstack loadbalancer l7rule show [-h]
                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN] [--noindent]
                                          [--prefix PREFIX]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          <l7policy> <l7rule_id>

Table 49.180. Positional arguments
ValueSummary

<l7policy>

L7policy to show rule from (name or id).

<l7rule_id>

L7rule to show.

Table 49.181. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.182. 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 to show multiple columns

Table 49.183. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.184. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.185. 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.

49.49. loadbalancer l7rule unset

Clear l7rule settings

Usage:

openstack loadbalancer l7rule unset [-h] [--invert] [--key] [--wait]
                                           [--tag <tag> | --all-tag]
                                           <l7policy> <l7rule_id>

Table 49.186. Positional arguments
ValueSummary

<l7policy>

L7policy to update (name or id).

<l7rule_id>

L7rule to update.

Table 49.187. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--invert

Reset the l7rule invert to the api default.

--key

Clear the l7rule key.

--wait

Wait for action to complete

--tag <tag>

Tag to be removed from the l7rule (repeat option to remove multiple tags)

--all-tag

Clear all tags associated with the l7rule

49.50. loadbalancer list

List load balancers

Usage:

openstack loadbalancer list [-h] [-f {csv,json,table,value,yaml}]
                                   [-c COLUMN]
                                   [--quote {all,minimal,none,nonnumeric}]
                                   [--noindent] [--max-width <integer>]
                                   [--fit-width] [--print-empty]
                                   [--sort-column SORT_COLUMN]
                                   [--sort-ascending | --sort-descending]
                                   [--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>] [--flavor <flavor>]
                                   [--availability-zone <availability_zone>]
                                   [--tags <tag>[,<tag>,...]]
                                   [--any-tags <tag>[,<tag>,...]]
                                   [--not-tags <tag>[,<tag>,...]]
                                   [--not-any-tags <tag>[,<tag>,...]]

Table 49.188. Command 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.

--flavor <flavor>

List load balancers according to their flavor.

--availability-zone <availability_zone>

List load balancers according to their availability zone.

--tags <tag>[,<tag>,…​]

List load balancer which have all given tag(s) (comma- separated list of tags)

--any-tags <tag>[,<tag>,…​]

List load balancer which have any given tag(s) (comma- separated list of tags)

--not-tags <tag>[,<tag>,…​]

Exclude load balancer which have all given tag(s) (Comma-separated list of tags)

--not-any-tags <tag>[,<tag>,…​]

Exclude load balancer which have any given tag(s) (Comma-separated list of tags)

Table 49.189. 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 to show multiple columns

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

Sort the column(s) in ascending order

--sort-descending

Sort the column(s) in descending order

Table 49.190. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 49.191. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.192. 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.

49.51. loadbalancer listener create

Create a listener

Usage:

openstack loadbalancer listener create [-h]
                                              [-f {json,shell,table,value,yaml}]
                                              [-c COLUMN] [--noindent]
                                              [--prefix PREFIX]
                                              [--max-width <integer>]
                                              [--fit-width] [--print-empty]
                                              [--name <name>]
                                              [--description <description>]
                                              --protocol
                                              {TCP,HTTP,HTTPS,TERMINATED_HTTPS,UDP,SCTP}
                                              [--connection-limit <limit>]
                                              [--default-pool <pool>]
                                              [--default-tls-container-ref <container_ref>]
                                              [--sni-container-refs [<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]
                                              [--client-ca-tls-container-ref <container_ref>]
                                              [--client-authentication {NONE,OPTIONAL,MANDATORY}]
                                              [--client-crl-container-ref <client_crl_container_ref>]
                                              [--allowed-cidr [<allowed_cidr>]]
                                              [--wait]
                                              [--tls-ciphers <tls_ciphers>]
                                              [--tls-version [<tls_versions>]]
                                              [--alpn-protocol [<alpn_protocols>]]
                                              [--tag <tag> | --no-tag]
                                              <loadbalancer>

Table 49.193. Positional arguments
ValueSummary

<loadbalancer>

Load balancer for the listener (name or id).

Table 49.194. Command 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,SCTP}

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> …​]

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.

--client-ca-tls-container-ref <container_ref>

The uri to the key manager service secrets container containing the CA certificate for TERMINATED_TLS listeners.

--client-authentication {NONE,OPTIONAL,MANDATORY}

The tls client authentication verify options for TERMINATED_TLS listeners.

--client-crl-container-ref <client_crl_container_ref>

The uri to the key manager service secrets container containting the CA revocation list file for TERMINATED_TLS listeners.

--allowed-cidr [<allowed_cidr>]

Cidr to allow access to the listener (can be set multiple times).

--wait

Wait for action to complete

--tls-ciphers <tls_ciphers>

Set the tls ciphers to be used by the listener in OpenSSL format.

--tls-version [<tls_versions>]

Set the tls protocol version to be used by the listener (can be set multiple times).

--alpn-protocol [<alpn_protocols>]

Set the alpn protocol to be used by the listener (can be set multiple times).

--tag <tag>

Tag to be added to the listener (repeat option to set multiple tags)

--no-tag

No tags associated with the listener

Table 49.195. 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 to show multiple columns

Table 49.196. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.197. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.198. 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.

49.52. loadbalancer listener delete

Delete a listener

Usage:

openstack loadbalancer listener delete [-h] [--wait] <listener>

Table 49.199. Positional arguments
ValueSummary

<listener>

Listener to delete (name or id)

Table 49.200. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for action to complete

49.53. loadbalancer listener list

List listeners

Usage:

openstack loadbalancer listener list [-h]
                                            [-f {csv,json,table,value,yaml}]
                                            [-c COLUMN]
                                            [--quote {all,minimal,none,nonnumeric}]
                                            [--noindent]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--sort-column SORT_COLUMN]
                                            [--sort-ascending | --sort-descending]
                                            [--name <name>]
                                            [--loadbalancer <loadbalancer>]
                                            [--enable | --disable]
                                            [--project <project>]
                                            [--tags <tag>[,<tag>,...]]
                                            [--any-tags <tag>[,<tag>,...]]
                                            [--not-tags <tag>[,<tag>,...]]
                                            [--not-any-tags <tag>[,<tag>,...]]

Table 49.201. Command 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.

--tags <tag>[,<tag>,…​]

List listener which have all given tag(s) (comma- separated list of tags)

--any-tags <tag>[,<tag>,…​]

List listener which have any given tag(s) (comma- separated list of tags)

--not-tags <tag>[,<tag>,…​]

Exclude listener which have all given tag(s) (comma- separated list of tags)

--not-any-tags <tag>[,<tag>,…​]

Exclude listener which have any given tag(s) (comma- separated list of tags)

Table 49.202. 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 to show multiple columns

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

Sort the column(s) in ascending order

--sort-descending

Sort the column(s) in descending order

Table 49.203. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 49.204. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.205. 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.

49.54. loadbalancer listener set

Update a listener

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> ...]]
                                           [--insert-headers <header=value>]
                                           [--timeout-client-data <timeout>]
                                           [--timeout-member-connect <timeout>]
                                           [--timeout-member-data <timeout>]
                                           [--timeout-tcp-inspect <timeout>]
                                           [--enable | --disable]
                                           [--client-ca-tls-container-ref <container_ref>]
                                           [--client-authentication {NONE,OPTIONAL,MANDATORY}]
                                           [--client-crl-container-ref <client_crl_container_ref>]
                                           [--allowed-cidr [<allowed_cidr>]]
                                           [--wait]
                                           [--tls-ciphers <tls_ciphers>]
                                           [--tls-version [<tls_versions>]]
                                           [--alpn-protocol [<alpn_protocols>]]
                                           [--tag <tag>] [--no-tag]
                                           <listener>

Table 49.206. Positional arguments
ValueSummary

<listener>

Listener to modify (name or id).

Table 49.207. Command 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> …​]

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.

--client-ca-tls-container-ref <container_ref>

The uri to the key manager service secrets container containing the CA certificate for TERMINATED_TLS listeners.

--client-authentication {NONE,OPTIONAL,MANDATORY}

The tls client authentication verify options for TERMINATED_TLS listeners.

--client-crl-container-ref <client_crl_container_ref>

The uri to the key manager service secrets container containting the CA revocation list file for TERMINATED_TLS listeners.

--allowed-cidr [<allowed_cidr>]

Cidr to allow access to the listener (can be set multiple times).

--wait

Wait for action to complete

--tls-ciphers <tls_ciphers>

Set the tls ciphers to be used by the listener in OpenSSL format.

--tls-version [<tls_versions>]

Set the tls protocol version to be used by the listener (can be set multiple times).

--alpn-protocol [<alpn_protocols>]

Set the alpn protocol to be used by the listener (can be set multiple times).

--tag <tag>

Tag to be added to the listener (repeat option to set multiple tags)

--no-tag

Clear tags associated with the listener. specify both --tag and --no-tag to overwrite current tags

49.55. loadbalancer listener show

Show the details of a single listener

Usage:

openstack loadbalancer listener show [-h]
                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN] [--noindent]
                                            [--prefix PREFIX]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            <listener>

Table 49.208. Positional arguments
ValueSummary

<listener>

Name or uuid of the listener

Table 49.209. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.210. 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 to show multiple columns

Table 49.211. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.212. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.213. 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.

49.56. loadbalancer listener stats show

Shows the current statistics for a listener.

Usage:

openstack loadbalancer listener stats show [-h]
                                                  [-f {json,shell,table,value,yaml}]
                                                  [-c COLUMN] [--noindent]
                                                  [--prefix PREFIX]
                                                  [--max-width <integer>]
                                                  [--fit-width]
                                                  [--print-empty]
                                                  <listener>

Table 49.214. Positional arguments
ValueSummary

<listener>

Name or uuid of the listener

Table 49.215. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.216. 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 to show multiple columns

Table 49.217. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.218. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.219. 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.

49.57. loadbalancer listener unset

Clear listener settings

Usage:

openstack loadbalancer listener unset [-h] [--name] [--description]
                                             [--connection-limit]
                                             [--default-pool]
                                             [--default-tls-container-ref]
                                             [--sni-container-refs]
                                             [--insert-headers]
                                             [--timeout-client-data]
                                             [--timeout-member-connect]
                                             [--timeout-member-data]
                                             [--timeout-tcp-inspect]
                                             [--client-ca-tls-container-ref]
                                             [--client-authentication]
                                             [--client-crl-container-ref]
                                             [--allowed-cidrs]
                                             [--tls-versions] [--tls-ciphers]
                                             [--wait] [--alpn-protocols]
                                             [--tag <tag> | --all-tag]
                                             <listener>

Table 49.220. Positional arguments
ValueSummary

<listener>

Listener to modify (name or id).

Table 49.221. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name

Clear the listener name.

--description

Clear the description of this listener.

--connection-limit

Reset the connection limit to the api default.

--default-pool

Clear the default pool from the listener.

--default-tls-container-ref

Remove the default tls container reference from the listener.

--sni-container-refs

Remove the tls sni container references from the listener.

--insert-headers

Clear the insert headers from the listener.

--timeout-client-data

Reset the client data timeout to the api default.

--timeout-member-connect

Reset the member connect timeout to the api default.

--timeout-member-data

Reset the member data timeout to the api default.

--timeout-tcp-inspect

Reset the tcp inspection timeout to the api default.

--client-ca-tls-container-ref

Clear the client ca tls container reference from the listener.

--client-authentication

Reset the client authentication setting to the api default.

--client-crl-container-ref

Clear the client crl container reference from the listener.

--allowed-cidrs

Clear all allowed cidrs from the listener.

--tls-versions

Clear all tls versions from the listener.

--tls-ciphers

Clear all tls ciphers from the listener.

--wait

Wait for action to complete.

--alpn-protocols

Clear all alpn protocols from the listener.

--tag <tag>

Tag to be removed from the listener (repeat option to remove multiple tags)

--all-tag

Clear all tags associated with the listener

49.58. loadbalancer member create

Creating a member in a pool

Usage:

openstack loadbalancer member create [-h]
                                            [-f {json,shell,table,value,yaml}]
                                            [-c COLUMN] [--noindent]
                                            [--prefix PREFIX]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--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] [--wait]
                                            [--tag <tag> | --no-tag]
                                            <pool>

Table 49.222. Positional arguments
ValueSummary

<pool>

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

Table 49.223. Command 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

--wait

Wait for action to complete

--tag <tag>

Tag to be added to the member (repeat option to set multiple tags)

--no-tag

No tags associated with the member

Table 49.224. 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 to show multiple columns

Table 49.225. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.226. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.227. 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.

49.59. loadbalancer member delete

Delete a member from a pool

Usage:

openstack loadbalancer member delete [-h] [--wait] <pool> <member>

Table 49.228. Positional arguments
ValueSummary

<pool>

Pool name or id to delete the member from.

<member>

Name or id of the member to be deleted.

Table 49.229. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for action to complete

49.60. loadbalancer member list

List members in a pool

Usage:

openstack loadbalancer member list [-h]
                                          [-f {csv,json,table,value,yaml}]
                                          [-c COLUMN]
                                          [--quote {all,minimal,none,nonnumeric}]
                                          [--noindent] [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--sort-column SORT_COLUMN]
                                          [--sort-ascending | --sort-descending]
                                          [--tags <tag>[,<tag>,...]]
                                          [--any-tags <tag>[,<tag>,...]]
                                          [--not-tags <tag>[,<tag>,...]]
                                          [--not-any-tags <tag>[,<tag>,...]]
                                          <pool>

Table 49.230. Positional arguments
ValueSummary

<pool>

Pool name or id to list the members of.

Table 49.231. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--tags <tag>[,<tag>,…​]

List member which have all given tag(s) (comma- separated list of tags)

--any-tags <tag>[,<tag>,…​]

List member which have any given tag(s) (comma- separated list of tags)

--not-tags <tag>[,<tag>,…​]

Exclude member which have all given tag(s) (comma- separated list of tags)

--not-any-tags <tag>[,<tag>,…​]

Exclude member which have any given tag(s) (comma- separated list of tags)

Table 49.232. 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 to show multiple columns

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

Sort the column(s) in ascending order

--sort-descending

Sort the column(s) in descending order

Table 49.233. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 49.234. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.235. 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.

49.61. loadbalancer member set

Update a member

Usage:

openstack loadbalancer member set [-h] [--name <name>]
                                         [--disable-backup | --enable-backup]
                                         [--weight <weight>]
                                         [--monitor-port <monitor_port>]
                                         [--monitor-address <monitor_address>]
                                         [--enable | --disable] [--wait]
                                         [--tag <tag>] [--no-tag]
                                         <pool> <member>

Table 49.236. Positional arguments
ValueSummary

<pool>

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

<member>

Name or id of the member to update

Table 49.237. Command 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

--wait

Wait for action to complete

--tag <tag>

Tag to be added to the member (repeat option to set multiple tags)

--no-tag

Clear tags associated with the member. specify both --tag and --no-tag to overwrite current tags

49.62. loadbalancer member show

Shows details of a single Member

Usage:

openstack loadbalancer member show [-h]
                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN] [--noindent]
                                          [--prefix PREFIX]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          <pool> <member>

Table 49.238. Positional arguments
ValueSummary

<pool>

Pool name or id to show the members of.

<member>

Name or id of the member to show.

Table 49.239. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.240. 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 to show multiple columns

Table 49.241. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.242. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.243. 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.

49.63. loadbalancer member unset

Clear member settings

Usage:

openstack loadbalancer member unset [-h] [--backup] [--monitor-address]
                                           [--monitor-port] [--name]
                                           [--weight] [--wait]
                                           [--tag <tag> | --all-tag]
                                           <pool> <member>

Table 49.244. Positional arguments
ValueSummary

<pool>

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

<member>

Member to modify (name or id).

Table 49.245. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--backup

Clear the backup member flag.

--monitor-address

Clear the member monitor address.

--monitor-port

Clear the member monitor port.

--name

Clear the member name.

--weight

Reset the member weight to the api default.

--wait

Wait for action to complete

--tag <tag>

Tag to be removed from the member (repeat option to remove multiple tags)

--all-tag

Clear all tags associated with the member

49.64. loadbalancer pool create

Create a pool

Usage:

openstack loadbalancer pool create [-h]
                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN] [--noindent]
                                          [--prefix PREFIX]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          [--name <name>]
                                          [--description <description>]
                                          --protocol
                                          {TCP,HTTP,HTTPS,TERMINATED_HTTPS,PROXY,PROXYV2,UDP,SCTP}
                                          (--listener <listener> | --loadbalancer <load_balancer>)
                                          [--session-persistence <session persistence>]
                                          --lb-algorithm
                                          {SOURCE_IP,ROUND_ROBIN,LEAST_CONNECTIONS,SOURCE_IP_PORT}
                                          [--enable | --disable]
                                          [--tls-container-ref <container-ref>]
                                          [--ca-tls-container-ref <ca_tls_container_ref>]
                                          [--crl-container-ref <crl_container_ref>]
                                          [--enable-tls | --disable-tls]
                                          [--wait]
                                          [--tls-ciphers <tls_ciphers>]
                                          [--tls-version [<tls_versions>]]
                                          [--alpn-protocol [<alpn_protocols>]]
                                          [--tag <tag> | --no-tag]

Table 49.246. Command 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,PROXYV2,UDP,SCTP}

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,SOURCE_IP_PORT}

Load balancing algorithm to use.

--enable

Enable pool (default).

--disable

Disable pool.

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

The reference to the key manager service secrets container containing the certificate and key for ``tls_enabled`` pools to re-encrpt the traffic to backend member servers.

--ca-tls-container-ref <ca_tls_container_ref>

The reference to the key manager service secrets container containing the CA certificate for ``tls_enabled`` pools to check the backend member servers certificates

--crl-container-ref <crl_container_ref>

The reference to the key manager service secrets container containting the CA revocation list file for ``tls_enabled`` pools to validate the backend member servers certificates.

--enable-tls

Enable backend member re-encryption.

--disable-tls

Disable backend member re-encryption.

--wait

Wait for action to complete

--tls-ciphers <tls_ciphers>

Set the tls ciphers to be used by the pool in openssl cipher string format.

--tls-version [<tls_versions>]

Set the tls protocol version to be used by the pool (can be set multiple times).

--alpn-protocol [<alpn_protocols>]

Set the alpn protocol to be used by the pool (can be set multiple times).

--tag <tag>

Tag to be added to the pool (repeat option to set multiple tags)

--no-tag

No tags associated with the pool

Table 49.247. 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 to show multiple columns

Table 49.248. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.249. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.250. 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.

49.65. loadbalancer pool delete

Delete a pool

Usage:

openstack loadbalancer pool delete [-h] [--wait] <pool>

Table 49.251. Positional arguments
ValueSummary

<pool>

Pool to delete (name or id).

Table 49.252. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--wait

Wait for action to complete

49.66. loadbalancer pool list

List pools

Usage:

openstack loadbalancer pool list [-h] [-f {csv,json,table,value,yaml}]
                                        [-c COLUMN]
                                        [--quote {all,minimal,none,nonnumeric}]
                                        [--noindent] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--sort-column SORT_COLUMN]
                                        [--sort-ascending | --sort-descending]
                                        [--loadbalancer <loadbalancer>]
                                        [--tags <tag>[,<tag>,...]]
                                        [--any-tags <tag>[,<tag>,...]]
                                        [--not-tags <tag>[,<tag>,...]]
                                        [--not-any-tags <tag>[,<tag>,...]]

Table 49.253. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--loadbalancer <loadbalancer>

Filter by load balancer (name or id).

--tags <tag>[,<tag>,…​]

List pool which have all given tag(s) (comma-separated list of tags)

--any-tags <tag>[,<tag>,…​]

List pool which have any given tag(s) (comma-separated list of tags)

--not-tags <tag>[,<tag>,…​]

Exclude pool which have all given tag(s) (comma- separated list of tags)

--not-any-tags <tag>[,<tag>,…​]

Exclude pool which have any given tag(s) (comma- separated list of tags)

Table 49.254. 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 to show multiple columns

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

Sort the column(s) in ascending order

--sort-descending

Sort the column(s) in descending order

Table 49.255. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 49.256. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.257. 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.

49.67. loadbalancer pool set

Update a pool

Usage:

openstack loadbalancer pool set [-h] [--name <name>]
                                       [--description <description>]
                                       [--session-persistence <session_persistence>]
                                       [--lb-algorithm {SOURCE_IP,ROUND_ROBIN,LEAST_CONNECTIONS,SOURCE_IP_PORT}]
                                       [--enable | --disable]
                                       [--tls-container-ref <container-ref>]
                                       [--ca-tls-container-ref <ca_tls_container_ref>]
                                       [--crl-container-ref <crl_container_ref>]
                                       [--enable-tls | --disable-tls] [--wait]
                                       [--tls-ciphers <tls_ciphers>]
                                       [--tls-version [<tls_versions>]]
                                       [--alpn-protocol [<alpn_protocols>]]
                                       [--tag <tag>] [--no-tag]
                                       <pool>

Table 49.258. Positional arguments
ValueSummary

<pool>

Pool to update (name or id).

Table 49.259. Command 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,SOURCE_IP_PORT}

Set the load balancing algorithm to use.

--enable

Enable pool.

--disable

Disable pool.

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

The uri to the key manager service secrets container containing the certificate and key for TERMINATED_TLS pools to re-encrpt the traffic from TERMINATED_TLS listener to backend servers.

--ca-tls-container-ref <ca_tls_container_ref>

The uri to the key manager service secrets container containing the CA certificate for TERMINATED_TLS listeners to check the backend servers certificates in ssl traffic.

--crl-container-ref <crl_container_ref>

The uri to the key manager service secrets container containting the CA revocation list file for TERMINATED_TLS listeners to valid the backend servers certificates in ssl traffic.

--enable-tls

Enable backend associated members re-encryption.

--disable-tls

Disable backend associated members re-encryption.

--wait

Wait for action to complete

--tls-ciphers <tls_ciphers>

Set the tls ciphers to be used by the pool in openssl cipher string format.

--tls-version [<tls_versions>]

Set the tls protocol version to be used by the pool (can be set multiple times).

--alpn-protocol [<alpn_protocols>]

Set the alpn protocol to be used by the pool (can be set multiple times).

--tag <tag>

Tag to be added to the pool (repeat option to set multiple tags)

--no-tag

Clear tags associated with the pool. specify both --tag and --no-tag to overwrite current tags

49.68. loadbalancer pool show

Show the details of a single pool

Usage:

openstack loadbalancer pool show [-h]
                                        [-f {json,shell,table,value,yaml}]
                                        [-c COLUMN] [--noindent]
                                        [--prefix PREFIX]
                                        [--max-width <integer>] [--fit-width]
                                        [--print-empty]
                                        <pool>

Table 49.260. Positional arguments
ValueSummary

<pool>

Name or uuid of the pool.

Table 49.261. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.262. 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 to show multiple columns

Table 49.263. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.264. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.265. 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.

49.69. loadbalancer pool unset

Clear pool settings

Usage:

openstack loadbalancer pool unset [-h] [--name] [--description]
                                         [--ca-tls-container-ref]
                                         [--crl-container-ref]
                                         [--session-persistence]
                                         [--tls-container-ref]
                                         [--tls-versions] [--tls-ciphers]
                                         [--wait] [--alpn-protocols]
                                         [--tag <tag> | --all-tag]
                                         <pool>

Table 49.266. Positional arguments
ValueSummary

<pool>

Pool to modify (name or id).

Table 49.267. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name

Clear the pool name.

--description

Clear the description of this pool.

--ca-tls-container-ref

Clear the certificate authority certificate reference on this pool.

--crl-container-ref

Clear the certificate revocation list reference on this pool.

--session-persistence

Disables session persistence on the pool.

--tls-container-ref

Clear the certificate reference for this pool.

--tls-versions

Clear all tls versions from the pool.

--tls-ciphers

Clear all tls ciphers from the pool.

--wait

Wait for action to complete

--alpn-protocols

Clear all alpn protocols from the pool.

--tag <tag>

Tag to be removed from the pool (repeat option to remove multiple tags)

--all-tag

Clear all tags associated with the pool

49.70. loadbalancer provider capability list

List specified provider driver’s capabilities.

Usage:

openstack loadbalancer provider capability list [-h]
                                                       [-f {csv,json,table,value,yaml}]
                                                       [-c COLUMN]
                                                       [--quote {all,minimal,none,nonnumeric}]
                                                       [--noindent]
                                                       [--max-width <integer>]
                                                       [--fit-width]
                                                       [--print-empty]
                                                       [--sort-column SORT_COLUMN]
                                                       [--sort-ascending | --sort-descending]
                                                       [--flavor | --availability-zone]
                                                       <provider_name>

Table 49.268. Positional arguments
ValueSummary

<provider_name>

Name of the provider driver.

Table 49.269. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--flavor

Get capabilities for flavor only.

--availability-zone

Get capabilities for availability zone only.

Table 49.270. 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 to show multiple columns

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

Sort the column(s) in ascending order

--sort-descending

Sort the column(s) in descending order

Table 49.271. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 49.272. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.273. 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.

49.71. loadbalancer provider list

List all providers

Usage:

openstack loadbalancer provider list [-h]
                                            [-f {csv,json,table,value,yaml}]
                                            [-c COLUMN]
                                            [--quote {all,minimal,none,nonnumeric}]
                                            [--noindent]
                                            [--max-width <integer>]
                                            [--fit-width] [--print-empty]
                                            [--sort-column SORT_COLUMN]
                                            [--sort-ascending | --sort-descending]

Table 49.274. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.275. 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 to show multiple columns

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

Sort the column(s) in ascending order

--sort-descending

Sort the column(s) in descending order

Table 49.276. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 49.277. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.278. 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.

49.72. loadbalancer quota defaults show

Show quota defaults

Usage:

openstack loadbalancer quota defaults show [-h]
                                                  [-f {json,shell,table,value,yaml}]
                                                  [-c COLUMN] [--noindent]
                                                  [--prefix PREFIX]
                                                  [--max-width <integer>]
                                                  [--fit-width]
                                                  [--print-empty]

Table 49.279. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.280. 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 to show multiple columns

Table 49.281. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.282. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.283. 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.

49.73. loadbalancer quota list

List quotas

Usage:

openstack loadbalancer quota list [-h] [-f {csv,json,table,value,yaml}]
                                         [-c COLUMN]
                                         [--quote {all,minimal,none,nonnumeric}]
                                         [--noindent] [--max-width <integer>]
                                         [--fit-width] [--print-empty]
                                         [--sort-column SORT_COLUMN]
                                         [--sort-ascending | --sort-descending]
                                         [--project <project-id>]

Table 49.284. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--project <project-id>

Name or uuid of the project.

Table 49.285. 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 to show multiple columns

--sort-column SORT_COLUMN

Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated

--sort-ascending

Sort the column(s) in ascending order

--sort-descending

Sort the column(s) in descending order

Table 49.286. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 49.287. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.288. 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.

49.74. loadbalancer quota reset

Resets quotas to default quotas

Usage:

openstack loadbalancer quota reset [-h] <project>

Table 49.289. Positional arguments
ValueSummary

<project>

Project to reset quotas (name or id)

Table 49.290. Command arguments
ValueSummary

-h, --help

Show this help message and exit

49.75. loadbalancer quota set

Update a quota

Usage:

openstack loadbalancer quota set [-h]
                                        [-f {json,shell,table,value,yaml}]
                                        [-c COLUMN] [--noindent]
                                        [--prefix PREFIX]
                                        [--max-width <integer>] [--fit-width]
                                        [--print-empty]
                                        [--healthmonitor <health_monitor>]
                                        [--listener <listener>]
                                        [--loadbalancer <load_balancer>]
                                        [--member <member>] [--pool <pool>]
                                        [--l7policy <l7policy>]
                                        [--l7rule <l7rule>]
                                        <project>

Table 49.291. Positional arguments
ValueSummary

<project>

Name or uuid of the project.

Table 49.292. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.293. 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 to show multiple columns

Table 49.294. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.295. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.296. 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.

Table 49.297. Quota limits
ValueSummary

At least one of the following arguments is required.--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.

--l7policy <l7policy>

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

--l7rule <l7rule>

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

49.76. loadbalancer quota show

Show the quota details for a project

Usage:

openstack loadbalancer quota show [-h]
                                         [-f {json,shell,table,value,yaml}]
                                         [-c COLUMN] [--noindent]
                                         [--prefix PREFIX]
                                         [--max-width <integer>] [--fit-width]
                                         [--print-empty]
                                         <project>

Table 49.298. Positional arguments
ValueSummary

<project>

Name or uuid of the project.

Table 49.299. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.300. 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 to show multiple columns

Table 49.301. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.302. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.303. 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.

49.77. loadbalancer quota unset

Clear quota settings

Usage:

openstack loadbalancer quota unset [-h] [--loadbalancer] [--listener]
                                          [--pool] [--member]
                                          [--healthmonitor] [--l7policy]
                                          [--l7rule]
                                          <project>

Table 49.304. Positional arguments
ValueSummary

<project>

Name or uuid of the project.

Table 49.305. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--loadbalancer

Reset the load balancer quota to the default.

--listener

Reset the listener quota to the default.

--pool

Reset the pool quota to the default.

--member

Reset the member quota to the default.

--healthmonitor

Reset the health monitor quota to the default.

--l7policy

Reset the l7policy quota to the default.

--l7rule

Reset the l7rule quota to the default.

49.78. loadbalancer set

Update a load balancer

Usage:

openstack loadbalancer set [-h] [--name <name>]
                                  [--description <description>]
                                  [--vip-qos-policy-id <vip_qos_policy_id>]
                                  [--enable | --disable] [--wait]
                                  [--tag <tag>] [--no-tag]
                                  <load_balancer>

Table 49.306. Positional arguments
ValueSummary

<load_balancer>

Name or uuid of the load balancer to update.

Table 49.307. Command 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.

--wait

Wait for action to complete

--tag <tag>

Tag to be added to the load balancer (repeat option to set multiple tags)

--no-tag

Clear tags associated with the load balancer. specify both --tag and --no-tag to overwrite current tags

49.79. loadbalancer show

Show the details for a single load balancer

Usage:

openstack loadbalancer show [-h] [-f {json,shell,table,value,yaml}]
                                   [-c COLUMN] [--noindent] [--prefix PREFIX]
                                   [--max-width <integer>] [--fit-width]
                                   [--print-empty]
                                   <load_balancer>

Table 49.308. Positional arguments
ValueSummary

<load_balancer>

Name or uuid of the load balancer.

Table 49.309. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.310. 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 to show multiple columns

Table 49.311. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.312. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.313. 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.

49.80. loadbalancer stats show

Shows the current statistics for a load balancer

Usage:

openstack loadbalancer stats show [-h]
                                         [-f {json,shell,table,value,yaml}]
                                         [-c COLUMN] [--noindent]
                                         [--prefix PREFIX]
                                         [--max-width <integer>] [--fit-width]
                                         [--print-empty]
                                         <load_balancer>

Table 49.314. Positional arguments
ValueSummary

<load_balancer>

Name or uuid of the load balancer.

Table 49.315. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Table 49.316. 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 to show multiple columns

Table 49.317. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Table 49.318. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Table 49.319. 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.

49.81. loadbalancer status show

Display load balancer status tree in json format

Usage:

openstack loadbalancer status show [-h] <load_balancer>

Table 49.320. Positional arguments
ValueSummary

<load_balancer>

Name or uuid of the load balancer.

Table 49.321. Command arguments
ValueSummary

-h, --help

Show this help message and exit

49.82. loadbalancer unset

Clear load balancer settings

Usage:

openstack loadbalancer unset [-h] [--name] [--description]
                                    [--vip-qos-policy-id] [--wait]
                                    [--tag <tag> | --all-tag]
                                    <load_balancer>

Table 49.322. Positional arguments
ValueSummary

<load_balancer>

Name or uuid of the load balancer to update.

Table 49.323. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name

Clear the load balancer name.

--description

Clear the load balancer description.

--vip-qos-policy-id

Clear the load balancer qos policy.

--wait

Wait for action to complete

--tag <tag>

Tag to be removed from the load balancer (repeat option to remove multiple tags)

--all-tag

Clear all tags associated with the load balancer

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.

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.

© 2024 Red Hat, Inc.