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