SupportConsoleDevelopersStart a trialContact

Chapter 19. consistency

This chapter describes the commands under the consistency command.

19.1. consistency group add volume

Add volume(s) to consistency group

Usage:

openstack consistency group add volume [-h]
                                              <consistency-group> <volume>
                                              [<volume> ...]

Table 19.1. Positional Arguments
ValueSummary

<volume>

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

<consistency-group>

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

Table 19.2. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

19.2. consistency group create

Create new consistency group.

Usage:

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

Table 19.3. Table Formatter
ValueSummary

--print-empty

Print empty table if there is no data to show.

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

Table 19.4. Positional Arguments
ValueSummary

<name>

Name of new consistency group (default to none)

Table 19.5. Output Formatters
ValueSummary

output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

The output format, defaults to table

-c COLUMN, --column COLUMN

Specify the column(s) to include, can be repeated

Table 19.6. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Table 19.7. Optional Arguments
ValueSummary

--availability-zone <availability-zone>

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

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

Existing consistency group snapshot (name or id)

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

Existing consistency group (name or id)

-h, --help

Show this help message and exit

--description <description>

Description of this consistency group

--volume-type <volume-type>

Volume type of this consistency group (name or id)

Table 19.8. Shell Formatter
ValueSummary

a format a UNIX shell can parse (variable="value")--prefix PREFIX

Add a prefix to all variable names

19.3. consistency group delete

Delete consistency group(s).

Usage:

openstack consistency group delete [-h] [--force]
                                          <consistency-group>
                                          [<consistency-group> ...]

Table 19.9. Positional Arguments
ValueSummary

<consistency-group>

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

Table 19.10. Optional Arguments
ValueSummary

--force

Allow delete in state other than error or available

-h, --help

Show this help message and exit

19.4. consistency group list

List consistency groups.

Usage:

openstack consistency group list [-h] [-f {csv,json,table,value,yaml}]
                                        [-c COLUMN] [--max-width <integer>]
                                        [--fit-width] [--print-empty]
                                        [--noindent]
                                        [--quote {all,minimal,none,nonnumeric}]
                                        [--sort-column SORT_COLUMN]
                                        [--all-projects] [--long]

Table 19.11. Table Formatter
ValueSummary

--print-empty

Print empty table if there is no data to show.

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

Table 19.12. CSV Formatter
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 19.13. Output Formatters
ValueSummary

output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

The output format, defaults to table

-c COLUMN, --column COLUMN

Specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

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

Table 19.14. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Table 19.15. Optional Arguments
ValueSummary

--all-projects

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

-h, --help

Show this help message and exit

--long

List additional fields in output

19.5. consistency group remove volume

Remove volume(s) from consistency group

Usage:

openstack consistency group remove volume [-h]
                                                 <consistency-group> <volume>
                                                 [<volume> ...]

Table 19.16. Positional Arguments
ValueSummary

<volume>

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

<consistency-group>

Consistency group containing <volume> (name or id)

Table 19.17. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

19.6. consistency group set

Set consistency group properties

Usage:

openstack consistency group set [-h] [--name <name>]
                                       [--description <description>]
                                       <consistency-group>

Table 19.18. Positional Arguments
ValueSummary

<consistency-group>

Consistency group to modify (name or id)

Table 19.19. Optional Arguments
ValueSummary

--name <name>

New consistency group name

-h, --help

Show this help message and exit

--description <description>

New consistency group description

19.7. consistency group show

Display consistency group details.

Usage:

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

Table 19.20. Table Formatter
ValueSummary

--print-empty

Print empty table if there is no data to show.

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

Table 19.21. Positional Arguments
ValueSummary

<consistency-group>

Consistency group to display (name or id)

Table 19.22. Output Formatters
ValueSummary

output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

The output format, defaults to table

-c COLUMN, --column COLUMN

Specify the column(s) to include, can be repeated

Table 19.23. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Table 19.24. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Table 19.25. Shell Formatter
ValueSummary

a format a UNIX shell can parse (variable="value")--prefix PREFIX

Add a prefix to all variable names

19.8. consistency group snapshot create

Create new consistency group snapshot.

Usage:

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

Table 19.26. Table Formatter
ValueSummary

--print-empty

Print empty table if there is no data to show.

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

Table 19.27. Positional Arguments
ValueSummary

<snapshot-name>

Name of new consistency group snapshot (default to None)

Table 19.28. Output Formatters
ValueSummary

output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

The output format, defaults to table

-c COLUMN, --column COLUMN

Specify the column(s) to include, can be repeated

Table 19.29. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Table 19.30. Optional 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

Table 19.31. Shell Formatter
ValueSummary

a format a UNIX shell can parse (variable="value")--prefix PREFIX

Add a prefix to all variable names

19.9. consistency group snapshot delete

<consistency-group-snapshot>
[<consistency-group-snapshot> ...]

Delete consistency group snapshot(s).

Usage:

openstack consistency group snapshot delete [-h]

Table 19.32. Positional Arguments
ValueSummary

<consistency-group-snapshot>

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

Table 19.33. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

19.10. consistency group snapshot list

List consistency group snapshots.

Usage:

openstack consistency group snapshot list [-h]
                                                 [-f {csv,json,table,value,yaml}]
                                                 [-c COLUMN]
                                                 [--max-width <integer>]
                                                 [--fit-width] [--print-empty]
                                                 [--noindent]
                                                 [--quote {all,minimal,none,nonnumeric}]
                                                 [--sort-column SORT_COLUMN]
                                                 [--all-projects] [--long]
                                                 [--status <status>]
                                                 [--consistency-group <consistency-group>]

Table 19.34. Table Formatter
ValueSummary

--print-empty

Print empty table if there is no data to show.

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

Table 19.35. CSV Formatter
ValueSummary

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

When to include quotes, defaults to nonnumeric

Table 19.36. Output Formatters
ValueSummary

output formatter options-f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml}

The output format, defaults to table

-c COLUMN, --column COLUMN

Specify the column(s) to include, can be repeated

--sort-column SORT_COLUMN

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

Table 19.37. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Table 19.38. Optional Arguments
ValueSummary

--all-projects

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

--status <status>

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

-h, --help

Show this help message and exit

--consistency-group <consistency-group>

Filters results by a consistency group (name or id)

--long

List additional fields in output

19.11. consistency group snapshot show

Display consistency group snapshot details

Usage:

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

Table 19.39. Table Formatter
ValueSummary

--print-empty

Print empty table if there is no data to show.

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

Table 19.40. Positional Arguments
ValueSummary

<consistency-group-snapshot>

Consistency group snapshot to display (name or id)

Table 19.41. Output Formatters
ValueSummary

output formatter options-f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml}

The output format, defaults to table

-c COLUMN, --column COLUMN

Specify the column(s) to include, can be repeated

Table 19.42. JSON Formatter
ValueSummary

--noindent

Whether to disable indenting the json

Table 19.43. Optional Arguments
ValueSummary

-h, --help

Show this help message and exit

Table 19.44. Shell Formatter
ValueSummary

a format a UNIX shell can parse (variable="value")--prefix PREFIX

Add a prefix to all variable names

Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

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

Making open source more inclusive

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

About Red Hat

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

© 2024 Red Hat, Inc.