对卷重命名
使用 vol_rename 命令对卷进行重命名。
vol_rename vol=VolName new_name=Name
参数
| 名称 | 类型 | 描述 | 必需 |
|---|---|---|---|
| vol | 对象名 | 要重命名的卷名。 | Y |
| new_name | 对象名 | 新的卷名。 | Y |
卷的新名称在系统中必须是唯一的。
即使新名称与当前名称相同,此命令也会成功。 无论卷的锁定状态如何,此命令都会成功。
对快照重命名不会更改其主卷的名称。 对主卷重命名不会更改其关联快照的名称。
示例:
vol_rename vol=DBVolume new_name=DBVolume1
输出:
Command completed successfully.
访问控制
| 用户类别 | 许可权 | 条件 |
|---|---|---|
| 存储管理员 | 已允许 | 不适用 |
| 存储集成管理员 | 已允许 | 不适用 |
| 应用程序管理员 | 特定条件下才能获得允许 | 该卷是一种快照,其主卷映射到与用户相关的主机或集群,并且快照是由应用程序管理员创建。 |
| 安全性管理员 | 已禁止 | 不适用 |
| 只读用户 | 已禁止 | 不适用 |
| 技术人员 | 已禁止 | 不适用 |
返回码
- VOLUME_BAD_NAME
卷名称不存在。
- VOLUME_EXISTS
卷名称已存在。
- SNAPSHOT_IS_INTERNAL
无法映射、修改或删除内部快照。
- SNAPSHOT_IS_PART_OF_SNAPSHOT_GROUP
快照是快照组的一部分。
- VOLUME_BAD_PREFIX
卷名称具有保留的前缀。
- SNAPSHOT_IS_CONSISTENT_ELCS
如果已镜像的卷不一致,那么其 ELCS 将受保护且无法删除。
- OLVM_ERROR
IBM Hyper-Scale Mobility 错误。
- COMMAND_NOT_SUPPORTED_FOR_OLVM_VOLUMES
IBM Hyper-Scale Mobility 卷不支持此命令。
- OPERATION_DENIED_OBJECT_MANAGED
这是一个受管对象。 只有管理软件和 xiv_maintenance/xiv_development 才可以对此对象执行此操作。
- DATA_REDUCTION_TIER_IS_OFFLINE
数据降维层处于脱机状态,不允许执行此操作。
故障诊断:请联系 IBM 支持人员
- LOCAL_PEER_IS_NOT_MASTER
本地同级不是主同级。
- TARGET_NOT_CONNECTED
当前没有到目标系统的连接。
- REMOTE_TARGET_NOT_CONNECTED
当前没有来自目标系统的连接。
- HA_IS_NOT_OPERATIONAL
此 HyperSwap 关系不可运行。无法对不可运行的 HyperSwap 关系执行操作。
- REMOTE_VOLUME_EXISTS
具有指定名称的辅助卷已存在。该名称不能复用。
- REMOTE_ALU_EXISTS
远程机器上已存在具有指定的辅助卷名的 ALU。