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
| Value | Summary |
|---|---|
| <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) |
Table 19.2. Command arguments
| Value | Summary |
|---|---|
| -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] [--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>]
Table 19.3. Positional arguments
| Value | Summary |
|---|---|
| <name> | Name of new consistency group (default to none) |
Table 19.4. Command arguments
| Value | Summary |
|---|---|
| -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) |
Table 19.5. Output formatter options
| Value | Summary |
|---|---|
| -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 options
| Value | Summary |
|---|---|
| --noindent | Whether to disable indenting the json |
Table 19.7. Shell formatter options
| Value | Summary |
|---|---|
| --prefix PREFIX | Add a prefix to all variable names |
Table 19.8. Table formatter options
| Value | Summary |
|---|---|
| --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. |
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
| Value | Summary |
|---|---|
| <consistency-group> | Consistency group(s) to delete (name or id) |
Table 19.10. Command arguments
| Value | Summary |
|---|---|
| -h, --help | Show this help message and exit |
| --force | Allow delete in state other than error or available |
19.4. consistency group list
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]
[--all-projects] [--long]
Table 19.11. Command arguments
| Value | Summary |
|---|---|
| -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 |
Table 19.12. Output formatter options
| Value | Summary |
|---|---|
| -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.13. CSV formatter options
| Value | Summary |
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Table 19.14. JSON formatter options
| Value | Summary |
|---|---|
| --noindent | Whether to disable indenting the json |
Table 19.15. Table formatter options
| Value | Summary |
|---|---|
| --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. |
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
| Value | Summary |
|---|---|
| <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) |
Table 19.17. Command arguments
| Value | Summary |
|---|---|
| -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
| Value | Summary |
|---|---|
| <consistency-group> | Consistency group to modify (name or id) |
Table 19.19. Command arguments
| Value | Summary |
|---|---|
| -h, --help | Show this help message and exit |
| --name <name> | New consistency group name |
| --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] [--noindent]
[--prefix PREFIX]
[--max-width <integer>] [--fit-width]
[--print-empty]
<consistency-group>
Table 19.20. Positional arguments
| Value | Summary |
|---|---|
| <consistency-group> | Consistency group to display (name or id) |
Table 19.21. Command arguments
| Value | Summary |
|---|---|
| -h, --help | Show this help message and exit |
Table 19.22. Output formatter options
| Value | Summary |
|---|---|
| -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 options
| Value | Summary |
|---|---|
| --noindent | Whether to disable indenting the json |
Table 19.24. Shell formatter options
| Value | Summary |
|---|---|
| --prefix PREFIX | Add a prefix to all variable names |
Table 19.25. Table formatter options
| Value | Summary |
|---|---|
| --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. |
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] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width]
[--print-empty]
[--consistency-group <consistency-group>]
[--description <description>]
[<snapshot-name>]
Table 19.26. Positional arguments
| Value | Summary |
|---|---|
| <snapshot-name> | Name of new consistency group snapshot (default to None) |
Table 19.27. Command arguments
| Value | Summary |
|---|---|
| -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.28. Output formatter options
| Value | Summary |
|---|---|
| -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 options
| Value | Summary |
|---|---|
| --noindent | Whether to disable indenting the json |
Table 19.30. Shell formatter options
| Value | Summary |
|---|---|
| --prefix PREFIX | Add a prefix to all variable names |
Table 19.31. Table formatter options
| Value | Summary |
|---|---|
| --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. |
19.9. consistency group snapshot delete
Delete consistency group snapshot(s).
Usage:
openstack consistency group snapshot delete [-h]
<consistency-group-snapshot>
[<consistency-group-snapshot> ...]
Table 19.32. Positional arguments
| Value | Summary |
|---|---|
| <consistency-group-snapshot> | Consistency group snapshot(s) to delete (name or id) |
Table 19.33. Command arguments
| Value | Summary |
|---|---|
| -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]
[--quote {all,minimal,none,nonnumeric}]
[--noindent]
[--max-width <integer>]
[--fit-width] [--print-empty]
[--sort-column SORT_COLUMN]
[--all-projects] [--long]
[--status <status>]
[--consistency-group <consistency-group>]
Table 19.34. Command arguments
| Value | Summary |
|---|---|
| -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) |
Table 19.35. Output formatter options
| Value | Summary |
|---|---|
| -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.36. CSV formatter options
| Value | Summary |
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Table 19.37. JSON formatter options
| Value | Summary |
|---|---|
| --noindent | Whether to disable indenting the json |
Table 19.38. Table formatter options
| Value | Summary |
|---|---|
| --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. |
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] [--noindent]
[--prefix PREFIX]
[--max-width <integer>]
[--fit-width] [--print-empty]
<consistency-group-snapshot>
Table 19.39. Positional arguments
| Value | Summary |
|---|---|
| <consistency-group-snapshot> | Consistency group snapshot to display (name or id) |
Table 19.40. Command arguments
| Value | Summary |
|---|---|
| -h, --help | Show this help message and exit |
Table 19.41. Output formatter options
| Value | Summary |
|---|---|
| -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 options
| Value | Summary |
|---|---|
| --noindent | Whether to disable indenting the json |
Table 19.43. Shell formatter options
| Value | Summary |
|---|---|
| --prefix PREFIX | Add a prefix to all variable names |
Table 19.44. Table formatter options
| Value | Summary |
|---|---|
| --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. |