Dieser Inhalt ist in der von Ihnen ausgewählten Sprache nicht verfügbar.
Chapter 71. volume
This chapter describes the commands under the volume
command.
71.1. volume backup create Link kopierenLink in die Zwischenablage kopiert!
Create new volume backup
Usage:
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
<volume> | Volume to backup (name or id) |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--force | Allow to back up an in-use volume |
--incremental | Perform an incremental backup |
--name <name> | Name of the backup |
--container <container> | Optional backup container name |
--snapshot <snapshot> | Snapshot to backup (name or id) |
-h, --help | Show this help message and exit |
--description <description> | Description of the backup |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
71.2. volume backup delete Link kopierenLink in die Zwischenablage kopiert!
Delete volume backup(s)
Usage:
openstack volume backup delete [-h] [--force] <backup> [<backup> ...]
openstack volume backup delete [-h] [--force] <backup> [<backup> ...]
Value | Summary |
---|---|
<backup> | Backup(s) to delete (name or id) |
Value | Summary |
---|---|
--force | Allow delete in state other than error or available |
-h, --help | Show this help message and exit |
71.3. volume backup list Link kopierenLink in die Zwischenablage kopiert!
List volume backups
Usage:
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--marker <volume-backup> | The last backup of the previous page (name or id) |
--limit <num-backups> | Maximum number of backups to display |
--all-projects | Include all projects (admin only) |
--volume <volume> | Filters results by the volume which they backup (name or ID) |
--long | List additional fields in output |
--status <status> | Filters results by the backup status (creating, available, deleting, error, restoring or error_restoring) |
--name <name> | Filters results by the backup name |
-h, --help | Show this help message and exit |
71.4. volume backup restore Link kopierenLink in die Zwischenablage kopiert!
Restore volume backup
Usage:
openstack volume backup restore [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--max-width <integer>] [--fit-width] [--print-empty] [--noindent] [--prefix PREFIX] <backup> <volume>
openstack volume backup restore [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--max-width <integer>]
[--fit-width] [--print-empty]
[--noindent] [--prefix PREFIX]
<backup> <volume>
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
<volume> | Volume to restore to (name or id) |
<backup> | Backup to restore (name or id) |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
71.5. volume backup set Link kopierenLink in die Zwischenablage kopiert!
Set volume backup properties
Usage:
openstack volume backup set [-h] [--name <name>] [--description <description>] [--state <state>] <backup>
openstack volume backup set [-h] [--name <name>]
[--description <description>]
[--state <state>]
<backup>
Value | Summary |
---|---|
<backup> | Backup to modify (name or id) |
Value | Summary |
---|---|
--name <name> | New backup name |
-h, --help | Show this help message and exit |
--description <description> | New backup description |
--state <state> | New backup state ("available" or "error") (admin only) (This option simply changes the state of the backup in the database with no regard to actual status, exercise caution when using) |
71.6. volume backup show Link kopierenLink in die Zwischenablage kopiert!
Display volume backup details
Usage:
openstack volume backup show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--max-width <integer>] [--fit-width] [--print-empty] [--noindent] [--prefix PREFIX] <backup>
openstack volume backup show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--max-width <integer>]
[--fit-width] [--print-empty] [--noindent]
[--prefix PREFIX]
<backup>
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
<backup> | Backup to display (name or id) |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
71.7. volume create Link kopierenLink in die Zwischenablage kopiert!
Create new volume
Usage:
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
<name> | Volume name |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--property <key=value> | Set a property to this volume (repeat option to set multiple properties) |
--bootable | Mark volume as bootable |
--non-bootable | Mark volume as non-bootable (default) |
--type <volume-type> | Set the type of volume |
--availability-zone <availability-zone> | Create volume in <availability-zone> |
--read-only | Set volume to read-only access mode |
--consistency-group consistency-group> | Consistency group where the new volume belongs to |
--size <size> | Volume size in gb (required unless --snapshot or --source or --source-replicated is specified) |
--hint <key=value> | Arbitrary scheduler hint key-value pairs to help boot an instance (repeat option to set multiple hints) |
--multi-attach | Allow volume to be attached more than once (default to False) |
--read-write | Set volume to read-write access mode (default) |
--image <image> | Use <image> as source of volume (name or id) |
--source <volume> | Volume to clone (name or id) |
--user <user> | Specify an alternate user (name or id) |
--snapshot <snapshot> | Use <snapshot> as source of volume (name or id) |
-h, --help | Show this help message and exit |
--description <description> | Volume description |
--project <project> | Specify an alternate project (name or id) |
--source-replicated <replicated-volume> | Replicated volume to clone (name or id) |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
71.8. volume delete Link kopierenLink in die Zwischenablage kopiert!
Delete volume(s)
Usage:
openstack volume delete [-h] [--force | --purge] <volume> [<volume> ...]
openstack volume delete [-h] [--force | --purge]
<volume> [<volume> ...]
Value | Summary |
---|---|
<volume> | Volume(s) to delete (name or id) |
Value | Summary |
---|---|
--force | Attempt forced removal of volume(s), regardless of state (defaults to False) |
-h, --help | Show this help message and exit |
--purge | Remove any snapshots along with volume(s) (defaults to false) |
71.9. volume host failover Link kopierenLink in die Zwischenablage kopiert!
Failover volume host to different backend
Usage:
openstack volume host failover [-h] --volume-backend <backend-id> <host-name>
openstack volume host failover [-h] --volume-backend <backend-id>
<host-name>
Value | Summary |
---|---|
<host-name> | Name of volume host |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--volume-backend <backend-id> | The id of the volume backend replication target where the host will failover to (required) |
71.10. volume host set Link kopierenLink in die Zwischenablage kopiert!
Set volume host properties
Usage:
openstack volume host set [-h] [--disable | --enable] <host-name>
openstack volume host set [-h] [--disable | --enable] <host-name>
Value | Summary |
---|---|
<host-name> | Name of volume host |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--disable | Freeze and disable the specified volume host |
--enable | Thaw and enable the specified volume host |
71.11. volume list Link kopierenLink in die Zwischenablage kopiert!
List volumes
Usage:
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--limit <num-volumes> | Maximum number of volumes to display |
--name <name> | Filter results by volume name |
--all-projects | Include all projects (admin only) |
--user <user> | Filter results by user (name or id) (admin only) |
--long | List additional fields in output |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--status <status> | Filter results by status |
--marker <volume> | The last volume id of the previous page |
--user-domain <user-domain> | Domain the user belongs to (name or id). this can be used in case collisions between user names exist. |
-h, --help | Show this help message and exit |
--project <project> | Filter results by project (name or id) (admin only) |
71.12. volume migrate Link kopierenLink in die Zwischenablage kopiert!
Migrate volume to a new host
Usage:
openstack volume migrate [-h] --host <host> [--force-host-copy] [--lock-volume | --unlock-volume] <volume>
openstack volume migrate [-h] --host <host> [--force-host-copy]
[--lock-volume | --unlock-volume]
<volume>
Value | Summary |
---|---|
<volume> | Volume to migrate (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--lock-volume | If specified, the volume state will be locked and will not allow a migration to be aborted (possibly by another operation) |
--host <host> | Destination host (takes the form: host@backend-name#pool) |
--unlock-volume | If specified, the volume state will not be locked and the a migration can be aborted (default) (possibly by another operation) |
--force-host-copy | Enable generic host-based force-migration, which bypasses driver optimizations |
71.13. volume qos associate Link kopierenLink in die Zwischenablage kopiert!
Associate a QoS specification to a volume type
Usage:
openstack volume qos associate [-h] <qos-spec> <volume-type>
openstack volume qos associate [-h] <qos-spec> <volume-type>
Value | Summary |
---|---|
<volume-type> | Volume type to associate the qos (name or id) |
<qos-spec> | Qos specification to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
71.14. volume qos create Link kopierenLink in die Zwischenablage kopiert!
Create new QoS specification
Usage:
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
<name> | New qos specification name |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--consumer <consumer> | Consumer of the qos. valid consumers: back-end, both, front-end (defaults to both) |
-h, --help | Show this help message and exit |
--property <key=value> | Set a qos specification property (repeat option to set multiple properties) |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
71.15. volume qos delete Link kopierenLink in die Zwischenablage kopiert!
Delete QoS specification
Usage:
openstack volume qos delete [-h] [--force] <qos-spec> [<qos-spec> ...]
openstack volume qos delete [-h] [--force] <qos-spec> [<qos-spec> ...]
Value | Summary |
---|---|
<qos-spec> | Qos specification(s) to delete (name or id) |
Value | Summary |
---|---|
--force | Allow to delete in-use qos specification(s) |
-h, --help | Show this help message and exit |
71.16. volume qos disassociate Link kopierenLink in die Zwischenablage kopiert!
Disassociate a QoS specification from a volume type
Usage:
openstack volume qos disassociate [-h] [--volume-type <volume-type> | --all] <qos-spec>
openstack volume qos disassociate [-h]
[--volume-type <volume-type> | --all]
<qos-spec>
Value | Summary |
---|---|
<qos-spec> | Qos specification to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--volume-type <volume-type> | Volume type to disassociate the qos from (name or id) |
--all | Disassociate the qos from every volume type |
71.17. volume qos list Link kopierenLink in die Zwischenablage kopiert!
List QoS specifications
Usage:
openstack volume qos 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]
openstack volume qos 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]
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
71.18. volume qos set Link kopierenLink in die Zwischenablage kopiert!
Set QoS specification properties
Usage:
openstack volume qos set [-h] [--property <key=value>] <qos-spec>
openstack volume qos set [-h] [--property <key=value>] <qos-spec>
Value | Summary |
---|---|
<qos-spec> | Qos specification to modify (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--property <key=value> | Property to add or modify for this qos specification (repeat option to set multiple properties) |
71.19. volume qos show Link kopierenLink in die Zwischenablage kopiert!
Display QoS specification details
Usage:
openstack volume qos show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--max-width <integer>] [--fit-width] [--print-empty] [--noindent] [--prefix PREFIX] <qos-spec>
openstack volume qos show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--max-width <integer>]
[--fit-width] [--print-empty] [--noindent]
[--prefix PREFIX]
<qos-spec>
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
<qos-spec> | Qos specification to display (name or id) |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
71.20. volume qos unset Link kopierenLink in die Zwischenablage kopiert!
Unset QoS specification properties
Usage:
openstack volume qos unset [-h] [--property <key>] <qos-spec>
openstack volume qos unset [-h] [--property <key>] <qos-spec>
Value | Summary |
---|---|
<qos-spec> | Qos specification to modify (name or id) |
Value | Summary |
---|---|
--property <key> | Property to remove from the qos specification. (repeat option to unset multiple properties) |
-h, --help | Show this help message and exit |
71.21. volume service list Link kopierenLink in die Zwischenablage kopiert!
List service command
Usage:
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--host <host> | List services on specified host (name only) |
--long | List additional fields in output |
--service <service> | List only specified service (name only) |
71.22. volume service set Link kopierenLink in die Zwischenablage kopiert!
Set volume service properties
Usage:
openstack volume service set [-h] [--enable | --disable] [--disable-reason <reason>] <host> <service>
openstack volume service set [-h] [--enable | --disable]
[--disable-reason <reason>]
<host> <service>
Value | Summary |
---|---|
<service> | Name of service (binary name) |
<host> | Name of host |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--disable | Disable volume service |
--disable-reason <reason> | Reason for disabling the service (should be used with --disable option) |
--enable | Enable volume service |
71.23. volume set Link kopierenLink in die Zwischenablage kopiert!
Set volume properties
Usage:
Value | Summary |
---|---|
<volume> | Volume to modify (name or id) |
Value | Summary |
---|---|
--bootable | Mark volume as bootable |
--non-bootable | Mark volume as non-bootable |
--state <state> | New volume state ("available", "error", "creating", "deleting", "in-use", "attaching", "detaching", "error_deleting" or "maintenance") (admin only) (This option simply changes the state of the volume in the database with no regard to actual status, exercise caution when using) |
--name <name> | New volume name |
--property <key=value> | Set a property on this volume (repeat option to set multiple properties) |
--size <size> | Extend volume size in gb |
--read-only | Set volume to read-only access mode |
--read-write | Set volume to read-write access mode |
--no-property | Remove all properties from <volume> (specify both --no-property and --property to remove the current properties before setting new properties.) |
--type <volume-type> | New volume type (name or id) |
--image-property <key=value> | Set an image property on this volume (repeat option to set multiple image properties) |
-h, --help | Show this help message and exit |
--description <description> | New volume description |
--retype-policy <retype-policy> | Migration policy while re-typing volume ("never" or "on-demand", default is "never" ) (available only when --type option is specified) |
71.24. volume show Link kopierenLink in die Zwischenablage kopiert!
Display volume details
Usage:
openstack volume show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--max-width <integer>] [--fit-width] [--print-empty] [--noindent] [--prefix PREFIX] <volume>
openstack volume show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--max-width <integer>] [--fit-width]
[--print-empty] [--noindent] [--prefix PREFIX]
<volume>
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
<volume> | Volume to display (name or id) |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
71.25. volume snapshot create Link kopierenLink in die Zwischenablage kopiert!
Create new volume snapshot
Usage:
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
<snapshot-name> | Name of the new snapshot |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--force | Create a snapshot attached to an instance. default is False |
--volume <volume> | Volume to snapshot (name or id) (default is <snapshot- name>) |
--property <key=value> | Set a property to this snapshot (repeat option to set multiple properties) |
--remote-source <key=value> | The attribute(s) of the exsiting remote volume snapshot (admin required) (repeat option to specify multiple attributes) e.g.: --remote-source source- name=test_name --remote-source source-id=test_id |
-h, --help | Show this help message and exit |
--description <description> | Description of the snapshot |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
71.26. volume snapshot delete Link kopierenLink in die Zwischenablage kopiert!
Delete volume snapshot(s)
Usage:
openstack volume snapshot delete [-h] [--force] <snapshot> [<snapshot> ...]
openstack volume snapshot delete [-h] [--force]
<snapshot> [<snapshot> ...]
Value | Summary |
---|---|
<snapshot> | Snapshot(s) to delete (name or id) |
Value | Summary |
---|---|
--force | Attempt forced removal of snapshot(s), regardless of state (defaults to False) |
-h, --help | Show this help message and exit |
71.27. volume snapshot list Link kopierenLink in die Zwischenablage kopiert!
List volume snapshots
Usage:
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--status <status> | Filters results by a status. (available, error, creating, deleting or error-deleting) |
--all-projects | Include all projects (admin only) |
--name <name> | Filters results by a name. |
--long | List additional fields in output |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--marker <volume-snapshot> | The last snapshot id of the previous page |
--limit <num-snapshots> | Maximum number of snapshots to display |
--volume <volume> | Filters results by a volume (name or id). |
-h, --help | Show this help message and exit |
--project <project> | Filter results by project (name or id) (admin only) |
71.28. volume snapshot set Link kopierenLink in die Zwischenablage kopiert!
Set volume snapshot properties
Usage:
openstack volume snapshot set [-h] [--name <name>] [--description <description>] [--no-property] [--property <key=value>] [--state <state>] <snapshot>
openstack volume snapshot set [-h] [--name <name>]
[--description <description>]
[--no-property] [--property <key=value>]
[--state <state>]
<snapshot>
Value | Summary |
---|---|
<snapshot> | Snapshot to modify (name or id) |
Value | Summary |
---|---|
--name <name> | New snapshot name |
--property <key=value> | Property to add/change for this snapshot (repeat option to set multiple properties) |
--state <state> | New snapshot state. ("available", "error", "creating", "deleting", or "error_deleting") (admin only) (This option simply changes the state of the snapshot in the database with no regard to actual status, exercise caution when using) |
--no-property | Remove all properties from <snapshot> (specify both --no-property and --property to remove the current properties before setting new properties.) |
-h, --help | Show this help message and exit |
--description <description> | New snapshot description |
71.29. volume snapshot show Link kopierenLink in die Zwischenablage kopiert!
Display volume snapshot details
Usage:
openstack volume snapshot show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--max-width <integer>] [--fit-width] [--print-empty] [--noindent] [--prefix PREFIX] <snapshot>
openstack volume snapshot show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--max-width <integer>]
[--fit-width] [--print-empty]
[--noindent] [--prefix PREFIX]
<snapshot>
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
<snapshot> | Snapshot to display (name or id) |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
71.30. volume snapshot unset Link kopierenLink in die Zwischenablage kopiert!
Unset volume snapshot properties
Usage:
openstack volume snapshot unset [-h] [--property <key>] <snapshot>
openstack volume snapshot unset [-h] [--property <key>] <snapshot>
Value | Summary |
---|---|
<snapshot> | Snapshot to modify (name or id) |
Value | Summary |
---|---|
--property <key> | Property to remove from snapshot (repeat option to remove multiple properties) |
-h, --help | Show this help message and exit |
71.31. volume transfer request accept Link kopierenLink in die Zwischenablage kopiert!
Accept volume transfer request.
Usage:
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
<transfer-request-id> | Volume transfer request to accept (id only) |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--auth-key <key> | Volume transfer request authentication key |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
71.32. volume transfer request create Link kopierenLink in die Zwischenablage kopiert!
Create volume transfer request.
Usage:
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
<volume> | Volume to transfer (name or id) |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--name <name> | New transfer request name (default to none) |
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
71.33. volume transfer request delete Link kopierenLink in die Zwischenablage kopiert!
Delete volume transfer request(s).
Usage:
openstack volume transfer request delete [-h] <transfer-request> [<transfer-request> ...]
openstack volume transfer request delete [-h]
<transfer-request>
[<transfer-request> ...]
Value | Summary |
---|---|
<transfer-request> | Volume transfer request(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
71.34. volume transfer request list Link kopierenLink in die Zwischenablage kopiert!
Lists all volume transfer requests.
Usage:
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--all-projects | Include all projects (admin only) |
-h, --help | Show this help message and exit |
71.35. volume transfer request show Link kopierenLink in die Zwischenablage kopiert!
Show volume transfer request details.
Usage:
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
<transfer-request> | Volume transfer request to display (name or id) |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
71.36. volume type create Link kopierenLink in die Zwischenablage kopiert!
Create new volume type
Usage:
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
<name> | Volume type name |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--public | Volume type is accessible to the public |
--private | Volume type is not accessible to the public |
--encryption-key-size <key-size> | Set the size of the encryption key of this volume type (e.g "128" or "256") (admin only) |
--property <key=value> | Set a property on this volume type (repeat option to set multiple properties) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--encryption-control-location <control-location> | Set the notional service where the encryption is performed ("front-end" or "back-end") (admin only) (The default value for this option is "front-end" when setting encryption type of a volume. Consider using other encryption options such as: "--encryption- cipher", "--encryption-key-size" and "--encryption- provider") |
--encryption-provider <provider> | Set the class that provides encryption support for this volume type (e.g "LuksEncryptor") (admin only) (This option is required when setting encryption type of a volume. Consider using other encryption options such as: "--encryption-cipher", "--encryption-key- size" and "--encryption-control-location") |
--encryption-cipher <cipher> | Set the encryption algorithm or mode for this volume type (e.g "aes-xts-plain64") (admin only) |
-h, --help | Show this help message and exit |
--description <description> | Volume type description |
--project <project> | Allow <project> to access private type (name or id) (Must be used with --private option) |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
71.37. volume type delete Link kopierenLink in die Zwischenablage kopiert!
Delete volume type(s)
Usage:
openstack volume type delete [-h] <volume-type> [<volume-type> ...]
openstack volume type delete [-h] <volume-type> [<volume-type> ...]
Value | Summary |
---|---|
<volume-type> | Volume type(s) to delete (name or id) |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
71.38. volume type list Link kopierenLink in die Zwischenablage kopiert!
List volume types
Usage:
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
--quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
--public | List only public types |
--private | List only private types (admin only) |
--long | List additional fields in output |
--default | List the default volume type |
-h, --help | Show this help message and exit |
--encryption-type | Display encryption information for each volume type (admin only) |
71.39. volume type set Link kopierenLink in die Zwischenablage kopiert!
Set volume type properties
Usage:
Value | Summary |
---|---|
<volume-type> | Volume type to modify (name or id) |
Value | Summary |
---|---|
--encryption-key-size <key-size> | Set the size of the encryption key of this volume type (e.g "128" or "256") (admin only) |
--name <name> | Set volume type name |
--property <key=value> | Set a property on this volume type (repeat option to set multiple properties) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
--encryption-control-location <control-location> | Set the notional service where the encryption is performed ("front-end" or "back-end") (admin only) (The default value for this option is "front-end" when setting encryption type of a volume for the first time. Consider using other encryption options such as: "--encryption-cipher", "--encryption-key-size" and "--encryption-provider") |
--encryption-provider <provider> | Set the class that provides encryption support for this volume type (e.g "LuksEncryptor") (admin only) (This option is required when setting encryption type of a volume for the first time. Consider using other encryption options such as: "--encryption-cipher", "--encryption-key-size" and "--encryption-control- location") |
--encryption-cipher <cipher> | Set the encryption algorithm or mode for this volume type (e.g "aes-xts-plain64") (admin only) |
-h, --help | Show this help message and exit |
--description <description> | Set volume type description |
--project <project> | Set volume type access to project (name or id) (admin only) |
71.40. volume type show Link kopierenLink in die Zwischenablage kopiert!
Display volume type details
Usage:
openstack volume type show [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN] [--max-width <integer>] [--fit-width] [--print-empty] [--noindent] [--prefix PREFIX] [--encryption-type] <volume-type>
openstack volume type show [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--max-width <integer>]
[--fit-width] [--print-empty] [--noindent]
[--prefix PREFIX] [--encryption-type]
<volume-type>
Value | Summary |
---|---|
--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 |
Value | Summary |
---|---|
<volume-type> | Volume type to display (name or id) |
Value | Summary |
---|---|
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 |
Value | Summary |
---|---|
--noindent | Whether to disable indenting the json |
Value | Summary |
---|---|
-h, --help | Show this help message and exit |
--encryption-type | Display encryption information of this volume type (admin only) |
Value | Summary |
---|---|
a format a UNIX shell can parse (variable="value")--prefix PREFIX | Add a prefix to all variable names |
71.41. volume type unset Link kopierenLink in die Zwischenablage kopiert!
Unset volume type properties
Usage:
openstack volume type unset [-h] [--property <key>] [--project <project>] [--project-domain <project-domain>] [--encryption-type] <volume-type>
openstack volume type unset [-h] [--property <key>]
[--project <project>]
[--project-domain <project-domain>]
[--encryption-type]
<volume-type>
Value | Summary |
---|---|
<volume-type> | Volume type to modify (name or id) |
Value | Summary |
---|---|
--property <key> | Remove a property from this volume type (repeat option to remove multiple properties) |
-h, --help | Show this help message and exit |
--encryption-type | Remove the encryption type for this volume type (admin only) |
--project <project> | Removes volume type access to project (name or id) (admin only) |
--project-domain <project-domain> | Domain the project belongs to (name or id). this can be used in case collisions between project names exist. |
71.42. volume unset Link kopierenLink in die Zwischenablage kopiert!
Unset volume properties
Usage:
openstack volume unset [-h] [--property <key>] [--image-property <key>] <volume>
openstack volume unset [-h] [--property <key>] [--image-property <key>]
<volume>
Value | Summary |
---|---|
<volume> | Volume to modify (name or id) |
Value | Summary |
---|---|
--property <key> | Remove a property from volume (repeat option to remove multiple properties) |
-h, --help | Show this help message and exit |
--image-property <key> | Remove an image property from volume (repeat option to remove multiple image properties) |