设置元数据

使用 metadata_set 命令可设置对象的元数据。

metadata_set object_type=Object name=Name key=Key value=Value

参数

名称 类型 描述 必需
object_type 枚举 对象类型。 可用值:cg, cluster, dest, destgroup, host, performanceclass, pool, rule, schedule, smsgw, smtpgw, target, user, user_group, vol。 Y
name 对象名 对象名称。 Y
key 字符串 元数据键。 Y
value 字符串 元数据值。 Y

该命令将为指定的对象设置新的元数据键值。 新值将覆盖先前的值(如果存在)。

该值可以是空字符串。 最多允许 16 个值,每个值限制为 128 个字节。

示例:

metadata_set object_type=host name=Host1 key=01 value=Host

输出:

Command completed successfully.

访问控制

用户类别 许可权 条件
存储管理员 允许 不适用
存储集成管理员 允许 不适用
应用程序管理员 特定条件下才能获得允许 可以仅为卷、快照、快照组、集群或主机设置元数据,也可以仅为与执行该命令的应用程序管理员关联的对象设置元数据。 主机或集群应该与用户关联。 应该将卷映射到与用户关联的主机或集群。 快照或快照组应该是应用程序管理员创建的快照或快照组。
安全性管理员 不允许 不适用
只读用户 不允许 不适用
技术人员 不允许 不适用

返回码

  • OBJECT_BAD_NAME

    引用的对象不存在。

  • MAX_METADATA_OBJECTS_REACHED

    已达到最大元数据对象数。

  • REMOTE_MAX_METADATA_OBJECTS_REACHED

    远程系统上已达到最大元数据对象数。

  • LOCAL_PEER_IS_NOT_MASTER

    本地同级不是主同级。

  • TARGET_NOT_CONNECTED

    当前没有与目标系统的连接。

  • REMOTE_TARGET_NOT_CONNECTED

    当前没有来自目标系统的连接。

  • HA_IS_NOT_OPERATIONAL

    此 HyperSwap 关系不可操作。无法对非操作 HyperSwap 关系执行此操作。