5150 lines
109 KiB
ReStructuredText
5150 lines
109 KiB
ReStructuredText
.. ## WARNING ######################################
|
|
.. This file is automatically generated, do not edit
|
|
.. #################################################
|
|
|
|
=========================================
|
|
Block Storage service command-line client
|
|
=========================================
|
|
|
|
The cinder client is the command-line interface (CLI) for
|
|
the Block Storage service API and its extensions.
|
|
|
|
This chapter documents :command:`cinder` version ``1.5.0``.
|
|
|
|
For help on a specific :command:`cinder` command, enter:
|
|
|
|
.. code-block:: console
|
|
|
|
$ cinder help COMMAND
|
|
|
|
.. _cinder_command_usage:
|
|
|
|
cinder usage
|
|
~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder [--version] [-d] [--os-auth-system <auth-system>]
|
|
[--service-type <service-type>] [--service-name <service-name>]
|
|
[--volume-service-name <volume-service-name>]
|
|
[--os-endpoint-type <os-endpoint-type>]
|
|
[--endpoint-type <endpoint-type>]
|
|
[--os-volume-api-version <volume-api-ver>]
|
|
[--bypass-url <bypass-url>] [--retries <retries>]
|
|
[--os-auth-strategy <auth-strategy>]
|
|
[--os-username <auth-user-name>] [--os-password <auth-password>]
|
|
[--os-tenant-name <auth-tenant-name>]
|
|
[--os-tenant-id <auth-tenant-id>] [--os-auth-url <auth-url>]
|
|
[--os-user-id <auth-user-id>]
|
|
[--os-user-domain-id <auth-user-domain-id>]
|
|
[--os-user-domain-name <auth-user-domain-name>]
|
|
[--os-project-id <auth-project-id>]
|
|
[--os-project-name <auth-project-name>]
|
|
[--os-project-domain-id <auth-project-domain-id>]
|
|
[--os-project-domain-name <auth-project-domain-name>]
|
|
[--os-region-name <region-name>] [--os-token <token>]
|
|
[--os-url <url>] [--insecure] [--os-cacert <ca-certificate>]
|
|
[--os-cert <certificate>] [--os-key <key>] [--timeout <seconds>]
|
|
<subcommand> ...
|
|
|
|
Subcommands
|
|
-----------
|
|
|
|
``absolute-limits``
|
|
Lists absolute limits for a user.
|
|
|
|
``availability-zone-list``
|
|
Lists all availability zones.
|
|
|
|
``backup-create``
|
|
Creates a volume backup.
|
|
|
|
``backup-delete``
|
|
Removes a backup.
|
|
|
|
``backup-export``
|
|
Export backup metadata record.
|
|
|
|
``backup-import``
|
|
Import backup metadata record.
|
|
|
|
``backup-list``
|
|
Lists all backups.
|
|
|
|
``backup-reset-state``
|
|
Explicitly updates the backup state.
|
|
|
|
``backup-restore``
|
|
Restores a backup.
|
|
|
|
``backup-show``
|
|
Shows backup details.
|
|
|
|
``cgsnapshot-create``
|
|
Creates a cgsnapshot.
|
|
|
|
``cgsnapshot-delete``
|
|
Removes one or more cgsnapshots.
|
|
|
|
``cgsnapshot-list``
|
|
Lists all cgsnapshots.
|
|
|
|
``cgsnapshot-show``
|
|
Shows cgsnapshot details.
|
|
|
|
``consisgroup-create``
|
|
Creates a consistency group.
|
|
|
|
``consisgroup-create-from-src``
|
|
Creates a consistency group from a cgsnapshot or a
|
|
source CG.
|
|
|
|
``consisgroup-delete``
|
|
Removes one or more consistency groups.
|
|
|
|
``consisgroup-list``
|
|
Lists all consistencygroups.
|
|
|
|
``consisgroup-show``
|
|
Shows details of a consistency group.
|
|
|
|
``consisgroup-update``
|
|
Updates a consistencygroup.
|
|
|
|
``create``
|
|
Creates a volume.
|
|
|
|
``credentials``
|
|
Shows user credentials returned from auth.
|
|
|
|
``delete``
|
|
Removes one or more volumes.
|
|
|
|
``encryption-type-create``
|
|
Creates encryption type for a volume type. Admin only.
|
|
|
|
``encryption-type-delete``
|
|
Deletes encryption type for a volume type. Admin only.
|
|
|
|
``encryption-type-list``
|
|
Shows encryption type details for volume types. Admin
|
|
only.
|
|
|
|
``encryption-type-show``
|
|
Shows encryption type details for a volume type. Admin
|
|
only.
|
|
|
|
``encryption-type-update``
|
|
Update encryption type information for a volume type
|
|
(Admin Only).
|
|
|
|
``endpoints``
|
|
Discovers endpoints registered by authentication
|
|
service.
|
|
|
|
``extend``
|
|
Attempts to extend size of an existing volume.
|
|
|
|
``extra-specs-list``
|
|
Lists current volume types and extra specs.
|
|
|
|
``force-delete``
|
|
Attempts force-delete of volume, regardless of state.
|
|
|
|
``get-capabilities``
|
|
Show backend volume stats and properties. Admin only.
|
|
|
|
``get-pools``
|
|
Show pool information for backends. Admin only.
|
|
|
|
``image-metadata``
|
|
Sets or deletes volume image metadata.
|
|
|
|
``image-metadata-show``
|
|
Shows volume image metadata.
|
|
|
|
``list``
|
|
Lists all volumes.
|
|
|
|
``manage``
|
|
Manage an existing volume.
|
|
|
|
``metadata``
|
|
Sets or deletes volume metadata.
|
|
|
|
``metadata-show``
|
|
Shows volume metadata.
|
|
|
|
``metadata-update-all``
|
|
Updates volume metadata.
|
|
|
|
``migrate``
|
|
Migrates volume to a new host.
|
|
|
|
``qos-associate``
|
|
Associates qos specs with specified volume type.
|
|
|
|
``qos-create``
|
|
Creates a qos specs.
|
|
|
|
``qos-delete``
|
|
Deletes a specified qos specs.
|
|
|
|
``qos-disassociate``
|
|
Disassociates qos specs from specified volume type.
|
|
|
|
``qos-disassociate-all``
|
|
Disassociates qos specs from all its associations.
|
|
|
|
``qos-get-association``
|
|
Lists all associations for specified qos specs.
|
|
|
|
``qos-key``
|
|
Sets or unsets specifications for a qos spec.
|
|
|
|
``qos-list``
|
|
Lists qos specs.
|
|
|
|
``qos-show``
|
|
Shows qos specs details.
|
|
|
|
``quota-class-show``
|
|
Lists quotas for a quota class.
|
|
|
|
``quota-class-update``
|
|
Updates quotas for a quota class.
|
|
|
|
``quota-defaults``
|
|
Lists default quotas for a tenant.
|
|
|
|
``quota-delete``
|
|
Delete the quotas for a tenant.
|
|
|
|
``quota-show``
|
|
Lists quotas for a tenant.
|
|
|
|
``quota-update``
|
|
Updates quotas for a tenant.
|
|
|
|
``quota-usage``
|
|
Lists quota usage for a tenant.
|
|
|
|
``rate-limits``
|
|
Lists rate limits for a user.
|
|
|
|
``readonly-mode-update``
|
|
Updates volume read-only access-mode flag.
|
|
|
|
``rename``
|
|
Renames a volume.
|
|
|
|
``replication-disable``
|
|
Disables volume replication on a given volume.
|
|
|
|
``replication-enable``
|
|
Enables volume replication on a given volume.
|
|
|
|
``replication-failover``
|
|
Failover a volume to a secondary target
|
|
|
|
``replication-list-targets``
|
|
List replication targets available for a volume.
|
|
|
|
``replication-promote``
|
|
Promote a secondary volume to primary for a
|
|
relationship.
|
|
|
|
``replication-reenable``
|
|
Sync the secondary volume with primary for a
|
|
relationship.
|
|
|
|
``reset-state``
|
|
Explicitly updates the volume state in the Cinder
|
|
database.
|
|
|
|
``retype``
|
|
Changes the volume type for a volume.
|
|
|
|
``service-disable``
|
|
Disables the service.
|
|
|
|
``service-enable``
|
|
Enables the service.
|
|
|
|
``service-list``
|
|
Lists all services. Filter by host and service binary.
|
|
|
|
``set-bootable``
|
|
Update bootable status of a volume.
|
|
|
|
``show``
|
|
Shows volume details.
|
|
|
|
``snapshot-create``
|
|
Creates a snapshot.
|
|
|
|
``snapshot-delete``
|
|
Removes one or more snapshots.
|
|
|
|
``snapshot-list``
|
|
Lists all snapshots.
|
|
|
|
``snapshot-metadata``
|
|
Sets or deletes snapshot metadata.
|
|
|
|
``snapshot-metadata-show``
|
|
Shows snapshot metadata.
|
|
|
|
``snapshot-metadata-update-all``
|
|
Updates snapshot metadata.
|
|
|
|
``snapshot-rename``
|
|
Renames a snapshot.
|
|
|
|
``snapshot-reset-state``
|
|
Explicitly updates the snapshot state.
|
|
|
|
``snapshot-show``
|
|
Shows snapshot details.
|
|
|
|
``transfer-accept``
|
|
Accepts a volume transfer.
|
|
|
|
``transfer-create``
|
|
Creates a volume transfer.
|
|
|
|
``transfer-delete``
|
|
Undoes a transfer.
|
|
|
|
``transfer-list``
|
|
Lists all transfers.
|
|
|
|
``transfer-show``
|
|
Shows transfer details.
|
|
|
|
``type-access-add``
|
|
Adds volume type access for the given project.
|
|
|
|
``type-access-list``
|
|
Print access information about the given volume type.
|
|
|
|
``type-access-remove``
|
|
Removes volume type access for the given project.
|
|
|
|
``type-create``
|
|
Creates a volume type.
|
|
|
|
``type-default``
|
|
List the default volume type.
|
|
|
|
``type-delete``
|
|
Deletes a volume type.
|
|
|
|
``type-key``
|
|
Sets or unsets extra_spec for a volume type.
|
|
|
|
``type-list``
|
|
Lists available 'volume types'. (Admin only will see
|
|
private types)
|
|
|
|
``type-show``
|
|
Show volume type details.
|
|
|
|
``type-update``
|
|
Updates volume type name ,description and/or
|
|
is_public.
|
|
|
|
``unmanage``
|
|
Stop managing a volume.
|
|
|
|
``upload-to-image``
|
|
Uploads volume to Image Service as an image.
|
|
|
|
``bash-completion``
|
|
Prints arguments for bash_completion.
|
|
|
|
``help``
|
|
Shows help about this program or one of its
|
|
subcommands.
|
|
|
|
``list-extensions``
|
|
Lists all available os-api extensions.
|
|
|
|
.. _cinder_command_options:
|
|
|
|
cinder optional arguments
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
``--version``
|
|
show program's version number and exit
|
|
|
|
``-d, --debug``
|
|
Shows debugging output.
|
|
|
|
``--os-auth-system <auth-system>``
|
|
Defaults to ``env[OS_AUTH_SYSTEM]``.
|
|
|
|
``--service-type <service-type>``
|
|
Service type. For most actions, default is volume.
|
|
|
|
``--service-name <service-name>``
|
|
Service name. Default= ``env[CINDER_SERVICE_NAME]``.
|
|
|
|
``--volume-service-name <volume-service-name>``
|
|
Volume service name.
|
|
Default= ``env[CINDER_VOLUME_SERVICE_NAME]``.
|
|
|
|
``--os-endpoint-type <os-endpoint-type>``
|
|
Endpoint type, which is publicURL or internalURL.
|
|
Default= ``env[OS_ENDPOINT_TYPE]`` or nova
|
|
``env[CINDER_ENDPOINT_TYPE]`` or publicURL.
|
|
|
|
``--endpoint-type <endpoint-type>``
|
|
**DEPRECATED!** Use :option:`--os-endpoint-type`.
|
|
|
|
``--os-volume-api-version <volume-api-ver>``
|
|
Block Storage API version. Valid values are 1 or 2.
|
|
Default= ``env[OS_VOLUME_API_VERSION]``.
|
|
|
|
``--bypass-url <bypass-url>``
|
|
Use this API endpoint instead of the Service Catalog.
|
|
Defaults to ``env[CINDERCLIENT_BYPASS_URL]``.
|
|
|
|
``--retries <retries>``
|
|
Number of retries.
|
|
|
|
``--os-auth-strategy <auth-strategy>``
|
|
Authentication strategy (Env: OS_AUTH_STRATEGY,
|
|
default keystone). For now, any other value will
|
|
disable the authentication.
|
|
|
|
``--os-username <auth-user-name>``
|
|
OpenStack user name. Default= ``env[OS_USERNAME]``.
|
|
|
|
``--os-password <auth-password>``
|
|
Password for OpenStack user. Default= ``env[OS_PASSWORD]``.
|
|
|
|
``--os-tenant-name <auth-tenant-name>``
|
|
Tenant name. Default= ``env[OS_TENANT_NAME]``.
|
|
|
|
``--os-tenant-id <auth-tenant-id>``
|
|
ID for the tenant. Default= ``env[OS_TENANT_ID]``.
|
|
|
|
``--os-auth-url <auth-url>``
|
|
URL for the authentication service.
|
|
Default= ``env[OS_AUTH_URL]``.
|
|
|
|
``--os-user-id <auth-user-id>``
|
|
Authentication user ID (Env: OS_USER_ID).
|
|
|
|
``--os-user-domain-id <auth-user-domain-id>``
|
|
OpenStack user domain ID. Defaults to
|
|
``env[OS_USER_DOMAIN_ID]``.
|
|
|
|
``--os-user-domain-name <auth-user-domain-name>``
|
|
OpenStack user domain name. Defaults to
|
|
``env[OS_USER_DOMAIN_NAME]``.
|
|
|
|
``--os-project-id <auth-project-id>``
|
|
Another way to specify tenant ID. This option is
|
|
mutually exclusive with :option:`--os-tenant-id`. Defaults to
|
|
``env[OS_PROJECT_ID]``.
|
|
|
|
``--os-project-name <auth-project-name>``
|
|
Another way to specify tenant name. This option is
|
|
mutually exclusive with :option:`--os-tenant-name`. Defaults to
|
|
``env[OS_PROJECT_NAME]``.
|
|
|
|
``--os-project-domain-id <auth-project-domain-id>``
|
|
Defaults to ``env[OS_PROJECT_DOMAIN_ID]``.
|
|
|
|
``--os-project-domain-name <auth-project-domain-name>``
|
|
Defaults to ``env[OS_PROJECT_DOMAIN_NAME]``.
|
|
|
|
``--os-region-name <region-name>``
|
|
Region name. Default= ``env[OS_REGION_NAME]``.
|
|
|
|
``--os-token <token>``
|
|
Defaults to ``env[OS_TOKEN]``.
|
|
|
|
``--os-url <url>``
|
|
Defaults to ``env[OS_URL]``.
|
|
|
|
``--insecure``
|
|
Explicitly allow client to perform "insecure" TLS
|
|
(https) requests. The server's certificate will not be
|
|
verified against any certificate authorities. This
|
|
option should be used with caution.
|
|
|
|
``--os-cacert <ca-certificate>``
|
|
Specify a CA bundle file to use in verifying a TLS
|
|
(https) server certificate. Defaults to
|
|
``env[OS_CACERT]``.
|
|
|
|
``--os-cert <certificate>``
|
|
Defaults to ``env[OS_CERT]``.
|
|
|
|
``--os-key <key>``
|
|
Defaults to ``env[OS_KEY]``.
|
|
|
|
``--timeout <seconds>``
|
|
Set request timeout (in seconds).
|
|
|
|
Block Storage API v1 commands
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. _cinder_absolute-limits:
|
|
|
|
cinder absolute-limits
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder absolute-limits
|
|
|
|
Lists absolute limits for a user.
|
|
|
|
.. _cinder_availability-zone-list:
|
|
|
|
cinder availability-zone-list
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder availability-zone-list
|
|
|
|
Lists all availability zones.
|
|
|
|
.. _cinder_backup-create:
|
|
|
|
cinder backup-create
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder backup-create [--container <container>] [--name <name>]
|
|
[--description <description>] [--incremental]
|
|
[--force]
|
|
<volume>
|
|
|
|
Creates a volume backup.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume to backup.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--container <container>``
|
|
Backup container name. Default=None.
|
|
|
|
``--name <name>``
|
|
Backup name. Default=None.
|
|
|
|
``--description <description>``
|
|
Backup description. Default=None.
|
|
|
|
``--incremental``
|
|
Incremental backup. Default=False.
|
|
|
|
``--force``
|
|
Allows or disallows backup of a volume when the volume
|
|
is attached to an instance. If set to True, backs up
|
|
the volume whether its status is "available" or "in-
|
|
use". The backup of an "in-use" volume means your data
|
|
is crash consistent. Default=False.
|
|
|
|
.. _cinder_backup-delete:
|
|
|
|
cinder backup-delete
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder backup-delete <backup>
|
|
|
|
Removes a backup.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<backup>``
|
|
Name or ID of backup to delete.
|
|
|
|
.. _cinder_backup-export:
|
|
|
|
cinder backup-export
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder backup-export <backup>
|
|
|
|
Export backup metadata record.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<backup>``
|
|
ID of the backup to export.
|
|
|
|
.. _cinder_backup-import:
|
|
|
|
cinder backup-import
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder backup-import <backup_service> <backup_url>
|
|
|
|
Import backup metadata record.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<backup_service>``
|
|
Backup service to use for importing the backup.
|
|
|
|
``<backup_url>``
|
|
Backup URL for importing the backup metadata.
|
|
|
|
.. _cinder_backup-list:
|
|
|
|
cinder backup-list
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder backup-list [--all-tenants [<all_tenants>]] [--name <name>]
|
|
[--status <status>] [--volume-id <volume-id>]
|
|
[--marker <marker>] [--limit <limit>]
|
|
[--sort <key>[:<direction>]]
|
|
|
|
Lists all backups.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--all-tenants [<all_tenants>]``
|
|
Shows details for all tenants. Admin only.
|
|
|
|
``--name <name>``
|
|
Filters results by a name. Default=None.
|
|
|
|
``--status <status>``
|
|
Filters results by a status. Default=None.
|
|
|
|
``--volume-id <volume-id>``
|
|
Filters results by a volume ID. Default=None.
|
|
|
|
``--marker <marker>``
|
|
Begin returning backups that appear later in the
|
|
backup list than that represented by this id.
|
|
Default=None.
|
|
|
|
``--limit <limit>``
|
|
Maximum number of backups to return. Default=None.
|
|
|
|
``--sort <key>[:<direction>]``
|
|
Comma-separated list of sort keys and directions in
|
|
the form of <key>[:<asc|desc>]. Valid keys: id,
|
|
status, size, availability_zone, name, bootable,
|
|
created_at. Default=None.
|
|
|
|
.. _cinder_backup-reset-state:
|
|
|
|
cinder backup-reset-state
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder backup-reset-state [--state <state>] <backup> [<backup> ...]
|
|
|
|
Explicitly updates the backup state.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<backup>``
|
|
Name or ID of the backup to modify.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--state <state>``
|
|
The state to assign to the backup. Valid values are
|
|
"available", "error", "creating", "deleting", and
|
|
"error_deleting". Default=available.
|
|
|
|
.. _cinder_backup-restore:
|
|
|
|
cinder backup-restore
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder backup-restore [--volume <volume>] <backup>
|
|
|
|
Restores a backup.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<backup>``
|
|
ID of backup to restore.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--volume <volume>``
|
|
Name or ID of volume to which to restore. Default=None.
|
|
|
|
.. _cinder_backup-show:
|
|
|
|
cinder backup-show
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder backup-show <backup>
|
|
|
|
Shows backup details.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<backup>``
|
|
Name or ID of backup.
|
|
|
|
.. _cinder_cgsnapshot-create:
|
|
|
|
cinder cgsnapshot-create
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder cgsnapshot-create [--name <name>] [--description <description>]
|
|
<consistencygroup>
|
|
|
|
Creates a cgsnapshot.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<consistencygroup>``
|
|
Name or ID of a consistency group.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--name <name>``
|
|
Cgsnapshot name. Default=None.
|
|
|
|
``--description <description>``
|
|
Cgsnapshot description. Default=None.
|
|
|
|
.. _cinder_cgsnapshot-delete:
|
|
|
|
cinder cgsnapshot-delete
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder cgsnapshot-delete <cgsnapshot> [<cgsnapshot> ...]
|
|
|
|
Removes one or more cgsnapshots.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<cgsnapshot>``
|
|
Name or ID of one or more cgsnapshots to be deleted.
|
|
|
|
.. _cinder_cgsnapshot-list:
|
|
|
|
cinder cgsnapshot-list
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder cgsnapshot-list [--all-tenants [<0|1>]] [--status <status>]
|
|
[--consistencygroup-id <consistencygroup_id>]
|
|
|
|
Lists all cgsnapshots.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--all-tenants [<0|1>]``
|
|
Shows details for all tenants. Admin only.
|
|
|
|
``--status <status>``
|
|
Filters results by a status. Default=None.
|
|
|
|
``--consistencygroup-id <consistencygroup_id>``
|
|
Filters results by a consistency group ID.
|
|
Default=None.
|
|
|
|
.. _cinder_cgsnapshot-show:
|
|
|
|
cinder cgsnapshot-show
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder cgsnapshot-show <cgsnapshot>
|
|
|
|
Shows cgsnapshot details.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<cgsnapshot>``
|
|
Name or ID of cgsnapshot.
|
|
|
|
.. _cinder_consisgroup-create:
|
|
|
|
cinder consisgroup-create
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder consisgroup-create [--name <name>] [--description <description>]
|
|
[--availability-zone <availability-zone>]
|
|
<volume-types>
|
|
|
|
Creates a consistency group.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume-types>``
|
|
Volume types.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--name <name>``
|
|
Name of a consistency group.
|
|
|
|
``--description <description>``
|
|
Description of a consistency group. Default=None.
|
|
|
|
``--availability-zone <availability-zone>``
|
|
Availability zone for volume. Default=None.
|
|
|
|
.. _cinder_consisgroup-create-from-src:
|
|
|
|
cinder consisgroup-create-from-src
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder consisgroup-create-from-src [--cgsnapshot <cgsnapshot>]
|
|
[--source-cg <source-cg>]
|
|
[--name <name>]
|
|
[--description <description>]
|
|
|
|
Creates a consistency group from a cgsnapshot or a source CG.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--cgsnapshot <cgsnapshot>``
|
|
Name or ID of a cgsnapshot. Default=None.
|
|
|
|
``--source-cg <source-cg>``
|
|
Name or ID of a source CG. Default=None.
|
|
|
|
``--name <name>``
|
|
Name of a consistency group. Default=None.
|
|
|
|
``--description <description>``
|
|
Description of a consistency group. Default=None.
|
|
|
|
.. _cinder_consisgroup-delete:
|
|
|
|
cinder consisgroup-delete
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder consisgroup-delete [--force]
|
|
<consistencygroup> [<consistencygroup> ...]
|
|
|
|
Removes one or more consistency groups.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<consistencygroup>``
|
|
Name or ID of one or more consistency groups to be
|
|
deleted.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--force``
|
|
Allows or disallows consistency groups to be deleted. If
|
|
the consistency group is empty, it can be deleted
|
|
without the force flag. If the consistency group is not
|
|
empty, the force flag is required for it to be deleted.
|
|
|
|
.. _cinder_consisgroup-list:
|
|
|
|
cinder consisgroup-list
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder consisgroup-list [--all-tenants [<0|1>]]
|
|
|
|
Lists all consistencygroups.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--all-tenants [<0|1>]``
|
|
Shows details for all tenants. Admin only.
|
|
|
|
.. _cinder_consisgroup-show:
|
|
|
|
cinder consisgroup-show
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder consisgroup-show <consistencygroup>
|
|
|
|
Shows details of a consistency group.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<consistencygroup>``
|
|
Name or ID of a consistency group.
|
|
|
|
.. _cinder_consisgroup-update:
|
|
|
|
cinder consisgroup-update
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder consisgroup-update [--name <name>] [--description <description>]
|
|
[--add-volumes <uuid1,uuid2,......>]
|
|
[--remove-volumes <uuid3,uuid4,......>]
|
|
<consistencygroup>
|
|
|
|
Updates a consistencygroup.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<consistencygroup>``
|
|
Name or ID of a consistency group.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--name <name>``
|
|
New name for consistency group. Default=None.
|
|
|
|
``--description <description>``
|
|
New description for consistency group. Default=None.
|
|
|
|
``--add-volumes <uuid1,uuid2,......>``
|
|
UUID of one or more volumes to be added to the
|
|
consistency group, separated by commas. Default=None.
|
|
|
|
``--remove-volumes <uuid3,uuid4,......>``
|
|
UUID of one or more volumes to be removed from the
|
|
consistency group, separated by commas. Default=None.
|
|
|
|
.. _cinder_create:
|
|
|
|
cinder create
|
|
~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder create [--consisgroup-id <consistencygroup-id>]
|
|
[--snapshot-id <snapshot-id>]
|
|
[--source-volid <source-volid>]
|
|
[--source-replica <source-replica>]
|
|
[--image-id <image-id>] [--image <image>] [--name <name>]
|
|
[--description <description>]
|
|
[--volume-type <volume-type>]
|
|
[--availability-zone <availability-zone>]
|
|
[--metadata [<key=value> [<key=value> ...]]]
|
|
[--hint <key=value>] [--allow-multiattach]
|
|
[<size>]
|
|
|
|
Creates a volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<size>``
|
|
Size of volume, in GiBs. (Required unless snapshot-id
|
|
/source-volid is specified).
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--consisgroup-id <consistencygroup-id>``
|
|
ID of a consistency group where the new volume belongs
|
|
to. Default=None.
|
|
|
|
``--snapshot-id <snapshot-id>``
|
|
Creates volume from snapshot ID. Default=None.
|
|
|
|
``--source-volid <source-volid>``
|
|
Creates volume from volume ID. Default=None.
|
|
|
|
``--source-replica <source-replica>``
|
|
Creates volume from replicated volume ID.
|
|
Default=None.
|
|
|
|
``--image-id <image-id>``
|
|
Creates volume from image ID. Default=None.
|
|
|
|
``--image <image>``
|
|
Creates a volume from image (ID or name).
|
|
Default=None.
|
|
|
|
``--name <name>``
|
|
Volume name. Default=None.
|
|
|
|
``--description <description>``
|
|
Volume description. Default=None.
|
|
|
|
``--volume-type <volume-type>``
|
|
Volume type. Default=None.
|
|
|
|
``--availability-zone <availability-zone>``
|
|
Availability zone for volume. Default=None.
|
|
|
|
``--metadata [<key=value> [<key=value> ...]]``
|
|
Metadata key and value pairs. Default=None.
|
|
|
|
``--hint <key=value>``
|
|
Scheduler hint, like in nova.
|
|
|
|
``--allow-multiattach``
|
|
Allow volume to be attached more than once.
|
|
Default=False
|
|
|
|
.. _cinder_credentials:
|
|
|
|
cinder credentials
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder credentials
|
|
|
|
Shows user credentials returned from auth.
|
|
|
|
.. _cinder_delete:
|
|
|
|
cinder delete
|
|
~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder delete <volume> [<volume> ...]
|
|
|
|
Removes one or more volumes.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume or volumes to delete.
|
|
|
|
.. _cinder_encryption-type-create:
|
|
|
|
cinder encryption-type-create
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder encryption-type-create [--cipher <cipher>]
|
|
[--key_size <key_size>]
|
|
[--control_location <control_location>]
|
|
<volume_type> <provider>
|
|
|
|
Creates encryption type for a volume type. Admin only.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume_type>``
|
|
Name or ID of volume type.
|
|
|
|
``<provider>``
|
|
The class that provides encryption support. For
|
|
example, LuksEncryptor.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--cipher <cipher>``
|
|
The encryption algorithm or mode. For example, aes-
|
|
xts-plain64. Default=None.
|
|
|
|
``--key_size <key_size>``
|
|
Size of encryption key, in bits. For example, 128 or
|
|
256. Default=None.
|
|
|
|
``--control_location <control_location>``
|
|
Notional service where encryption is performed. Valid
|
|
values are "front-end" or "back-end." For example,
|
|
front-end=Nova. Default is "front-end."
|
|
|
|
.. _cinder_encryption-type-delete:
|
|
|
|
cinder encryption-type-delete
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder encryption-type-delete <volume_type>
|
|
|
|
Deletes encryption type for a volume type. Admin only.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume_type>``
|
|
Name or ID of volume type.
|
|
|
|
.. _cinder_encryption-type-list:
|
|
|
|
cinder encryption-type-list
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder encryption-type-list
|
|
|
|
Shows encryption type details for volume types. Admin only.
|
|
|
|
.. _cinder_encryption-type-show:
|
|
|
|
cinder encryption-type-show
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder encryption-type-show <volume_type>
|
|
|
|
Shows encryption type details for a volume type. Admin only.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume_type>``
|
|
Name or ID of volume type.
|
|
|
|
.. _cinder_encryption-type-update:
|
|
|
|
cinder encryption-type-update
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder encryption-type-update [--provider <provider>]
|
|
[--cipher [<cipher>]]
|
|
[--key-size [<key-size>]]
|
|
[--control-location <control-location>]
|
|
<volume-type>
|
|
|
|
Update encryption type information for a volume type (Admin Only).
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume-type>``
|
|
Name or ID of the volume type
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--provider <provider>``
|
|
Class providing encryption support (e.g.
|
|
LuksEncryptor) (Optional)
|
|
|
|
``--cipher [<cipher>]``
|
|
Encryption algorithm/mode to use (e.g., aes-xts-
|
|
plain64). Provide parameter without value to set to
|
|
provider default. (Optional)
|
|
|
|
``--key-size [<key-size>]``
|
|
Size of the encryption key, in bits (e.g., 128, 256).
|
|
Provide parameter without value to set to provider
|
|
default. (Optional)
|
|
|
|
``--control-location <control-location>``
|
|
Notional service where encryption is performed (e.g.,
|
|
front-end=Nova). Values: 'front-end', 'back-end'
|
|
(Optional)
|
|
|
|
.. _cinder_endpoints:
|
|
|
|
cinder endpoints
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder endpoints
|
|
|
|
Discovers endpoints registered by authentication service.
|
|
|
|
.. _cinder_extend:
|
|
|
|
cinder extend
|
|
~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder extend <volume> <new_size>
|
|
|
|
Attempts to extend size of an existing volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume to extend.
|
|
|
|
``<new_size>``
|
|
New size of volume, in GiBs.
|
|
|
|
.. _cinder_extra-specs-list:
|
|
|
|
cinder extra-specs-list
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder extra-specs-list
|
|
|
|
Lists current volume types and extra specs.
|
|
|
|
.. _cinder_force-delete:
|
|
|
|
cinder force-delete
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder force-delete <volume> [<volume> ...]
|
|
|
|
Attempts force-delete of volume, regardless of state.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume or volumes to delete.
|
|
|
|
.. _cinder_get-capabilities:
|
|
|
|
cinder get-capabilities
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder get-capabilities <host>
|
|
|
|
Show backend volume stats and properties. Admin only.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<host>``
|
|
Cinder host to show backend volume stats and properties; takes the
|
|
form: host@backend-name
|
|
|
|
.. _cinder_get-pools:
|
|
|
|
cinder get-pools
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder get-pools [--detail]
|
|
|
|
Show pool information for backends. Admin only.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--detail``
|
|
Show detailed information about pools.
|
|
|
|
.. _cinder_image-metadata:
|
|
|
|
cinder image-metadata
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder image-metadata <volume> <action> <key=value> [<key=value> ...]
|
|
|
|
Sets or deletes volume image metadata.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume for which to update metadata.
|
|
|
|
``<action>``
|
|
The action. Valid values are 'set' or 'unset.'
|
|
|
|
``<key=value>``
|
|
Metadata key and value pair to set or unset. For unset, specify
|
|
only the key.
|
|
|
|
.. _cinder_image-metadata-show:
|
|
|
|
cinder image-metadata-show
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder image-metadata-show <volume>
|
|
|
|
Shows volume image metadata.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume.
|
|
|
|
.. _cinder_list:
|
|
|
|
cinder list
|
|
~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder list [--all-tenants [<0|1>]] [--name <name>] [--status <status>]
|
|
[--migration_status <migration_status>]
|
|
[--metadata [<key=value> [<key=value> ...]]]
|
|
[--marker <marker>] [--limit <limit>]
|
|
[--sort <key>[:<direction>]] [--tenant [<tenant>]]
|
|
|
|
Lists all volumes.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--all-tenants [<0|1>]``
|
|
Shows details for all tenants. Admin only.
|
|
|
|
``--name <name>``
|
|
Filters results by a name. Default=None.
|
|
|
|
``--status <status>``
|
|
Filters results by a status. Default=None.
|
|
|
|
``--migration_status <migration_status>``
|
|
Filters results by a migration status. Default=None.
|
|
Admin only.
|
|
|
|
``--metadata [<key=value> [<key=value> ...]]``
|
|
Filters results by a metadata key and value pair.
|
|
Default=None.
|
|
|
|
``--marker <marker>``
|
|
Begin returning volumes that appear later in the
|
|
volume list than that represented by this volume id.
|
|
Default=None.
|
|
|
|
``--limit <limit>``
|
|
Maximum number of volumes to return. Default=None.
|
|
|
|
``--sort <key>[:<direction>]``
|
|
Comma-separated list of sort keys and directions in
|
|
the form of <key>[:<asc|desc>]. Valid keys: id,
|
|
status, size, availability_zone, name, bootable,
|
|
created_at. Default=None.
|
|
|
|
``--tenant [<tenant>]``
|
|
Display information from single tenant (Admin only).
|
|
|
|
.. _cinder_list-extensions:
|
|
|
|
cinder list-extensions
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder list-extensions
|
|
|
|
Lists all available os-api extensions.
|
|
|
|
.. _cinder_manage:
|
|
|
|
cinder manage
|
|
~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder manage [--id-type <id-type>] [--name <name>]
|
|
[--description <description>]
|
|
[--volume-type <volume-type>]
|
|
[--availability-zone <availability-zone>]
|
|
[--metadata [<key=value> [<key=value> ...]]] [--bootable]
|
|
<host> <identifier>
|
|
|
|
Manage an existing volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<host>``
|
|
Cinder host on which the existing volume resides;
|
|
takes the form: host@backend-name#pool
|
|
|
|
``<identifier>``
|
|
Name or other Identifier for existing volume
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--id-type <id-type>``
|
|
Type of backend device identifier provided, typically
|
|
source-name or source-id (Default=source-name)
|
|
|
|
``--name <name>``
|
|
Volume name (Default=None)
|
|
|
|
``--description <description>``
|
|
Volume description (Default=None)
|
|
|
|
``--volume-type <volume-type>``
|
|
Volume type (Default=None)
|
|
|
|
``--availability-zone <availability-zone>``
|
|
Availability zone for volume (Default=None)
|
|
|
|
``--metadata [<key=value> [<key=value> ...]]``
|
|
Metadata key=value pairs (Default=None)
|
|
|
|
``--bootable``
|
|
Specifies that the newly created volume should be
|
|
marked as bootable
|
|
|
|
.. _cinder_metadata:
|
|
|
|
cinder metadata
|
|
~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder metadata <volume> <action> <key=value> [<key=value> ...]
|
|
|
|
Sets or deletes volume metadata.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume for which to update metadata.
|
|
|
|
``<action>``
|
|
The action. Valid values are "set" or "unset."
|
|
|
|
``<key=value>``
|
|
Metadata key and value pair to set or unset. For unset, specify
|
|
only the key.
|
|
|
|
.. _cinder_metadata-show:
|
|
|
|
cinder metadata-show
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder metadata-show <volume>
|
|
|
|
Shows volume metadata.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume.
|
|
|
|
.. _cinder_metadata-update-all:
|
|
|
|
cinder metadata-update-all
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder metadata-update-all <volume> <key=value> [<key=value> ...]
|
|
|
|
Updates volume metadata.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume for which to update metadata.
|
|
|
|
``<key=value>``
|
|
Metadata key and value pair or pairs to update.
|
|
|
|
.. _cinder_migrate:
|
|
|
|
cinder migrate
|
|
~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder migrate [--force-host-copy [<True|False>]]
|
|
[--lock-volume [<True|False>]]
|
|
<volume> <host>
|
|
|
|
Migrates volume to a new host.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume to migrate.
|
|
|
|
``<host>``
|
|
Destination host. Takes the form: host@backend-
|
|
name#pool
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--force-host-copy [<True|False>]``
|
|
Enables or disables generic host-based force-
|
|
migration, which bypasses driver optimizations.
|
|
Default=False.
|
|
|
|
``--lock-volume [<True|False>]``
|
|
Enables or disables the termination of volume
|
|
migration caused by other commands. This option
|
|
applies to the available volume. True means it locks
|
|
the volume state and does not allow the migration to
|
|
be aborted. The volume status will be in maintenance
|
|
during the migration. False means it allows the volume
|
|
migration to be aborted. The volume status is still in
|
|
the original status. Default=False.
|
|
|
|
.. _cinder_qos-associate:
|
|
|
|
cinder qos-associate
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder qos-associate <qos_specs> <volume_type_id>
|
|
|
|
Associates qos specs with specified volume type.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<qos_specs>``
|
|
ID of QoS specifications.
|
|
|
|
``<volume_type_id>``
|
|
ID of volume type with which to associate QoS
|
|
specifications.
|
|
|
|
.. _cinder_qos-create:
|
|
|
|
cinder qos-create
|
|
~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder qos-create <name> <key=value> [<key=value> ...]
|
|
|
|
Creates a qos specs.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<name>``
|
|
Name of new QoS specifications.
|
|
|
|
``<key=value>``
|
|
QoS specifications.
|
|
|
|
.. _cinder_qos-delete:
|
|
|
|
cinder qos-delete
|
|
~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder qos-delete [--force [<True|False>]] <qos_specs>
|
|
|
|
Deletes a specified qos specs.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<qos_specs>``
|
|
ID of QoS specifications to delete.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--force [<True|False>]``
|
|
Enables or disables deletion of in-use QoS
|
|
specifications. Default=False.
|
|
|
|
.. _cinder_qos-disassociate:
|
|
|
|
cinder qos-disassociate
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder qos-disassociate <qos_specs> <volume_type_id>
|
|
|
|
Disassociates qos specs from specified volume type.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<qos_specs>``
|
|
ID of QoS specifications.
|
|
|
|
``<volume_type_id>``
|
|
ID of volume type with which to associate QoS
|
|
specifications.
|
|
|
|
.. _cinder_qos-disassociate-all:
|
|
|
|
cinder qos-disassociate-all
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder qos-disassociate-all <qos_specs>
|
|
|
|
Disassociates qos specs from all its associations.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<qos_specs>``
|
|
ID of QoS specifications on which to operate.
|
|
|
|
.. _cinder_qos-get-association:
|
|
|
|
cinder qos-get-association
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder qos-get-association <qos_specs>
|
|
|
|
Lists all associations for specified qos specs.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<qos_specs>``
|
|
ID of QoS specifications.
|
|
|
|
.. _cinder_qos-key:
|
|
|
|
cinder qos-key
|
|
~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder qos-key <qos_specs> <action> key=value [key=value ...]
|
|
|
|
Sets or unsets specifications for a qos spec.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<qos_specs>``
|
|
ID of QoS specifications.
|
|
|
|
``<action>``
|
|
The action. Valid values are "set" or "unset."
|
|
|
|
``key=value``
|
|
Metadata key and value pair to set or unset. For unset, specify
|
|
only the key.
|
|
|
|
.. _cinder_qos-list:
|
|
|
|
cinder qos-list
|
|
~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder qos-list
|
|
|
|
Lists qos specs.
|
|
|
|
.. _cinder_qos-show:
|
|
|
|
cinder qos-show
|
|
~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder qos-show <qos_specs>
|
|
|
|
Shows qos specs details.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<qos_specs>``
|
|
ID of QoS specifications to show.
|
|
|
|
.. _cinder_quota-class-show:
|
|
|
|
cinder quota-class-show
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder quota-class-show <class>
|
|
|
|
Lists quotas for a quota class.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<class>``
|
|
Name of quota class for which to list quotas.
|
|
|
|
.. _cinder_quota-class-update:
|
|
|
|
cinder quota-class-update
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder quota-class-update [--volumes <volumes>]
|
|
[--snapshots <snapshots>]
|
|
[--gigabytes <gigabytes>]
|
|
[--volume-type <volume_type_name>]
|
|
<class_name>
|
|
|
|
Updates quotas for a quota class.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<class_name>``
|
|
Name of quota class for which to set quotas.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--volumes <volumes>``
|
|
The new "volumes" quota value. Default=None.
|
|
|
|
``--snapshots <snapshots>``
|
|
The new "snapshots" quota value. Default=None.
|
|
|
|
``--gigabytes <gigabytes>``
|
|
The new "gigabytes" quota value. Default=None.
|
|
|
|
``--volume-type <volume_type_name>``
|
|
Volume type. Default=None.
|
|
|
|
.. _cinder_quota-defaults:
|
|
|
|
cinder quota-defaults
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder quota-defaults <tenant_id>
|
|
|
|
Lists default quotas for a tenant.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<tenant_id>``
|
|
ID of tenant for which to list quota defaults.
|
|
|
|
.. _cinder_quota-delete:
|
|
|
|
cinder quota-delete
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder quota-delete <tenant_id>
|
|
|
|
Delete the quotas for a tenant.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<tenant_id>``
|
|
UUID of tenant to delete the quotas for.
|
|
|
|
.. _cinder_quota-show:
|
|
|
|
cinder quota-show
|
|
~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder quota-show <tenant_id>
|
|
|
|
Lists quotas for a tenant.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<tenant_id>``
|
|
ID of tenant for which to list quotas.
|
|
|
|
.. _cinder_quota-update:
|
|
|
|
cinder quota-update
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder quota-update [--volumes <volumes>] [--snapshots <snapshots>]
|
|
[--gigabytes <gigabytes>] [--backups <backups>]
|
|
[--backup-gigabytes <backup_gigabytes>]
|
|
[--consistencygroups <consistencygroups>]
|
|
[--volume-type <volume_type_name>]
|
|
[--per-volume-gigabytes <per_volume_gigabytes>]
|
|
<tenant_id>
|
|
|
|
Updates quotas for a tenant.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<tenant_id>``
|
|
ID of tenant for which to set quotas.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--volumes <volumes>``
|
|
The new "volumes" quota value. Default=None.
|
|
|
|
``--snapshots <snapshots>``
|
|
The new "snapshots" quota value. Default=None.
|
|
|
|
``--gigabytes <gigabytes>``
|
|
The new "gigabytes" quota value. Default=None.
|
|
|
|
``--backups <backups>``
|
|
The new "backups" quota value. Default=None.
|
|
|
|
``--backup-gigabytes <backup_gigabytes>``
|
|
The new "backup_gigabytes" quota value. Default=None.
|
|
|
|
``--consistencygroups <consistencygroups>``
|
|
The new "consistencygroups" quota value. Default=None.
|
|
|
|
``--volume-type <volume_type_name>``
|
|
Volume type. Default=None.
|
|
|
|
``--per-volume-gigabytes <per_volume_gigabytes>``
|
|
Set max volume size limit. Default=None.
|
|
|
|
.. _cinder_quota-usage:
|
|
|
|
cinder quota-usage
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder quota-usage <tenant_id>
|
|
|
|
Lists quota usage for a tenant.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<tenant_id>``
|
|
ID of tenant for which to list quota usage.
|
|
|
|
.. _cinder_rate-limits:
|
|
|
|
cinder rate-limits
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder rate-limits
|
|
|
|
Lists rate limits for a user.
|
|
|
|
.. _cinder_readonly-mode-update:
|
|
|
|
cinder readonly-mode-update
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder readonly-mode-update <volume> <True|true|False|false>
|
|
|
|
Updates volume read-only access-mode flag.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume to update.
|
|
|
|
``<True|true|False|false>``
|
|
Enables or disables update of volume to read-only
|
|
access mode.
|
|
|
|
.. _cinder_rename:
|
|
|
|
cinder rename
|
|
~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder rename [--description <description>] <volume> [<name>]
|
|
|
|
Renames a volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume to rename.
|
|
|
|
``<name>``
|
|
New name for volume.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--description <description>``
|
|
Volume description. Default=None.
|
|
|
|
.. _cinder_replication-disable:
|
|
|
|
cinder replication-disable
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder replication-disable <volume>
|
|
|
|
Disables volume replication on a given volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume to disable replication.
|
|
|
|
.. _cinder_replication-enable:
|
|
|
|
cinder replication-enable
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder replication-enable <volume>
|
|
|
|
Enables volume replication on a given volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume to enable replication.
|
|
|
|
.. _cinder_replication-failover:
|
|
|
|
cinder replication-failover
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder replication-failover <volume> <secondary>
|
|
|
|
Failover a volume to a secondary target
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume to failover.
|
|
|
|
``<secondary>``
|
|
A unqiue identifier that represents a failover target.
|
|
|
|
.. _cinder_replication-list-targets:
|
|
|
|
cinder replication-list-targets
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder replication-list-targets <volume>
|
|
|
|
List replication targets available for a volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume to list available replication targets.
|
|
|
|
.. _cinder_replication-promote:
|
|
|
|
cinder replication-promote
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder replication-promote <volume>
|
|
|
|
Promote a secondary volume to primary for a relationship.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of the volume to promote. The volume should have the
|
|
replica volume created with source-replica argument.
|
|
|
|
.. _cinder_replication-reenable:
|
|
|
|
cinder replication-reenable
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder replication-reenable <volume>
|
|
|
|
Sync the secondary volume with primary for a relationship.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of the volume to reenable replication. The replication-
|
|
status of the volume should be inactive.
|
|
|
|
.. _cinder_reset-state:
|
|
|
|
cinder reset-state
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder reset-state [--state <state>] [--attach-status <attach-status>]
|
|
[--reset-migration-status]
|
|
<volume> [<volume> ...]
|
|
|
|
Explicitly updates the volume state in the Cinder database. Note that this
|
|
does not affect whether the volume is actually attached to the Nova compute
|
|
host or instance and can result in an unusable volume. Being a database change
|
|
only, this has no impact on the true state of the volume and may not match the
|
|
actual state. This can render a volume unusable in the case of change to the
|
|
'available' state.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume to modify.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--state <state>``
|
|
The state to assign to the volume. Valid values are
|
|
"available", "error", "creating", "deleting", "in-
|
|
use", "attaching", "detaching", "error_deleting" and
|
|
"maintenance". NOTE: This command simply changes the
|
|
state of the Volume in the DataBase with no regard to
|
|
actual status, exercise caution when using.
|
|
Default=available.
|
|
|
|
``--attach-status <attach-status>``
|
|
The attach status to assign to the volume in the
|
|
DataBase, with no regard to the actual status. Valid
|
|
values are "attached" and "detached". Default=None,
|
|
that means the status is unchanged.
|
|
|
|
``--reset-migration-status``
|
|
Clears the migration status of the volume in the
|
|
DataBase that indicates the volume is source or
|
|
destination of volume migration, with no regard to the
|
|
actual status.
|
|
|
|
.. _cinder_retype:
|
|
|
|
cinder retype
|
|
~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder retype [--migration-policy <never|on-demand>]
|
|
<volume> <volume-type>
|
|
|
|
Changes the volume type for a volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume for which to modify type.
|
|
|
|
``<volume-type>``
|
|
New volume type.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--migration-policy <never|on-demand>``
|
|
Migration policy during retype of volume.
|
|
|
|
.. _cinder_service-disable:
|
|
|
|
cinder service-disable
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder service-disable [--reason <reason>] <hostname> <binary>
|
|
|
|
Disables the service.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<hostname>``
|
|
Host name.
|
|
|
|
``<binary>``
|
|
Service binary.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--reason <reason>``
|
|
Reason for disabling service.
|
|
|
|
.. _cinder_service-enable:
|
|
|
|
cinder service-enable
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder service-enable <hostname> <binary>
|
|
|
|
Enables the service.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<hostname>``
|
|
Host name.
|
|
|
|
``<binary>``
|
|
Service binary.
|
|
|
|
.. _cinder_service-list:
|
|
|
|
cinder service-list
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder service-list [--host <hostname>] [--binary <binary>]
|
|
|
|
Lists all services. Filter by host and service binary.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--host <hostname>``
|
|
Host name. Default=None.
|
|
|
|
``--binary <binary>``
|
|
Service binary. Default=None.
|
|
|
|
.. _cinder_set-bootable:
|
|
|
|
cinder set-bootable
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder set-bootable <volume> <True|true|False|false>
|
|
|
|
Update bootable status of a volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of the volume to update.
|
|
|
|
``<True|true|False|false>``
|
|
Flag to indicate whether volume is bootable.
|
|
|
|
.. _cinder_show:
|
|
|
|
cinder show
|
|
~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder show <volume>
|
|
|
|
Shows volume details.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume.
|
|
|
|
.. _cinder_snapshot-create:
|
|
|
|
cinder snapshot-create
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder snapshot-create [--force [<True|False>]] [--name <name>]
|
|
[--description <description>]
|
|
[--metadata [<key=value> [<key=value> ...]]]
|
|
<volume>
|
|
|
|
Creates a snapshot.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume to snapshot.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--force [<True|False>]``
|
|
Allows or disallows snapshot of a volume when the
|
|
volume is attached to an instance. If set to True,
|
|
ignores the current status of the volume when
|
|
attempting to snapshot it rather than forcing it to be
|
|
available. Default=False.
|
|
|
|
``--name <name>``
|
|
Snapshot name. Default=None.
|
|
|
|
``--description <description>``
|
|
Snapshot description. Default=None.
|
|
|
|
``--metadata [<key=value> [<key=value> ...]]``
|
|
Snapshot metadata key and value pairs. Default=None.
|
|
|
|
.. _cinder_snapshot-delete:
|
|
|
|
cinder snapshot-delete
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder snapshot-delete <snapshot> [<snapshot> ...]
|
|
|
|
Removes one or more snapshots.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<snapshot>``
|
|
Name or ID of the snapshot(s) to delete.
|
|
|
|
.. _cinder_snapshot-list:
|
|
|
|
cinder snapshot-list
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder snapshot-list [--all-tenants [<0|1>]] [--name <name>]
|
|
[--status <status>] [--volume-id <volume-id>]
|
|
[--marker <marker>] [--limit <limit>]
|
|
[--sort <key>[:<direction>]]
|
|
|
|
Lists all snapshots.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--all-tenants [<0|1>]``
|
|
Shows details for all tenants. Admin only.
|
|
|
|
``--name <name>``
|
|
Filters results by a name. Default=None.
|
|
|
|
``--status <status>``
|
|
Filters results by a status. Default=None.
|
|
|
|
``--volume-id <volume-id>``
|
|
Filters results by a volume ID. Default=None.
|
|
|
|
``--marker <marker>``
|
|
Begin returning snapshots that appear later in the
|
|
snapshot list than that represented by this id.
|
|
Default=None.
|
|
|
|
``--limit <limit>``
|
|
Maximum number of snapshots to return. Default=None.
|
|
|
|
``--sort <key>[:<direction>]``
|
|
Comma-separated list of sort keys and directions in
|
|
the form of <key>[:<asc|desc>]. Valid keys: id,
|
|
status, size, availability_zone, name, bootable,
|
|
created_at. Default=None.
|
|
|
|
.. _cinder_snapshot-metadata:
|
|
|
|
cinder snapshot-metadata
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder snapshot-metadata <snapshot> <action> <key=value>
|
|
[<key=value> ...]
|
|
|
|
Sets or deletes snapshot metadata.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<snapshot>``
|
|
ID of snapshot for which to update metadata.
|
|
|
|
``<action>``
|
|
The action. Valid values are "set" or "unset."
|
|
|
|
``<key=value>``
|
|
Metadata key and value pair to set or unset. For unset, specify
|
|
only the key.
|
|
|
|
.. _cinder_snapshot-metadata-show:
|
|
|
|
cinder snapshot-metadata-show
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder snapshot-metadata-show <snapshot>
|
|
|
|
Shows snapshot metadata.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<snapshot>``
|
|
ID of snapshot.
|
|
|
|
.. _cinder_snapshot-metadata-update-all:
|
|
|
|
cinder snapshot-metadata-update-all
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder snapshot-metadata-update-all <snapshot> <key=value>
|
|
[<key=value> ...]
|
|
|
|
Updates snapshot metadata.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<snapshot>``
|
|
ID of snapshot for which to update metadata.
|
|
|
|
``<key=value>``
|
|
Metadata key and value pair to update.
|
|
|
|
.. _cinder_snapshot-rename:
|
|
|
|
cinder snapshot-rename
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder snapshot-rename [--description <description>]
|
|
<snapshot> [<name>]
|
|
|
|
Renames a snapshot.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<snapshot>``
|
|
Name or ID of snapshot.
|
|
|
|
``<name>``
|
|
New name for snapshot.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--description <description>``
|
|
Snapshot description. Default=None.
|
|
|
|
.. _cinder_snapshot-reset-state:
|
|
|
|
cinder snapshot-reset-state
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder snapshot-reset-state [--state <state>]
|
|
<snapshot> [<snapshot> ...]
|
|
|
|
Explicitly updates the snapshot state.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<snapshot>``
|
|
Name or ID of snapshot to modify.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--state <state>``
|
|
The state to assign to the snapshot. Valid values are
|
|
"available", "error", "creating", "deleting", and
|
|
"error_deleting". NOTE: This command simply changes the
|
|
state of the Snapshot in the DataBase with no regard to
|
|
actual status, exercise caution when using.
|
|
Default=available.
|
|
|
|
.. _cinder_snapshot-show:
|
|
|
|
cinder snapshot-show
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder snapshot-show <snapshot>
|
|
|
|
Shows snapshot details.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<snapshot>``
|
|
Name or ID of snapshot.
|
|
|
|
.. _cinder_transfer-accept:
|
|
|
|
cinder transfer-accept
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder transfer-accept <transfer> <auth_key>
|
|
|
|
Accepts a volume transfer.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<transfer>``
|
|
ID of transfer to accept.
|
|
|
|
``<auth_key>``
|
|
Authentication key of transfer to accept.
|
|
|
|
.. _cinder_transfer-create:
|
|
|
|
cinder transfer-create
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder transfer-create [--name <name>] <volume>
|
|
|
|
Creates a volume transfer.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume to transfer.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--name <name>``
|
|
Transfer name. Default=None.
|
|
|
|
.. _cinder_transfer-delete:
|
|
|
|
cinder transfer-delete
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder transfer-delete <transfer>
|
|
|
|
Undoes a transfer.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<transfer>``
|
|
Name or ID of transfer to delete.
|
|
|
|
.. _cinder_transfer-list:
|
|
|
|
cinder transfer-list
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder transfer-list [--all-tenants [<0|1>]]
|
|
|
|
Lists all transfers.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--all-tenants [<0|1>]``
|
|
Shows details for all tenants. Admin only.
|
|
|
|
.. _cinder_transfer-show:
|
|
|
|
cinder transfer-show
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder transfer-show <transfer>
|
|
|
|
Shows transfer details.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<transfer>``
|
|
Name or ID of transfer to accept.
|
|
|
|
.. _cinder_type-access-add:
|
|
|
|
cinder type-access-add
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder type-access-add --volume-type <volume_type> --project-id
|
|
<project_id>
|
|
|
|
Adds volume type access for the given project.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--volume-type <volume_type>``
|
|
Volume type name or ID to add access for the given
|
|
project.
|
|
|
|
``--project-id <project_id>``
|
|
Project ID to add volume type access for.
|
|
|
|
.. _cinder_type-access-list:
|
|
|
|
cinder type-access-list
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder type-access-list --volume-type <volume_type>
|
|
|
|
Print access information about the given volume type.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--volume-type <volume_type>``
|
|
Filter results by volume type name or ID.
|
|
|
|
.. _cinder_type-access-remove:
|
|
|
|
cinder type-access-remove
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder type-access-remove --volume-type <volume_type> --project-id
|
|
<project_id>
|
|
|
|
Removes volume type access for the given project.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--volume-type <volume_type>``
|
|
Volume type name or ID to remove access for the given
|
|
project.
|
|
|
|
``--project-id <project_id>``
|
|
Project ID to remove volume type access for.
|
|
|
|
.. _cinder_type-create:
|
|
|
|
cinder type-create
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder type-create [--description <description>]
|
|
[--is-public <is-public>]
|
|
<name>
|
|
|
|
Creates a volume type.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<name>``
|
|
Name of new volume type.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--description <description>``
|
|
Description of new volume type.
|
|
|
|
``--is-public <is-public>``
|
|
Make type accessible to the public (default true).
|
|
|
|
.. _cinder_type-default:
|
|
|
|
cinder type-default
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder type-default
|
|
|
|
List the default volume type.
|
|
|
|
.. _cinder_type-delete:
|
|
|
|
cinder type-delete
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder type-delete <id>
|
|
|
|
Deletes a volume type.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<id>``
|
|
ID of volume type to delete.
|
|
|
|
.. _cinder_type-key:
|
|
|
|
cinder type-key
|
|
~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder type-key <vtype> <action> <key=value> [<key=value> ...]
|
|
|
|
Sets or unsets extra_spec for a volume type.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<vtype>``
|
|
Name or ID of volume type.
|
|
|
|
``<action>``
|
|
The action. Valid values are "set" or "unset."
|
|
|
|
``<key=value>``
|
|
The extra specs key and value pair to set or unset. For unset,
|
|
specify only the key.
|
|
|
|
.. _cinder_type-list:
|
|
|
|
cinder type-list
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder type-list
|
|
|
|
Lists available 'volume types'. (Admin only will see private types)
|
|
|
|
.. _cinder_type-show:
|
|
|
|
cinder type-show
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder type-show <volume_type>
|
|
|
|
Show volume type details.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume_type>``
|
|
Name or ID of the volume type.
|
|
|
|
.. _cinder_type-update:
|
|
|
|
cinder type-update
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder type-update [--name <name>] [--description <description>]
|
|
[--is-public <is-public>]
|
|
<id>
|
|
|
|
Updates volume type name ,description and/or is_public.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<id>``
|
|
ID of the volume type.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--name <name>``
|
|
Name of the volume type.
|
|
|
|
``--description <description>``
|
|
Description of the volume type.
|
|
|
|
``--is-public <is-public>``
|
|
Make type accessible to the public or not.
|
|
|
|
.. _cinder_unmanage:
|
|
|
|
cinder unmanage
|
|
~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder unmanage <volume>
|
|
|
|
Stop managing a volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of the volume to unmanage.
|
|
|
|
.. _cinder_upload-to-image:
|
|
|
|
cinder upload-to-image
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder upload-to-image [--force [<True|False>]]
|
|
[--container-format <container-format>]
|
|
[--disk-format <disk-format>]
|
|
<volume> <image-name>
|
|
|
|
Uploads volume to Image Service as an image.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume to snapshot.
|
|
|
|
``<image-name>``
|
|
The new image name.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--force [<True|False>]``
|
|
Enables or disables upload of a volume that is
|
|
attached to an instance. Default=False.
|
|
|
|
``--container-format <container-format>``
|
|
Container format type. Default is bare.
|
|
|
|
``--disk-format <disk-format>``
|
|
Disk format type. Default is raw.
|
|
|
|
|
|
Block Storage API v2 commands
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
You can select an API version to use by adding the
|
|
:option:`--os-volume-api-version` parameter or by
|
|
setting the corresponding environment variable:
|
|
|
|
.. code-block:: console
|
|
|
|
export OS_VOLUME_API_VERSION=2
|
|
|
|
.. _cinder_absolute-limits_v2:
|
|
|
|
cinder absolute-limits (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 absolute-limits
|
|
|
|
Lists absolute limits for a user.
|
|
|
|
.. _cinder_availability-zone-list_v2:
|
|
|
|
cinder availability-zone-list (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 availability-zone-list
|
|
|
|
Lists all availability zones.
|
|
|
|
.. _cinder_backup-create_v2:
|
|
|
|
cinder backup-create (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 backup-create [--container <container>] [--name <name>]
|
|
[--description <description>] [--incremental]
|
|
[--force]
|
|
<volume>
|
|
|
|
Creates a volume backup.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume to backup.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--container <container>``
|
|
Backup container name. Default=None.
|
|
|
|
``--name <name>``
|
|
Backup name. Default=None.
|
|
|
|
``--description <description>``
|
|
Backup description. Default=None.
|
|
|
|
``--incremental``
|
|
Incremental backup. Default=False.
|
|
|
|
``--force``
|
|
Allows or disallows backup of a volume when the volume
|
|
is attached to an instance. If set to True, backs up
|
|
the volume whether its status is "available" or "in-
|
|
use". The backup of an "in-use" volume means your data
|
|
is crash consistent. Default=False.
|
|
|
|
.. _cinder_backup-delete_v2:
|
|
|
|
cinder backup-delete (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 backup-delete <backup>
|
|
|
|
Removes a backup.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<backup>``
|
|
Name or ID of backup to delete.
|
|
|
|
.. _cinder_backup-export_v2:
|
|
|
|
cinder backup-export (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 backup-export <backup>
|
|
|
|
Export backup metadata record.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<backup>``
|
|
ID of the backup to export.
|
|
|
|
.. _cinder_backup-import_v2:
|
|
|
|
cinder backup-import (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 backup-import <backup_service> <backup_url>
|
|
|
|
Import backup metadata record.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<backup_service>``
|
|
Backup service to use for importing the backup.
|
|
|
|
``<backup_url>``
|
|
Backup URL for importing the backup metadata.
|
|
|
|
.. _cinder_backup-list_v2:
|
|
|
|
cinder backup-list (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 backup-list [--all-tenants [<all_tenants>]] [--name <name>]
|
|
[--status <status>] [--volume-id <volume-id>]
|
|
[--marker <marker>] [--limit <limit>]
|
|
[--sort <key>[:<direction>]]
|
|
|
|
Lists all backups.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--all-tenants [<all_tenants>]``
|
|
Shows details for all tenants. Admin only.
|
|
|
|
``--name <name>``
|
|
Filters results by a name. Default=None.
|
|
|
|
``--status <status>``
|
|
Filters results by a status. Default=None.
|
|
|
|
``--volume-id <volume-id>``
|
|
Filters results by a volume ID. Default=None.
|
|
|
|
``--marker <marker>``
|
|
Begin returning backups that appear later in the
|
|
backup list than that represented by this id.
|
|
Default=None.
|
|
|
|
``--limit <limit>``
|
|
Maximum number of backups to return. Default=None.
|
|
|
|
``--sort <key>[:<direction>]``
|
|
Comma-separated list of sort keys and directions in
|
|
the form of <key>[:<asc|desc>]. Valid keys: id,
|
|
status, size, availability_zone, name, bootable,
|
|
created_at. Default=None.
|
|
|
|
.. _cinder_backup-reset-state_v2:
|
|
|
|
cinder backup-reset-state (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 backup-reset-state [--state <state>] <backup> [<backup> ...]
|
|
|
|
Explicitly updates the backup state.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<backup>``
|
|
Name or ID of the backup to modify.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--state <state>``
|
|
The state to assign to the backup. Valid values are
|
|
"available", "error", "creating", "deleting", and
|
|
"error_deleting". Default=available.
|
|
|
|
.. _cinder_backup-restore_v2:
|
|
|
|
cinder backup-restore (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 backup-restore [--volume <volume>] <backup>
|
|
|
|
Restores a backup.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<backup>``
|
|
ID of backup to restore.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--volume <volume>``
|
|
Name or ID of volume to which to restore. Default=None.
|
|
|
|
.. _cinder_backup-show_v2:
|
|
|
|
cinder backup-show (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 backup-show <backup>
|
|
|
|
Shows backup details.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<backup>``
|
|
Name or ID of backup.
|
|
|
|
.. _cinder_cgsnapshot-create_v2:
|
|
|
|
cinder cgsnapshot-create (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 cgsnapshot-create [--name <name>] [--description <description>]
|
|
<consistencygroup>
|
|
|
|
Creates a cgsnapshot.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<consistencygroup>``
|
|
Name or ID of a consistency group.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--name <name>``
|
|
Cgsnapshot name. Default=None.
|
|
|
|
``--description <description>``
|
|
Cgsnapshot description. Default=None.
|
|
|
|
.. _cinder_cgsnapshot-delete_v2:
|
|
|
|
cinder cgsnapshot-delete (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 cgsnapshot-delete <cgsnapshot> [<cgsnapshot> ...]
|
|
|
|
Removes one or more cgsnapshots.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<cgsnapshot>``
|
|
Name or ID of one or more cgsnapshots to be deleted.
|
|
|
|
.. _cinder_cgsnapshot-list_v2:
|
|
|
|
cinder cgsnapshot-list (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 cgsnapshot-list [--all-tenants [<0|1>]] [--status <status>]
|
|
[--consistencygroup-id <consistencygroup_id>]
|
|
|
|
Lists all cgsnapshots.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--all-tenants [<0|1>]``
|
|
Shows details for all tenants. Admin only.
|
|
|
|
``--status <status>``
|
|
Filters results by a status. Default=None.
|
|
|
|
``--consistencygroup-id <consistencygroup_id>``
|
|
Filters results by a consistency group ID.
|
|
Default=None.
|
|
|
|
.. _cinder_cgsnapshot-show_v2:
|
|
|
|
cinder cgsnapshot-show (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 cgsnapshot-show <cgsnapshot>
|
|
|
|
Shows cgsnapshot details.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<cgsnapshot>``
|
|
Name or ID of cgsnapshot.
|
|
|
|
.. _cinder_consisgroup-create_v2:
|
|
|
|
cinder consisgroup-create (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 consisgroup-create [--name <name>] [--description <description>]
|
|
[--availability-zone <availability-zone>]
|
|
<volume-types>
|
|
|
|
Creates a consistency group.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume-types>``
|
|
Volume types.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--name <name>``
|
|
Name of a consistency group.
|
|
|
|
``--description <description>``
|
|
Description of a consistency group. Default=None.
|
|
|
|
``--availability-zone <availability-zone>``
|
|
Availability zone for volume. Default=None.
|
|
|
|
.. _cinder_consisgroup-create-from-src_v2:
|
|
|
|
cinder consisgroup-create-from-src (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 consisgroup-create-from-src [--cgsnapshot <cgsnapshot>]
|
|
[--source-cg <source-cg>]
|
|
[--name <name>]
|
|
[--description <description>]
|
|
|
|
Creates a consistency group from a cgsnapshot or a source CG.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--cgsnapshot <cgsnapshot>``
|
|
Name or ID of a cgsnapshot. Default=None.
|
|
|
|
``--source-cg <source-cg>``
|
|
Name or ID of a source CG. Default=None.
|
|
|
|
``--name <name>``
|
|
Name of a consistency group. Default=None.
|
|
|
|
``--description <description>``
|
|
Description of a consistency group. Default=None.
|
|
|
|
.. _cinder_consisgroup-delete_v2:
|
|
|
|
cinder consisgroup-delete (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 consisgroup-delete [--force]
|
|
<consistencygroup> [<consistencygroup> ...]
|
|
|
|
Removes one or more consistency groups.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<consistencygroup>``
|
|
Name or ID of one or more consistency groups to be
|
|
deleted.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--force``
|
|
Allows or disallows consistency groups to be deleted. If
|
|
the consistency group is empty, it can be deleted
|
|
without the force flag. If the consistency group is not
|
|
empty, the force flag is required for it to be deleted.
|
|
|
|
.. _cinder_consisgroup-list_v2:
|
|
|
|
cinder consisgroup-list (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 consisgroup-list [--all-tenants [<0|1>]]
|
|
|
|
Lists all consistencygroups.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--all-tenants [<0|1>]``
|
|
Shows details for all tenants. Admin only.
|
|
|
|
.. _cinder_consisgroup-show_v2:
|
|
|
|
cinder consisgroup-show (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 consisgroup-show <consistencygroup>
|
|
|
|
Shows details of a consistency group.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<consistencygroup>``
|
|
Name or ID of a consistency group.
|
|
|
|
.. _cinder_consisgroup-update_v2:
|
|
|
|
cinder consisgroup-update (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 consisgroup-update [--name <name>] [--description <description>]
|
|
[--add-volumes <uuid1,uuid2,......>]
|
|
[--remove-volumes <uuid3,uuid4,......>]
|
|
<consistencygroup>
|
|
|
|
Updates a consistencygroup.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<consistencygroup>``
|
|
Name or ID of a consistency group.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--name <name>``
|
|
New name for consistency group. Default=None.
|
|
|
|
``--description <description>``
|
|
New description for consistency group. Default=None.
|
|
|
|
``--add-volumes <uuid1,uuid2,......>``
|
|
UUID of one or more volumes to be added to the
|
|
consistency group, separated by commas. Default=None.
|
|
|
|
``--remove-volumes <uuid3,uuid4,......>``
|
|
UUID of one or more volumes to be removed from the
|
|
consistency group, separated by commas. Default=None.
|
|
|
|
.. _cinder_create_v2:
|
|
|
|
cinder create (v2)
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 create [--consisgroup-id <consistencygroup-id>]
|
|
[--snapshot-id <snapshot-id>]
|
|
[--source-volid <source-volid>]
|
|
[--source-replica <source-replica>]
|
|
[--image-id <image-id>] [--image <image>] [--name <name>]
|
|
[--description <description>]
|
|
[--volume-type <volume-type>]
|
|
[--availability-zone <availability-zone>]
|
|
[--metadata [<key=value> [<key=value> ...]]]
|
|
[--hint <key=value>] [--allow-multiattach]
|
|
[<size>]
|
|
|
|
Creates a volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<size>``
|
|
Size of volume, in GiBs. (Required unless snapshot-id
|
|
/source-volid is specified).
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--consisgroup-id <consistencygroup-id>``
|
|
ID of a consistency group where the new volume belongs
|
|
to. Default=None.
|
|
|
|
``--snapshot-id <snapshot-id>``
|
|
Creates volume from snapshot ID. Default=None.
|
|
|
|
``--source-volid <source-volid>``
|
|
Creates volume from volume ID. Default=None.
|
|
|
|
``--source-replica <source-replica>``
|
|
Creates volume from replicated volume ID.
|
|
Default=None.
|
|
|
|
``--image-id <image-id>``
|
|
Creates volume from image ID. Default=None.
|
|
|
|
``--image <image>``
|
|
Creates a volume from image (ID or name).
|
|
Default=None.
|
|
|
|
``--name <name>``
|
|
Volume name. Default=None.
|
|
|
|
``--description <description>``
|
|
Volume description. Default=None.
|
|
|
|
``--volume-type <volume-type>``
|
|
Volume type. Default=None.
|
|
|
|
``--availability-zone <availability-zone>``
|
|
Availability zone for volume. Default=None.
|
|
|
|
``--metadata [<key=value> [<key=value> ...]]``
|
|
Metadata key and value pairs. Default=None.
|
|
|
|
``--hint <key=value>``
|
|
Scheduler hint, like in nova.
|
|
|
|
``--allow-multiattach``
|
|
Allow volume to be attached more than once.
|
|
Default=False
|
|
|
|
.. _cinder_credentials_v2:
|
|
|
|
cinder credentials (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 credentials
|
|
|
|
Shows user credentials returned from auth.
|
|
|
|
.. _cinder_delete_v2:
|
|
|
|
cinder delete (v2)
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 delete <volume> [<volume> ...]
|
|
|
|
Removes one or more volumes.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume or volumes to delete.
|
|
|
|
.. _cinder_encryption-type-create_v2:
|
|
|
|
cinder encryption-type-create (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 encryption-type-create [--cipher <cipher>]
|
|
[--key_size <key_size>]
|
|
[--control_location <control_location>]
|
|
<volume_type> <provider>
|
|
|
|
Creates encryption type for a volume type. Admin only.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume_type>``
|
|
Name or ID of volume type.
|
|
|
|
``<provider>``
|
|
The class that provides encryption support. For
|
|
example, LuksEncryptor.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--cipher <cipher>``
|
|
The encryption algorithm or mode. For example, aes-
|
|
xts-plain64. Default=None.
|
|
|
|
``--key_size <key_size>``
|
|
Size of encryption key, in bits. For example, 128 or
|
|
256. Default=None.
|
|
|
|
``--control_location <control_location>``
|
|
Notional service where encryption is performed. Valid
|
|
values are "front-end" or "back-end." For example,
|
|
front-end=Nova. Default is "front-end."
|
|
|
|
.. _cinder_encryption-type-delete_v2:
|
|
|
|
cinder encryption-type-delete (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 encryption-type-delete <volume_type>
|
|
|
|
Deletes encryption type for a volume type. Admin only.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume_type>``
|
|
Name or ID of volume type.
|
|
|
|
.. _cinder_encryption-type-list_v2:
|
|
|
|
cinder encryption-type-list (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 encryption-type-list
|
|
|
|
Shows encryption type details for volume types. Admin only.
|
|
|
|
.. _cinder_encryption-type-show_v2:
|
|
|
|
cinder encryption-type-show (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 encryption-type-show <volume_type>
|
|
|
|
Shows encryption type details for a volume type. Admin only.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume_type>``
|
|
Name or ID of volume type.
|
|
|
|
.. _cinder_encryption-type-update_v2:
|
|
|
|
cinder encryption-type-update (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 encryption-type-update [--provider <provider>]
|
|
[--cipher [<cipher>]]
|
|
[--key-size [<key-size>]]
|
|
[--control-location <control-location>]
|
|
<volume-type>
|
|
|
|
Update encryption type information for a volume type (Admin Only).
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume-type>``
|
|
Name or ID of the volume type
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--provider <provider>``
|
|
Class providing encryption support (e.g.
|
|
LuksEncryptor) (Optional)
|
|
|
|
``--cipher [<cipher>]``
|
|
Encryption algorithm/mode to use (e.g., aes-xts-
|
|
plain64). Provide parameter without value to set to
|
|
provider default. (Optional)
|
|
|
|
``--key-size [<key-size>]``
|
|
Size of the encryption key, in bits (e.g., 128, 256).
|
|
Provide parameter without value to set to provider
|
|
default. (Optional)
|
|
|
|
``--control-location <control-location>``
|
|
Notional service where encryption is performed (e.g.,
|
|
front-end=Nova). Values: 'front-end', 'back-end'
|
|
(Optional)
|
|
|
|
.. _cinder_endpoints_v2:
|
|
|
|
cinder endpoints (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 endpoints
|
|
|
|
Discovers endpoints registered by authentication service.
|
|
|
|
.. _cinder_extend_v2:
|
|
|
|
cinder extend (v2)
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 extend <volume> <new_size>
|
|
|
|
Attempts to extend size of an existing volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume to extend.
|
|
|
|
``<new_size>``
|
|
New size of volume, in GiBs.
|
|
|
|
.. _cinder_extra-specs-list_v2:
|
|
|
|
cinder extra-specs-list (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 extra-specs-list
|
|
|
|
Lists current volume types and extra specs.
|
|
|
|
.. _cinder_force-delete_v2:
|
|
|
|
cinder force-delete (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 force-delete <volume> [<volume> ...]
|
|
|
|
Attempts force-delete of volume, regardless of state.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume or volumes to delete.
|
|
|
|
.. _cinder_get-capabilities_v2:
|
|
|
|
cinder get-capabilities (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 get-capabilities <host>
|
|
|
|
Show backend volume stats and properties. Admin only.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<host>``
|
|
Cinder host to show backend volume stats and properties; takes the
|
|
form: host@backend-name
|
|
|
|
.. _cinder_get-pools_v2:
|
|
|
|
cinder get-pools (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 get-pools [--detail]
|
|
|
|
Show pool information for backends. Admin only.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--detail``
|
|
Show detailed information about pools.
|
|
|
|
.. _cinder_image-metadata_v2:
|
|
|
|
cinder image-metadata (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 image-metadata <volume> <action> <key=value> [<key=value> ...]
|
|
|
|
Sets or deletes volume image metadata.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume for which to update metadata.
|
|
|
|
``<action>``
|
|
The action. Valid values are 'set' or 'unset.'
|
|
|
|
``<key=value>``
|
|
Metadata key and value pair to set or unset. For unset, specify
|
|
only the key.
|
|
|
|
.. _cinder_image-metadata-show_v2:
|
|
|
|
cinder image-metadata-show (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 image-metadata-show <volume>
|
|
|
|
Shows volume image metadata.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume.
|
|
|
|
.. _cinder_list_v2:
|
|
|
|
cinder list (v2)
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 list [--all-tenants [<0|1>]] [--name <name>] [--status <status>]
|
|
[--migration_status <migration_status>]
|
|
[--metadata [<key=value> [<key=value> ...]]]
|
|
[--marker <marker>] [--limit <limit>]
|
|
[--sort <key>[:<direction>]] [--tenant [<tenant>]]
|
|
|
|
Lists all volumes.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--all-tenants [<0|1>]``
|
|
Shows details for all tenants. Admin only.
|
|
|
|
``--name <name>``
|
|
Filters results by a name. Default=None.
|
|
|
|
``--status <status>``
|
|
Filters results by a status. Default=None.
|
|
|
|
``--migration_status <migration_status>``
|
|
Filters results by a migration status. Default=None.
|
|
Admin only.
|
|
|
|
``--metadata [<key=value> [<key=value> ...]]``
|
|
Filters results by a metadata key and value pair.
|
|
Default=None.
|
|
|
|
``--marker <marker>``
|
|
Begin returning volumes that appear later in the
|
|
volume list than that represented by this volume id.
|
|
Default=None.
|
|
|
|
``--limit <limit>``
|
|
Maximum number of volumes to return. Default=None.
|
|
|
|
``--sort <key>[:<direction>]``
|
|
Comma-separated list of sort keys and directions in
|
|
the form of <key>[:<asc|desc>]. Valid keys: id,
|
|
status, size, availability_zone, name, bootable,
|
|
created_at. Default=None.
|
|
|
|
``--tenant [<tenant>]``
|
|
Display information from single tenant (Admin only).
|
|
|
|
.. _cinder_list-extensions_v2:
|
|
|
|
cinder list-extensions (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 list-extensions
|
|
|
|
Lists all available os-api extensions.
|
|
|
|
.. _cinder_manage_v2:
|
|
|
|
cinder manage (v2)
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 manage [--id-type <id-type>] [--name <name>]
|
|
[--description <description>]
|
|
[--volume-type <volume-type>]
|
|
[--availability-zone <availability-zone>]
|
|
[--metadata [<key=value> [<key=value> ...]]] [--bootable]
|
|
<host> <identifier>
|
|
|
|
Manage an existing volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<host>``
|
|
Cinder host on which the existing volume resides;
|
|
takes the form: host@backend-name#pool
|
|
|
|
``<identifier>``
|
|
Name or other Identifier for existing volume
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--id-type <id-type>``
|
|
Type of backend device identifier provided, typically
|
|
source-name or source-id (Default=source-name)
|
|
|
|
``--name <name>``
|
|
Volume name (Default=None)
|
|
|
|
``--description <description>``
|
|
Volume description (Default=None)
|
|
|
|
``--volume-type <volume-type>``
|
|
Volume type (Default=None)
|
|
|
|
``--availability-zone <availability-zone>``
|
|
Availability zone for volume (Default=None)
|
|
|
|
``--metadata [<key=value> [<key=value> ...]]``
|
|
Metadata key=value pairs (Default=None)
|
|
|
|
``--bootable``
|
|
Specifies that the newly created volume should be
|
|
marked as bootable
|
|
|
|
.. _cinder_metadata_v2:
|
|
|
|
cinder metadata (v2)
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 metadata <volume> <action> <key=value> [<key=value> ...]
|
|
|
|
Sets or deletes volume metadata.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume for which to update metadata.
|
|
|
|
``<action>``
|
|
The action. Valid values are "set" or "unset."
|
|
|
|
``<key=value>``
|
|
Metadata key and value pair to set or unset. For unset, specify
|
|
only the key.
|
|
|
|
.. _cinder_metadata-show_v2:
|
|
|
|
cinder metadata-show (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 metadata-show <volume>
|
|
|
|
Shows volume metadata.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume.
|
|
|
|
.. _cinder_metadata-update-all_v2:
|
|
|
|
cinder metadata-update-all (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 metadata-update-all <volume> <key=value> [<key=value> ...]
|
|
|
|
Updates volume metadata.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume for which to update metadata.
|
|
|
|
``<key=value>``
|
|
Metadata key and value pair or pairs to update.
|
|
|
|
.. _cinder_migrate_v2:
|
|
|
|
cinder migrate (v2)
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 migrate [--force-host-copy [<True|False>]]
|
|
[--lock-volume [<True|False>]]
|
|
<volume> <host>
|
|
|
|
Migrates volume to a new host.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume to migrate.
|
|
|
|
``<host>``
|
|
Destination host. Takes the form: host@backend-
|
|
name#pool
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--force-host-copy [<True|False>]``
|
|
Enables or disables generic host-based force-
|
|
migration, which bypasses driver optimizations.
|
|
Default=False.
|
|
|
|
``--lock-volume [<True|False>]``
|
|
Enables or disables the termination of volume
|
|
migration caused by other commands. This option
|
|
applies to the available volume. True means it locks
|
|
the volume state and does not allow the migration to
|
|
be aborted. The volume status will be in maintenance
|
|
during the migration. False means it allows the volume
|
|
migration to be aborted. The volume status is still in
|
|
the original status. Default=False.
|
|
|
|
.. _cinder_qos-associate_v2:
|
|
|
|
cinder qos-associate (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 qos-associate <qos_specs> <volume_type_id>
|
|
|
|
Associates qos specs with specified volume type.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<qos_specs>``
|
|
ID of QoS specifications.
|
|
|
|
``<volume_type_id>``
|
|
ID of volume type with which to associate QoS
|
|
specifications.
|
|
|
|
.. _cinder_qos-create_v2:
|
|
|
|
cinder qos-create (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 qos-create <name> <key=value> [<key=value> ...]
|
|
|
|
Creates a qos specs.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<name>``
|
|
Name of new QoS specifications.
|
|
|
|
``<key=value>``
|
|
QoS specifications.
|
|
|
|
.. _cinder_qos-delete_v2:
|
|
|
|
cinder qos-delete (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 qos-delete [--force [<True|False>]] <qos_specs>
|
|
|
|
Deletes a specified qos specs.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<qos_specs>``
|
|
ID of QoS specifications to delete.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--force [<True|False>]``
|
|
Enables or disables deletion of in-use QoS
|
|
specifications. Default=False.
|
|
|
|
.. _cinder_qos-disassociate_v2:
|
|
|
|
cinder qos-disassociate (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 qos-disassociate <qos_specs> <volume_type_id>
|
|
|
|
Disassociates qos specs from specified volume type.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<qos_specs>``
|
|
ID of QoS specifications.
|
|
|
|
``<volume_type_id>``
|
|
ID of volume type with which to associate QoS
|
|
specifications.
|
|
|
|
.. _cinder_qos-disassociate-all_v2:
|
|
|
|
cinder qos-disassociate-all (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 qos-disassociate-all <qos_specs>
|
|
|
|
Disassociates qos specs from all its associations.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<qos_specs>``
|
|
ID of QoS specifications on which to operate.
|
|
|
|
.. _cinder_qos-get-association_v2:
|
|
|
|
cinder qos-get-association (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 qos-get-association <qos_specs>
|
|
|
|
Lists all associations for specified qos specs.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<qos_specs>``
|
|
ID of QoS specifications.
|
|
|
|
.. _cinder_qos-key_v2:
|
|
|
|
cinder qos-key (v2)
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 qos-key <qos_specs> <action> key=value [key=value ...]
|
|
|
|
Sets or unsets specifications for a qos spec.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<qos_specs>``
|
|
ID of QoS specifications.
|
|
|
|
``<action>``
|
|
The action. Valid values are "set" or "unset."
|
|
|
|
``key=value``
|
|
Metadata key and value pair to set or unset. For unset, specify
|
|
only the key.
|
|
|
|
.. _cinder_qos-list_v2:
|
|
|
|
cinder qos-list (v2)
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 qos-list
|
|
|
|
Lists qos specs.
|
|
|
|
.. _cinder_qos-show_v2:
|
|
|
|
cinder qos-show (v2)
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 qos-show <qos_specs>
|
|
|
|
Shows qos specs details.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<qos_specs>``
|
|
ID of QoS specifications to show.
|
|
|
|
.. _cinder_quota-class-show_v2:
|
|
|
|
cinder quota-class-show (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 quota-class-show <class>
|
|
|
|
Lists quotas for a quota class.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<class>``
|
|
Name of quota class for which to list quotas.
|
|
|
|
.. _cinder_quota-class-update_v2:
|
|
|
|
cinder quota-class-update (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 quota-class-update [--volumes <volumes>]
|
|
[--snapshots <snapshots>]
|
|
[--gigabytes <gigabytes>]
|
|
[--volume-type <volume_type_name>]
|
|
<class_name>
|
|
|
|
Updates quotas for a quota class.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<class_name>``
|
|
Name of quota class for which to set quotas.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--volumes <volumes>``
|
|
The new "volumes" quota value. Default=None.
|
|
|
|
``--snapshots <snapshots>``
|
|
The new "snapshots" quota value. Default=None.
|
|
|
|
``--gigabytes <gigabytes>``
|
|
The new "gigabytes" quota value. Default=None.
|
|
|
|
``--volume-type <volume_type_name>``
|
|
Volume type. Default=None.
|
|
|
|
.. _cinder_quota-defaults_v2:
|
|
|
|
cinder quota-defaults (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 quota-defaults <tenant_id>
|
|
|
|
Lists default quotas for a tenant.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<tenant_id>``
|
|
ID of tenant for which to list quota defaults.
|
|
|
|
.. _cinder_quota-delete_v2:
|
|
|
|
cinder quota-delete (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 quota-delete <tenant_id>
|
|
|
|
Delete the quotas for a tenant.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<tenant_id>``
|
|
UUID of tenant to delete the quotas for.
|
|
|
|
.. _cinder_quota-show_v2:
|
|
|
|
cinder quota-show (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 quota-show <tenant_id>
|
|
|
|
Lists quotas for a tenant.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<tenant_id>``
|
|
ID of tenant for which to list quotas.
|
|
|
|
.. _cinder_quota-update_v2:
|
|
|
|
cinder quota-update (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 quota-update [--volumes <volumes>] [--snapshots <snapshots>]
|
|
[--gigabytes <gigabytes>] [--backups <backups>]
|
|
[--backup-gigabytes <backup_gigabytes>]
|
|
[--consistencygroups <consistencygroups>]
|
|
[--volume-type <volume_type_name>]
|
|
[--per-volume-gigabytes <per_volume_gigabytes>]
|
|
<tenant_id>
|
|
|
|
Updates quotas for a tenant.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<tenant_id>``
|
|
ID of tenant for which to set quotas.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--volumes <volumes>``
|
|
The new "volumes" quota value. Default=None.
|
|
|
|
``--snapshots <snapshots>``
|
|
The new "snapshots" quota value. Default=None.
|
|
|
|
``--gigabytes <gigabytes>``
|
|
The new "gigabytes" quota value. Default=None.
|
|
|
|
``--backups <backups>``
|
|
The new "backups" quota value. Default=None.
|
|
|
|
``--backup-gigabytes <backup_gigabytes>``
|
|
The new "backup_gigabytes" quota value. Default=None.
|
|
|
|
``--consistencygroups <consistencygroups>``
|
|
The new "consistencygroups" quota value. Default=None.
|
|
|
|
``--volume-type <volume_type_name>``
|
|
Volume type. Default=None.
|
|
|
|
``--per-volume-gigabytes <per_volume_gigabytes>``
|
|
Set max volume size limit. Default=None.
|
|
|
|
.. _cinder_quota-usage_v2:
|
|
|
|
cinder quota-usage (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 quota-usage <tenant_id>
|
|
|
|
Lists quota usage for a tenant.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<tenant_id>``
|
|
ID of tenant for which to list quota usage.
|
|
|
|
.. _cinder_rate-limits_v2:
|
|
|
|
cinder rate-limits (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 rate-limits
|
|
|
|
Lists rate limits for a user.
|
|
|
|
.. _cinder_readonly-mode-update_v2:
|
|
|
|
cinder readonly-mode-update (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 readonly-mode-update <volume> <True|true|False|false>
|
|
|
|
Updates volume read-only access-mode flag.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume to update.
|
|
|
|
``<True|true|False|false>``
|
|
Enables or disables update of volume to read-only
|
|
access mode.
|
|
|
|
.. _cinder_rename_v2:
|
|
|
|
cinder rename (v2)
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 rename [--description <description>] <volume> [<name>]
|
|
|
|
Renames a volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume to rename.
|
|
|
|
``<name>``
|
|
New name for volume.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--description <description>``
|
|
Volume description. Default=None.
|
|
|
|
.. _cinder_replication-disable_v2:
|
|
|
|
cinder replication-disable (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 replication-disable <volume>
|
|
|
|
Disables volume replication on a given volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume to disable replication.
|
|
|
|
.. _cinder_replication-enable_v2:
|
|
|
|
cinder replication-enable (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 replication-enable <volume>
|
|
|
|
Enables volume replication on a given volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume to enable replication.
|
|
|
|
.. _cinder_replication-failover_v2:
|
|
|
|
cinder replication-failover (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 replication-failover <volume> <secondary>
|
|
|
|
Failover a volume to a secondary target
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume to failover.
|
|
|
|
``<secondary>``
|
|
A unqiue identifier that represents a failover target.
|
|
|
|
.. _cinder_replication-list-targets_v2:
|
|
|
|
cinder replication-list-targets (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 replication-list-targets <volume>
|
|
|
|
List replication targets available for a volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of volume to list available replication targets.
|
|
|
|
.. _cinder_replication-promote_v2:
|
|
|
|
cinder replication-promote (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 replication-promote <volume>
|
|
|
|
Promote a secondary volume to primary for a relationship.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of the volume to promote. The volume should have the
|
|
replica volume created with source-replica argument.
|
|
|
|
.. _cinder_replication-reenable_v2:
|
|
|
|
cinder replication-reenable (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 replication-reenable <volume>
|
|
|
|
Sync the secondary volume with primary for a relationship.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of the volume to reenable replication. The replication-
|
|
status of the volume should be inactive.
|
|
|
|
.. _cinder_reset-state_v2:
|
|
|
|
cinder reset-state (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 reset-state [--state <state>] [--attach-status <attach-status>]
|
|
[--reset-migration-status]
|
|
<volume> [<volume> ...]
|
|
|
|
Explicitly updates the volume state in the Cinder database. Note that this
|
|
does not affect whether the volume is actually attached to the Nova compute
|
|
host or instance and can result in an unusable volume. Being a database change
|
|
only, this has no impact on the true state of the volume and may not match the
|
|
actual state. This can render a volume unusable in the case of change to the
|
|
'available' state.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume to modify.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--state <state>``
|
|
The state to assign to the volume. Valid values are
|
|
"available", "error", "creating", "deleting", "in-
|
|
use", "attaching", "detaching", "error_deleting" and
|
|
"maintenance". NOTE: This command simply changes the
|
|
state of the Volume in the DataBase with no regard to
|
|
actual status, exercise caution when using.
|
|
Default=available.
|
|
|
|
``--attach-status <attach-status>``
|
|
The attach status to assign to the volume in the
|
|
DataBase, with no regard to the actual status. Valid
|
|
values are "attached" and "detached". Default=None,
|
|
that means the status is unchanged.
|
|
|
|
``--reset-migration-status``
|
|
Clears the migration status of the volume in the
|
|
DataBase that indicates the volume is source or
|
|
destination of volume migration, with no regard to the
|
|
actual status.
|
|
|
|
.. _cinder_retype_v2:
|
|
|
|
cinder retype (v2)
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 retype [--migration-policy <never|on-demand>]
|
|
<volume> <volume-type>
|
|
|
|
Changes the volume type for a volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume for which to modify type.
|
|
|
|
``<volume-type>``
|
|
New volume type.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--migration-policy <never|on-demand>``
|
|
Migration policy during retype of volume.
|
|
|
|
.. _cinder_service-disable_v2:
|
|
|
|
cinder service-disable (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 service-disable [--reason <reason>] <hostname> <binary>
|
|
|
|
Disables the service.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<hostname>``
|
|
Host name.
|
|
|
|
``<binary>``
|
|
Service binary.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--reason <reason>``
|
|
Reason for disabling service.
|
|
|
|
.. _cinder_service-enable_v2:
|
|
|
|
cinder service-enable (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 service-enable <hostname> <binary>
|
|
|
|
Enables the service.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<hostname>``
|
|
Host name.
|
|
|
|
``<binary>``
|
|
Service binary.
|
|
|
|
.. _cinder_service-list_v2:
|
|
|
|
cinder service-list (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 service-list [--host <hostname>] [--binary <binary>]
|
|
|
|
Lists all services. Filter by host and service binary.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--host <hostname>``
|
|
Host name. Default=None.
|
|
|
|
``--binary <binary>``
|
|
Service binary. Default=None.
|
|
|
|
.. _cinder_set-bootable_v2:
|
|
|
|
cinder set-bootable (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 set-bootable <volume> <True|true|False|false>
|
|
|
|
Update bootable status of a volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
ID of the volume to update.
|
|
|
|
``<True|true|False|false>``
|
|
Flag to indicate whether volume is bootable.
|
|
|
|
.. _cinder_show_v2:
|
|
|
|
cinder show (v2)
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 show <volume>
|
|
|
|
Shows volume details.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume.
|
|
|
|
.. _cinder_snapshot-create_v2:
|
|
|
|
cinder snapshot-create (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 snapshot-create [--force [<True|False>]] [--name <name>]
|
|
[--description <description>]
|
|
[--metadata [<key=value> [<key=value> ...]]]
|
|
<volume>
|
|
|
|
Creates a snapshot.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume to snapshot.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--force [<True|False>]``
|
|
Allows or disallows snapshot of a volume when the
|
|
volume is attached to an instance. If set to True,
|
|
ignores the current status of the volume when
|
|
attempting to snapshot it rather than forcing it to be
|
|
available. Default=False.
|
|
|
|
``--name <name>``
|
|
Snapshot name. Default=None.
|
|
|
|
``--description <description>``
|
|
Snapshot description. Default=None.
|
|
|
|
``--metadata [<key=value> [<key=value> ...]]``
|
|
Snapshot metadata key and value pairs. Default=None.
|
|
|
|
.. _cinder_snapshot-delete_v2:
|
|
|
|
cinder snapshot-delete (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 snapshot-delete <snapshot> [<snapshot> ...]
|
|
|
|
Removes one or more snapshots.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<snapshot>``
|
|
Name or ID of the snapshot(s) to delete.
|
|
|
|
.. _cinder_snapshot-list_v2:
|
|
|
|
cinder snapshot-list (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 snapshot-list [--all-tenants [<0|1>]] [--name <name>]
|
|
[--status <status>] [--volume-id <volume-id>]
|
|
[--marker <marker>] [--limit <limit>]
|
|
[--sort <key>[:<direction>]]
|
|
|
|
Lists all snapshots.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--all-tenants [<0|1>]``
|
|
Shows details for all tenants. Admin only.
|
|
|
|
``--name <name>``
|
|
Filters results by a name. Default=None.
|
|
|
|
``--status <status>``
|
|
Filters results by a status. Default=None.
|
|
|
|
``--volume-id <volume-id>``
|
|
Filters results by a volume ID. Default=None.
|
|
|
|
``--marker <marker>``
|
|
Begin returning snapshots that appear later in the
|
|
snapshot list than that represented by this id.
|
|
Default=None.
|
|
|
|
``--limit <limit>``
|
|
Maximum number of snapshots to return. Default=None.
|
|
|
|
``--sort <key>[:<direction>]``
|
|
Comma-separated list of sort keys and directions in
|
|
the form of <key>[:<asc|desc>]. Valid keys: id,
|
|
status, size, availability_zone, name, bootable,
|
|
created_at. Default=None.
|
|
|
|
.. _cinder_snapshot-metadata_v2:
|
|
|
|
cinder snapshot-metadata (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 snapshot-metadata <snapshot> <action> <key=value>
|
|
[<key=value> ...]
|
|
|
|
Sets or deletes snapshot metadata.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<snapshot>``
|
|
ID of snapshot for which to update metadata.
|
|
|
|
``<action>``
|
|
The action. Valid values are "set" or "unset."
|
|
|
|
``<key=value>``
|
|
Metadata key and value pair to set or unset. For unset, specify
|
|
only the key.
|
|
|
|
.. _cinder_snapshot-metadata-show_v2:
|
|
|
|
cinder snapshot-metadata-show (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 snapshot-metadata-show <snapshot>
|
|
|
|
Shows snapshot metadata.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<snapshot>``
|
|
ID of snapshot.
|
|
|
|
.. _cinder_snapshot-metadata-update-all_v2:
|
|
|
|
cinder snapshot-metadata-update-all (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 snapshot-metadata-update-all <snapshot> <key=value>
|
|
[<key=value> ...]
|
|
|
|
Updates snapshot metadata.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<snapshot>``
|
|
ID of snapshot for which to update metadata.
|
|
|
|
``<key=value>``
|
|
Metadata key and value pair to update.
|
|
|
|
.. _cinder_snapshot-rename_v2:
|
|
|
|
cinder snapshot-rename (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 snapshot-rename [--description <description>]
|
|
<snapshot> [<name>]
|
|
|
|
Renames a snapshot.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<snapshot>``
|
|
Name or ID of snapshot.
|
|
|
|
``<name>``
|
|
New name for snapshot.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--description <description>``
|
|
Snapshot description. Default=None.
|
|
|
|
.. _cinder_snapshot-reset-state_v2:
|
|
|
|
cinder snapshot-reset-state (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 snapshot-reset-state [--state <state>]
|
|
<snapshot> [<snapshot> ...]
|
|
|
|
Explicitly updates the snapshot state.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<snapshot>``
|
|
Name or ID of snapshot to modify.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--state <state>``
|
|
The state to assign to the snapshot. Valid values are
|
|
"available", "error", "creating", "deleting", and
|
|
"error_deleting". NOTE: This command simply changes the
|
|
state of the Snapshot in the DataBase with no regard to
|
|
actual status, exercise caution when using.
|
|
Default=available.
|
|
|
|
.. _cinder_snapshot-show_v2:
|
|
|
|
cinder snapshot-show (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 snapshot-show <snapshot>
|
|
|
|
Shows snapshot details.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<snapshot>``
|
|
Name or ID of snapshot.
|
|
|
|
.. _cinder_transfer-accept_v2:
|
|
|
|
cinder transfer-accept (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 transfer-accept <transfer> <auth_key>
|
|
|
|
Accepts a volume transfer.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<transfer>``
|
|
ID of transfer to accept.
|
|
|
|
``<auth_key>``
|
|
Authentication key of transfer to accept.
|
|
|
|
.. _cinder_transfer-create_v2:
|
|
|
|
cinder transfer-create (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 transfer-create [--name <name>] <volume>
|
|
|
|
Creates a volume transfer.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume to transfer.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--name <name>``
|
|
Transfer name. Default=None.
|
|
|
|
.. _cinder_transfer-delete_v2:
|
|
|
|
cinder transfer-delete (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 transfer-delete <transfer>
|
|
|
|
Undoes a transfer.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<transfer>``
|
|
Name or ID of transfer to delete.
|
|
|
|
.. _cinder_transfer-list_v2:
|
|
|
|
cinder transfer-list (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 transfer-list [--all-tenants [<0|1>]]
|
|
|
|
Lists all transfers.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--all-tenants [<0|1>]``
|
|
Shows details for all tenants. Admin only.
|
|
|
|
.. _cinder_transfer-show_v2:
|
|
|
|
cinder transfer-show (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 transfer-show <transfer>
|
|
|
|
Shows transfer details.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<transfer>``
|
|
Name or ID of transfer to accept.
|
|
|
|
.. _cinder_type-access-add_v2:
|
|
|
|
cinder type-access-add (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 type-access-add --volume-type <volume_type> --project-id
|
|
<project_id>
|
|
|
|
Adds volume type access for the given project.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--volume-type <volume_type>``
|
|
Volume type name or ID to add access for the given
|
|
project.
|
|
|
|
``--project-id <project_id>``
|
|
Project ID to add volume type access for.
|
|
|
|
.. _cinder_type-access-list_v2:
|
|
|
|
cinder type-access-list (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 type-access-list --volume-type <volume_type>
|
|
|
|
Print access information about the given volume type.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--volume-type <volume_type>``
|
|
Filter results by volume type name or ID.
|
|
|
|
.. _cinder_type-access-remove_v2:
|
|
|
|
cinder type-access-remove (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 type-access-remove --volume-type <volume_type> --project-id
|
|
<project_id>
|
|
|
|
Removes volume type access for the given project.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--volume-type <volume_type>``
|
|
Volume type name or ID to remove access for the given
|
|
project.
|
|
|
|
``--project-id <project_id>``
|
|
Project ID to remove volume type access for.
|
|
|
|
.. _cinder_type-create_v2:
|
|
|
|
cinder type-create (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 type-create [--description <description>]
|
|
[--is-public <is-public>]
|
|
<name>
|
|
|
|
Creates a volume type.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<name>``
|
|
Name of new volume type.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--description <description>``
|
|
Description of new volume type.
|
|
|
|
``--is-public <is-public>``
|
|
Make type accessible to the public (default true).
|
|
|
|
.. _cinder_type-default_v2:
|
|
|
|
cinder type-default (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 type-default
|
|
|
|
List the default volume type.
|
|
|
|
.. _cinder_type-delete_v2:
|
|
|
|
cinder type-delete (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 type-delete <id>
|
|
|
|
Deletes a volume type.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<id>``
|
|
ID of volume type to delete.
|
|
|
|
.. _cinder_type-key_v2:
|
|
|
|
cinder type-key (v2)
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 type-key <vtype> <action> <key=value> [<key=value> ...]
|
|
|
|
Sets or unsets extra_spec for a volume type.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<vtype>``
|
|
Name or ID of volume type.
|
|
|
|
``<action>``
|
|
The action. Valid values are "set" or "unset."
|
|
|
|
``<key=value>``
|
|
The extra specs key and value pair to set or unset. For unset,
|
|
specify only the key.
|
|
|
|
.. _cinder_type-list_v2:
|
|
|
|
cinder type-list (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 type-list
|
|
|
|
Lists available 'volume types'. (Admin only will see private types)
|
|
|
|
.. _cinder_type-show_v2:
|
|
|
|
cinder type-show (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 type-show <volume_type>
|
|
|
|
Show volume type details.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume_type>``
|
|
Name or ID of the volume type.
|
|
|
|
.. _cinder_type-update_v2:
|
|
|
|
cinder type-update (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 type-update [--name <name>] [--description <description>]
|
|
[--is-public <is-public>]
|
|
<id>
|
|
|
|
Updates volume type name ,description and/or is_public.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<id>``
|
|
ID of the volume type.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--name <name>``
|
|
Name of the volume type.
|
|
|
|
``--description <description>``
|
|
Description of the volume type.
|
|
|
|
``--is-public <is-public>``
|
|
Make type accessible to the public or not.
|
|
|
|
.. _cinder_unmanage_v2:
|
|
|
|
cinder unmanage (v2)
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 unmanage <volume>
|
|
|
|
Stop managing a volume.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of the volume to unmanage.
|
|
|
|
.. _cinder_upload-to-image_v2:
|
|
|
|
cinder upload-to-image (v2)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. code-block:: console
|
|
|
|
usage: cinder --os-volume-api-version 2 upload-to-image [--force [<True|False>]]
|
|
[--container-format <container-format>]
|
|
[--disk-format <disk-format>]
|
|
<volume> <image-name>
|
|
|
|
Uploads volume to Image Service as an image.
|
|
|
|
Positional arguments
|
|
--------------------
|
|
|
|
``<volume>``
|
|
Name or ID of volume to snapshot.
|
|
|
|
``<image-name>``
|
|
The new image name.
|
|
|
|
Optional arguments
|
|
------------------
|
|
|
|
``--force [<True|False>]``
|
|
Enables or disables upload of a volume that is
|
|
attached to an instance. Default=False.
|
|
|
|
``--container-format <container-format>``
|
|
Container format type. Default is bare.
|
|
|
|
``--disk-format <disk-format>``
|
|
Disk format type. Default is raw.
|
|
|