Chapter 11. block
This chapter describes the commands under the block command.
11.1. block storage cleanup Copy linkLink copied to clipboard!
Do block storage cleanup. This command requires ``--os-volume-api-version`` 3.24 or greater.
Usage:
| Value | Summary |
|---|---|
| -h, --help | Show this help message and exit |
| --cluster <cluster> | Name of block storage cluster in which cleanup needs to be performed (name only) |
| --host <host> | Host where the service resides. (name only) |
| --binary <binary> | Name of the service binary. |
| --up | Filter by up status. if this is set, services need to be up. |
| --down | Filter by down status. if this is set, services need to be down. |
| --disabled | Filter by disabled status. |
| --enabled | Filter by enabled status. |
| --resource-id <resource-id> | Uuid of a resource to cleanup. |
| --resource-type <Volume|Snapshot> | Type of resource to cleanup. |
| --service-id SERVICE_ID | The service id field from the db, not the uuid of the service. |
| 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 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 |
| Value | Summary |
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
| Value | Summary |
|---|---|
| --noindent | Whether to disable indenting the json |
| 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. |
11.2. block storage cluster list Copy linkLink copied to clipboard!
List block storage clusters. This command requires ``--os-volume-api-version`` 3.7 or greater.
Usage:
| Value | Summary |
|---|---|
| -h, --help | Show this help message and exit |
| --cluster <name> | Filter by cluster name, without backend will list all clustered services from the same cluster. |
| --binary <binary> | Cluster binary. |
| --up | Filter by up status. |
| --down | Filter by down status. |
| --disabled | Filter by disabled status. |
| --enabled | Filter by enabled status. |
| --num-hosts <hosts> | Filter by number of hosts in the cluster. |
| --num-down-hosts <hosts> | Filter by number of hosts that are down. |
| --long | List additional fields in output |
| 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 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 |
| Value | Summary |
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
| Value | Summary |
|---|---|
| --noindent | Whether to disable indenting the json |
| 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. |
11.3. block storage cluster set Copy linkLink copied to clipboard!
Set block storage cluster properties. This command requires ``--os-volume-api- version`` 3.7 or greater.
Usage:
openstack block storage cluster set [-h] [--binary <binary>]
[--enable | --disable]
[--disable-reason <reason>]
<cluster>
openstack block storage cluster set [-h] [--binary <binary>]
[--enable | --disable]
[--disable-reason <reason>]
<cluster>
| Value | Summary |
|---|---|
| <cluster> | Name of block storage cluster to update (name only) |
| Value | Summary |
|---|---|
| -h, --help | Show this help message and exit |
| --binary <binary> | Name of binary to filter by; defaults to cinder- volume (optional) |
| --enable | Enable cluster |
| --disable | Disable cluster |
| --disable-reason <reason> | Reason for disabling the cluster (should be used with --disable option) |
11.4. block storage cluster show Copy linkLink copied to clipboard!
Show detailed information for a block storage cluster. This command requires ``--os-volume-api-version`` 3.7 or greater.
Usage:
| Value | Summary |
|---|---|
| <cluster> | Name of block storage cluster. |
| Value | Summary |
|---|---|
| -h, --help | Show this help message and exit |
| --binary <binary> | Service binary. |
| 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 to show multiple columns |
| Value | Summary |
|---|---|
| --noindent | Whether to disable indenting the json |
| Value | Summary |
|---|---|
| --prefix PREFIX | Add a prefix to all variable names |
| 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. |
11.5. block storage log level list Copy linkLink copied to clipboard!
List log levels of block storage service. Supported by --os-volume-api-version 3.32 or greater.
Usage:
| Value | Summary |
|---|---|
| -h, --help | Show this help message and exit |
| --host <host> | List block storage service log level of specified host (name only) |
| --service <service> | List block storage service log level of the specified service (name only) |
| --log-prefix <log-prefix> | Prefix for the log, e.g. sqlalchemy |
| 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 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 |
| Value | Summary |
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
| Value | Summary |
|---|---|
| --noindent | Whether to disable indenting the json |
| 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. |
11.6. block storage log level set Copy linkLink copied to clipboard!
Set log level of block storage service Supported by --os-volume-api-version 3.32 or greater.
Usage:
openstack block storage log level set [-h] [--host <host>]
[--service <service>]
[--log-prefix <log-prefix>]
<log-level>
openstack block storage log level set [-h] [--host <host>]
[--service <service>]
[--log-prefix <log-prefix>]
<log-level>
| Value | Summary |
|---|---|
| <log-level> | Desired log level. |
| Value | Summary |
|---|---|
| -h, --help | Show this help message and exit |
| --host <host> | Set block storage service log level of specified host (name only) |
| --service <service> | Set block storage service log level of specified service (name only) |
| --log-prefix <log-prefix> | Prefix for the log, e.g. sqlalchemy |
11.7. block storage resource filter list Copy linkLink copied to clipboard!
List block storage resource filters
Usage:
| Value | Summary |
|---|---|
| -h, --help | Show this help message and exit |
| 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 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 |
| Value | Summary |
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
| Value | Summary |
|---|---|
| --noindent | Whether to disable indenting the json |
| 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. |
11.8. block storage resource filter show Copy linkLink copied to clipboard!
Show filters for a block storage resource type
Usage:
| Value | Summary |
|---|---|
| <resource> | Resource to show filters for (name). |
| Value | Summary |
|---|---|
| -h, --help | Show this help message and exit |
| 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 to show multiple columns |
| Value | Summary |
|---|---|
| --noindent | Whether to disable indenting the json |
| Value | Summary |
|---|---|
| --prefix PREFIX | Add a prefix to all variable names |
| 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. |
11.9. block storage snapshot manageable list Copy linkLink copied to clipboard!
List manageable snapshots. Supported by --os-volume-api-version 3.8 or greater.
Usage:
| Value | Summary |
|---|---|
| <host> | Cinder host on which to list manageable snapshots. Takes the form: host@backend-name#pool |
| Value | Summary |
|---|---|
| -h, --help | Show this help message and exit |
| --cluster <cluster> | Cinder cluster on which to list manageable snapshots. Takes the form: cluster@backend-name#pool. (supported by --os-volume-api-version 3.17 or later) |
| --detailed <detailed> | Returns detailed information (default=true). |
| --marker <marker> | Begin returning snapshots that appear later in the snapshot list than that represented by this reference. This reference should be json like. Default=None. |
| --limit <limit> | Maximum number of snapshots to return. default=none. |
| --offset <offset> | Number of snapshots to skip after marker. Default=None. |
| --sort <key>[:<direction>] | Comma-separated list of sort keys and directions in the form of <key>[:<asc|desc>]. Valid keys: size, reference. Default=None. |
| 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 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 |
| Value | Summary |
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
| Value | Summary |
|---|---|
| --noindent | Whether to disable indenting the json |
| 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. |
11.10. block storage volume manageable list Copy linkLink copied to clipboard!
List manageable volumes. Supported by --os-volume-api-version 3.8 or greater.
Usage:
| Value | Summary |
|---|---|
| <host> | Cinder host on which to list manageable volumes. takes the form: host@backend-name#pool |
| Value | Summary |
|---|---|
| -h, --help | Show this help message and exit |
| --cluster <cluster> | Cinder cluster on which to list manageable volumes. Takes the form: cluster@backend-name#pool. (supported by --os-volume-api-version 3.17 or later) |
| --detailed <detailed> | Returns detailed information (default=true). |
| --marker <marker> | Begin returning volumes that appear later in the volume list than that represented by this reference. This reference should be json like. Default=None. |
| --limit <limit> | Maximum number of volumes to return. default=none. |
| --offset <offset> | Number of volumes to skip after marker. default=none. |
| --sort <key>[:<direction>] | Comma-separated list of sort keys and directions in the form of <key>[:<asc|desc>]. Valid keys: size, reference. Default=None. |
| 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 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 |
| Value | Summary |
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
| Value | Summary |
|---|---|
| --noindent | Whether to disable indenting the json |
| 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. |