Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 20. consistency

This chapter describes the commands under the consistency command.

20.1. consistency group add volume
Copy link

Add volume(s) to consistency group

Usage:

openstack consistency group add volume [-h]
                                              <consistency-group> <volume>
                                              [<volume> ...]
Copy to Clipboard Toggle word wrap

Expand
Table 20.1. Positional arguments
ValueSummary

<consistency-group>

Consistency group to contain <volume> (name or id)

<volume>

Volume(s) to add to <consistency-group> (name or id) (repeat option to add multiple volumes)

Expand
Table 20.2. Command arguments
ValueSummary

-h, --help

Show this help message and exit

20.2. consistency group create
Copy link

Create new consistency group.

Usage:

openstack consistency group create [-h]
                                          [-f {json,shell,table,value,yaml}]
                                          [-c COLUMN] [--noindent]
                                          [--prefix PREFIX]
                                          [--max-width <integer>]
                                          [--fit-width] [--print-empty]
                                          (--volume-type <volume-type> | --consistency-group-source <consistency-group> | --consistency-group-snapshot <consistency-group-snapshot>)
                                          [--description <description>]
                                          [--availability-zone <availability-zone>]
                                          [<name>]
Copy to Clipboard Toggle word wrap

Expand
Table 20.3. Positional arguments
ValueSummary

<name>

Name of new consistency group (default to none)

Expand
Table 20.4. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--volume-type <volume-type>

Volume type of this consistency group (name or id)

--consistency-group-source <consistency-group>

Existing consistency group (name or id)

--consistency-group-snapshot <consistency-group-snapshot>

Existing consistency group snapshot (name or id)

--description <description>

Description of this consistency group

--availability-zone <availability-zone>

Availability zone for this consistency group (not available if creating consistency group from source)

Expand
Table 20.5. 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

Expand
Table 20.6. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 20.7. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Expand
Table 20.8. 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.

20.3. consistency group delete
Copy link

Delete consistency group(s).

Usage:

openstack consistency group delete [-h] [--force]
                                          <consistency-group>
                                          [<consistency-group> ...]
Copy to Clipboard Toggle word wrap

Expand
Table 20.9. Positional arguments
ValueSummary

<consistency-group>

Consistency group(s) to delete (name or id)

Expand
Table 20.10. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--force

Allow delete in state other than error or available

20.4. consistency group list
Copy link

List consistency groups.

Usage:

openstack consistency group 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]
                                        [--all-projects] [--long]
Copy to Clipboard Toggle word wrap

Expand
Table 20.11. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--all-projects

Show details for all projects. admin only. (defaults to False)

--long

List additional fields in output

Expand
Table 20.12. 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

Expand
Table 20.13. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Expand
Table 20.14. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 20.15. 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.

20.5. consistency group remove volume
Copy link

Remove volume(s) from consistency group

Usage:

openstack consistency group remove volume [-h]
                                                 <consistency-group> <volume>
                                                 [<volume> ...]
Copy to Clipboard Toggle word wrap

Expand
Table 20.16. Positional arguments
ValueSummary

<consistency-group>

Consistency group containing <volume> (name or id)

<volume>

Volume(s) to remove from <consistency-group> (name or ID) (repeat option to remove multiple volumes)

Expand
Table 20.17. Command arguments
ValueSummary

-h, --help

Show this help message and exit

20.6. consistency group set
Copy link

Set consistency group properties

Usage:

openstack consistency group set [-h] [--name <name>]
                                       [--description <description>]
                                       <consistency-group>
Copy to Clipboard Toggle word wrap

Expand
Table 20.18. Positional arguments
ValueSummary

<consistency-group>

Consistency group to modify (name or id)

Expand
Table 20.19. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--name <name>

New consistency group name

--description <description>

New consistency group description

20.7. consistency group show
Copy link

Display consistency group details.

Usage:

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

Expand
Table 20.20. Positional arguments
ValueSummary

<consistency-group>

Consistency group to display (name or id)

Expand
Table 20.21. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 20.22. 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

Expand
Table 20.23. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 20.24. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Expand
Table 20.25. 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.

20.8. consistency group snapshot create
Copy link

Create new consistency group snapshot.

Usage:

openstack consistency group snapshot create [-h]
                                                   [-f {json,shell,table,value,yaml}]
                                                   [-c COLUMN] [--noindent]
                                                   [--prefix PREFIX]
                                                   [--max-width <integer>]
                                                   [--fit-width]
                                                   [--print-empty]
                                                   [--consistency-group <consistency-group>]
                                                   [--description <description>]
                                                   [<snapshot-name>]
Copy to Clipboard Toggle word wrap

Expand
Table 20.26. Positional arguments
ValueSummary

<snapshot-name>

Name of new consistency group snapshot (default to None)

Expand
Table 20.27. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--consistency-group <consistency-group>

Consistency group to snapshot (name or id) (default to be the same as <snapshot-name>)

--description <description>

Description of this consistency group snapshot

Expand
Table 20.28. 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

Expand
Table 20.29. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 20.30. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Expand
Table 20.31. 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.

20.9. consistency group snapshot delete
Copy link

Delete consistency group snapshot(s).

Usage:

openstack consistency group snapshot delete [-h]
                                                   <consistency-group-snapshot>
                                                   [<consistency-group-snapshot> ...]
Copy to Clipboard Toggle word wrap

Expand
Table 20.32. Positional arguments
ValueSummary

<consistency-group-snapshot>

Consistency group snapshot(s) to delete (name or id)

Expand
Table 20.33. Command arguments
ValueSummary

-h, --help

Show this help message and exit

20.10. consistency group snapshot list
Copy link

List consistency group snapshots.

Usage:

openstack consistency group snapshot 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]
                                                 [--all-projects] [--long]
                                                 [--status <status>]
                                                 [--consistency-group <consistency-group>]
Copy to Clipboard Toggle word wrap

Expand
Table 20.34. Command arguments
ValueSummary

-h, --help

Show this help message and exit

--all-projects

Show detail for all projects (admin only) (defaults to False)

--long

List additional fields in output

--status <status>

Filters results by a status ("available", "error", "creating", "deleting" or "error_deleting")

--consistency-group <consistency-group>

Filters results by a consistency group (name or id)

Expand
Table 20.35. 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

Expand
Table 20.36. CSV formatter options
ValueSummary

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

When to include quotes, defaults to nonnumeric

Expand
Table 20.37. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 20.38. 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.

20.11. consistency group snapshot show
Copy link

Display consistency group snapshot details

Usage:

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

Expand
Table 20.39. Positional arguments
ValueSummary

<consistency-group-snapshot>

Consistency group snapshot to display (name or id)

Expand
Table 20.40. Command arguments
ValueSummary

-h, --help

Show this help message and exit

Expand
Table 20.41. 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

Expand
Table 20.42. JSON formatter options
ValueSummary

--noindent

Whether to disable indenting the json

Expand
Table 20.43. Shell formatter options
ValueSummary

--prefix PREFIX

Add a prefix to all variable names

Expand
Table 20.44. 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.

Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

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

Making open source more inclusive

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

About Red Hat

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

Theme

© 2025 Red Hat