对卷重命名

使用 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。