======================回忆上篇 Cinder CLI命令（1）========================
接下来就分别分析每一个CLI命令。
一. 卷相关
1. 创建卷
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>]
参数：
参数 |
含义 |
consisgroup-id |
一致性组ID |
snapshot-id |
快照ID |
source-volid |
源卷ID |
source-replica |
复制卷ID |
image-id |
镜像ID |
image |
镜像（ID或name） |
name |
卷名 |
description |
描述 |
volume-type |
卷类型 |
availability-zone |
可用的zone |
metadata |
元数据，key=value形式 |
hint |
调度器，key=value形式 |
allow-multiattach |
是否允许多挂载 |
size |
卷大小，单位GB |
2. 列出所有卷
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>]]
参数：
参数 |
含义 |
all-tenants |
是否显示所有租户卷的详情，1：是，0：不是。只能Admin使用 |
name |
通过名字筛选 |
status |
通过状态筛选 |
migration_status |
通过迁移状态筛选，只能Admin使用 |
metadata |
通过元数据筛选，key=value形式 |
marker |
返回除了指定ID外的卷 |
limit |
返回卷的最大数目 |
sort |
排序 |
tenant |
显示单个租户卷的信息，只能Admin使用 |
3. 删除卷
cinder delete<volume> [<volume> ...]
参数：
参数 |
含义 |
volume |
卷名或ID，删除一个或多个卷 |
4. 强制删除卷
cinderforce-delete <volume> [<volume> ...]
参数：
参数 |
含义 |
volume |
卷名或ID。不管什么状态，强制删除一个或多个卷 |
5. 重命名卷
cinder rename[--description <description>] <volume> [<name>]
参数：
参数 |
含义 |
description |
描述信息 |
volume |
卷名或ID |
name |
卷新的名字 |
6. 查看卷详情
cinder show<volume>
参数：
参数 |
含义 |
volume |
卷名或ID |
7. 重置卷状态
cinder reset-state[--state <state>]
[--attach-status <attach-status>]
[--reset-migration-status]
<volume> [<volume>...]
参数：
参数 |
含义 |
state |
不管卷当前实际状态，修改的只是数据库的信息。状态有available、error、creating、deleting、in-use、attaching、detaching、 error_deleting、maintenance |
attach-status |
修改数据库中卷挂载状态，有attached、detached |
reset-migration-status |
重置数据库中卷迁移状态 |
volume |
卷名或ID |
8. 查看元数据
cindermetadata-show <volume>
参数：
参数 |
含义 |
volume |
卷名或ID |
9. 设置/取消元数据
cinder metadata<volume> <action> <key=value> [<key=value> ...]
参数：
参数 |
含义 |
volume |
卷名或ID |
action |
set:设置 unset:取消 |
key=value |
key,value值，当action为unset时，只有key参数 |
10. 更新所有元数据
cindermetadata-update-all <volume> <key=value> [<key=value> ...]
参数：
参数 |
含义 |
volume |
卷名或ID |
key=value |
key,value值 |
11. 迁移卷到新主机
cinder migrate[--force-host-copy [<True|False>]]
[--lock-volume[<True|False>]]
<volume> <host>
参数：
参数 |
含义 |
force-host-copy |
启用或禁用绕过驱动优化的通用主机迁移，True:启用，False:禁用 |
lock-volume |
是否锁住卷，以防止迁移操作被其他命令所中断。设为True，卷锁住，不被中断，状态为maintenance(维修)；设为False，不锁住卷，允许迁移被中断。 |
volume |
卷名或ID |
host |
迁移目标主机 |
12. 扩展卷
cinder extend<volume> <new_size>
参数：
参数 |
含义 |
volume |
卷名或ID |
new_size |
卷新大小，单位GB |
13. 管理卷
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>
参数：
参数 |
含义 |
id-type |
提供的后端设备标识符的类型，通常是源名称或源ID |
name |
卷名 |
description |
描述信息 |
volume-type |
卷类型 |
availability-zone |
可用的zone |
metadata |
元数据，key-value形式 |
bootable |
设置新创建的卷都标识为bootable(可启动) |
host |
卷所在的主机 |
identifier |
卷名或其他标识 |
14. 停止管理卷
cinder unmanage<volume>
参数：
参数 |
含义 |
volume |
卷名或ID |
15. 设置卷启动状态
cinderset-bootable <volume> <True|true|False|false>
参数：
参数 |
含义 |
volume |
卷名或ID |
True|true|False|false |
True/true:可启动 False/false:不可启动 |
16. 上传卷到镜像服务
cinderupload-to-image [--force [<True|False>]]
[--container-format<container-format>]
[--disk-format<disk-format>]
<volume><image-name>
参数：
参数 |
含义 |
force |
是否允许上传一个已挂载到某实例的卷 |
container-format |
容器格式，默认是bare |
disk-format |
磁盘格式，默认是raw |
volume |
卷名或ID |
image-name |
新镜像名 |
17. 修改卷只读模式
cinderreadonly-mode-update <volume> <True|true|False|false>
参数：
参数 |
含义 |
volume |
卷ID |
True|true|False|false |
True/true:是 False/false:不是 |
二. 卷快照
1. 创建卷快照
cindersnapshot-create [--force [<True|False>]] [--name <name>]
[--description<description>]
[--metadata[<key=value> [<key=value> ...]]]
<volume>
参数：
参数 |
含义 |
force |
是否允许对已挂载到某实例的卷进行快照。设置为True，直接进行快照。 |
name |
快照名 |
description |
快照描述信息 |
metadata |
快照元数据，key-value形式 |
volume |
卷名或ID |
2. 删除卷快照
cindersnapshot-delete <snapshot> [<snapshot> ...]
参数：
参数 |
含义 |
snapshot |
快照名或ID，删除一个或多个快照 |
3. 列出所有卷快照
cindersnapshot-list [--all-tenants [<0|1>]] [--name <name>]
[--status <status>]
[--volume-id <volume-id>]
参数：
参数 |
含义 |
all-tenants |
是否列出所有租户的卷快照，0:不是，1:是。只能Admin使用 |
name |
根据卷快照名来筛选 |
status |
根据卷快照状态来筛选 |
volume-id |
根据卷ID来筛选 |
4. 查看卷快照
cindersnapshot-show <snapshot>
参数：
参数 |
含义 |
snapshot |
快照名或ID |
5. 重命名卷快照
cindersnapshot-rename [--description <description>]
<snapshot> [<name>]
参数：
参数 |
含义 |
description |
快照描述信息 |
snapshot |
快照名或ID |
name |
快照新名 |
6. 重置卷快照状态
cindersnapshot-reset-state [--state <state>]
<snapshot>[<snapshot> ...]
参数：
参数 |
含义 |
state |
不管卷快照当前状态，只是修改数据库的信息。状态有available、error、creating、deleting、error_deleting |
snapshot |
快照名或ID |
7. 设置/取消卷快照元数据
cindersnapshot-metadata <snapshot> <action>
<key=value>[<key=value> ...]
参数：
参数 |
含义 |
snapshot |
快照名或ID |
action |
set:设置 unset:取消 |
key=value |
key,value值，当action为unset时，只有key参数 |
8. 查看卷快照元数据
cinder snapshot-metadata-show<snapshot>
参数：
参数 |
含义 |
snapshot |
快照名或ID |
9. 修改所有卷快照的元数据
cindersnapshot-metadata-update-all <snapshot>
<key=value>[<key=value> ...]
参数：
参数 |
含义 |
snapshot |
快照名或ID |
key=value |
key,value值 |
三. 卷备份
1. 创建卷备份
cinderbackup-create [--container <container>] [--name <name>]
[--description<description>] [--incremental]
[--force]
<volume>
参数：
参数 |
含义 |
container |
备份容器名 |
name |
备份名 |
description |
备份描述 |
incremental |
是否是增量备份 |
force |
是否允许对已挂载到某实例的卷进行备份。若设置为True，备份的卷的状态应是available或in-use。当备份状态为in-use的卷时，意味着卷数据处于崩溃一致。 |
volume |
卷名或ID |
2. 查看卷备份详情
cinder backup-show<backup>
参数：
参数 |
含义 |
backup |
备份名或ID |
3. 删除卷备份
cinderbackup-delete <backup>
参数：
参数 |
含义 |
backup |
备份名或ID |
4. 列出所有卷备份
cinder backup-list[--all-tenants [<all_tenants>]] [--name <name>]
[--status <status>] [--volume-id<volume-id>]
参数：
参数 |
含义 |
all-tenants |
是否列出所有租户的卷备份，只能Admin使用 |
name |
根据卷备份名来筛选 |
status |
根据卷备份状态来筛选 |
volume-id |
根据卷ID来筛选 |
5. 备份恢复
cinderbackup-restore [--volume <volume>] <backup>
参数：
参数 |
含义 |
volume |
恢复的卷名或ID |
backup |
备份ID |
6. 导入备份
cinderbackup-import <backup_service> <backup_url>
参数：
参数 |
含义 |
backup_service |
导入备份的服务名 |
backup_url |
导入备份的路径 |
7. 导出备份
cinderbackup-export <backup>
参数：
参数 |
含义 |
backup |
备份名或ID |
====================还想继续 Cinder CLI命令（3）====================