volume¶
块存储 v2, v3
volume create¶
创建新的卷
openstack volume create
[--size <size>]
[--type <volume-type>]
[--image <image> | --snapshot <snapshot> | --source <volume> | --backup <backup> | --remote-source <key=value>]
[--description <description>]
[--availability-zone <availability-zone>]
[--consistency-group consistency-group>]
[--property <key=value>]
[--hint <key=value>]
[--bootable | --non-bootable]
[--read-only | --read-write]
[--host <host>]
[--cluster <cluster>]
[<name>]
- --size <size>¶
卷大小，单位为 GB（除非指定 –snapshot 或 –source，否则必需）
- --type <volume-type>¶
设置卷的类型
- --image <image>¶
使用 <image> 作为卷的来源（名称或 ID）
- --snapshot <snapshot>¶
使用 <snapshot> 作为卷的来源（名称或 ID）
- --source <volume>¶
要克隆的卷（名称或 ID）
- --backup <backup>¶
将备份恢复到卷（名称或 ID）（受 –os-volume-api-version 3.47 或更高版本支持）
- --remote-source <key=value>¶
现有远程卷的属性（需要管理员权限）（重复选项以指定多个属性，例如：‘–remote-source source-name=test_name –remote-source source-id=test_id’）
- --description <description>¶
卷描述
- --availability-zone <availability-zone>¶
在 <availability-zone> 中创建卷
- --consistency-group consistency-group>¶
新卷所属的一致性组
- --property <key=value>¶
为该卷设置属性（重复选项以设置多个属性）
- --hint <key=value>¶
用于创建卷的任意调度器提示键值对。重复该选项以设置多个提示。‘same_host’ 和 ‘different_host’ 在重复时会附加值，其他所有键都采用最后给定的值
- --bootable¶
将卷标记为可启动
- --non-bootable¶
将卷标记为不可启动（默认）
- --read-only¶
将卷设置为只读访问模式
- --read-write¶
将卷设置为读写访问模式（默认）
- --host <host>¶
现有卷所在的 Cinder 主机；格式为：host@backend-name#pool。仅与 –remote-source 选项一起使用。
- --cluster <cluster>¶
现有卷所在的 Cinder 集群；格式为：cluster@backend-name#pool。仅与 –remote-source 选项一起使用。（受 –os-volume-api-version 3.16 或更高版本支持）
- name¶
卷名称
volume delete¶
删除卷
openstack volume delete
[--force | --purge]
[--remote]
<volume>
[<volume> ...]
- --force¶
尝试强制删除卷，无论其状态如何（默认为 False）
- --purge¶
连同卷一起删除任何快照（默认为 False）
- --remote¶
指定此参数以取消管理卷。
- volume¶
要删除的卷（名称或 ID）
volume list¶
列出卷
openstack volume list
[--sort-column SORT_COLUMN]
[--sort-ascending | --sort-descending]
[--project <project>]
[--project-domain <project-domain>]
[--user <user>]
[--user-domain <user-domain>]
[--name <name>]
[--status <status>]
[--property <key=value>]
[--all-projects]
[--long]
[--limit <limit>]
[--marker <marker>]
- --sort-column SORT_COLUMN¶
指定要对数据进行排序的列（首先指定的列具有优先级，不存在的列将被忽略），可以重复
- --sort-ascending¶
按升序对列进行排序
- --sort-descending¶
按降序对列进行排序
- --project <project>¶
按项目（名称或 ID）过滤结果（仅限管理员）
- --project-domain <project-domain>¶
项目所属的域（名称或 ID）。如果项目名称之间存在冲突，可以使用此选项。
- --user <user>¶
按用户（名称或 ID）过滤结果（仅限管理员）
- --user-domain <user-domain>¶
用户所属的域（名称或 ID）。当用户名称存在冲突时，可以使用此选项。
- --name <name>¶
按卷名称过滤结果
- --status <status>¶
按状态过滤结果
- --property <key=value>¶
按卷列表上的属性进行过滤（重复选项以按多个属性进行过滤）
- --all-projects¶
包含所有项目（仅限管理员）
- --long¶
在输出中列出附加字段
- --limit <limit>¶
返回的最大条目数。如果该值超过服务器定义的限制，则将使用最大值。
- --marker <marker>¶
从集合中返回结果的第一个位置。这应该是在先前请求中返回的值。
volume migrate¶
将卷迁移到新的主机
openstack volume migrate
--host <host>
[--force-host-copy]
[--lock-volume]
<volume>
- --host <host>¶
目标主机（格式为：host@backend-name#pool）
- --force-host-copy¶
启用基于主机的通用强制迁移，绕过驱动程序优化
- --lock-volume¶
如果指定，卷状态将被锁定，并且不允许通过其他操作（例如）中止迁移
- volume¶
要迁移的卷（名称或 ID）
volume set¶
设置卷属性
openstack volume set
[--name <name>]
[--size <size>]
[--description <description>]
[--no-property]
[--property <key=value>]
[--image-property <key=value>]
[--state <state>]
[--attached | --detached]
[--type <volume-type>]
[--migration-policy <migration-policy>]
[--bootable | --non-bootable]
[--read-only | --read-write]
<volume>
- --name <name>¶
新的卷名称
- --size <size>¶
以 GB 为单位扩展卷大小
- --description <description>¶
新的卷描述
- --no-property¶
删除 <volume> 上的所有属性（同时指定 –no-property 和 –property 以在设置新属性之前删除当前属性。）
- --property <key=value>¶
为该卷设置属性（重复选项以设置多个属性）
- --image-property <key=value>¶
为该卷设置镜像属性（重复选项以设置多个镜像属性）
- --state <state>¶
新的卷状态（“available”、“error”、“creating”、“deleting”、“in-use”、“attaching”、“detaching”、“error_deleting” 或 “maintenance”）（仅限管理员）（此选项只是更改数据库中卷的状态，不考虑实际状态，使用时请谨慎）
- --attached¶
将卷连接状态设置为“attached”（仅限管理员）（此选项只是更改数据库中卷的状态，不考虑实际状态，使用时请谨慎）
- --detached¶
将卷连接状态设置为“detached”（仅限管理员）（此选项只是更改数据库中卷的状态，不考虑实际状态，使用时请谨慎）
- --type <volume-type>¶
新的卷类型（名称或 ID）
- --migration-policy <migration-policy>¶
重新调整卷类型时的迁移策略（“never” 或 “on-demand”，默认值为 “never”）(仅当指定 –type 选项时可用)
- --bootable¶
将卷标记为可启动
- --non-bootable¶
将卷标记为不可启动
- --read-only¶
将卷设置为只读访问模式
- --read-write¶
将卷设置为读写访问模式
- volume¶
要修改的卷（名称或 ID）
volume show¶
显示卷的详细信息
openstack volume show <volume>
- volume¶
要显示的卷（名称或 ID）
volume unset¶
取消设置卷属性
openstack volume unset
[--property <key>]
[--image-property <key>]
<volume>
- --property <key>¶
从卷中移除一个属性（重复该选项以移除多个属性）
- --image-property <key>¶
从卷中移除一个镜像属性（重复该选项以移除多个镜像属性）
- volume¶
要修改的卷（名称或 ID）
Block Storage v3
volume summary¶
显示此部署中所有卷的摘要。
openstack volume summary [--all-projects]
- --all-projects¶
包含所有项目（仅限管理员）
volume revert¶
将卷恢复到快照。
openstack volume revert <snapshot>
- snapshot¶
要恢复的快照的名称或 ID。快照必须是 cinder 知道的最新快照。
