描述： Object Tagging管理命令允许用户对指定Object或指定Prefix的Objects执行设置、追加、获取和删除自定义标签的操作，方便用户在object级别对数据进行分类和管理，标签配置以 key=value 形式传递和保存。

命令格式：

1 bcecmd bos object-tagging <BOS_PATH> --method METHOD [--tagging TAGGING] [--keys KEYS] [--recursive]

说明：

• <BOS_PATH> 指定BOS路径，格式为：bos:/BUCKET_NAME/OBJECT_KEY。

• --method 指定标签操作的类型，包括以下4种：

  • put : 用 --tagging 指定的新标签完全覆盖已有的标签。
  • append : 追加--tagging指定的新标签，并保留已有的标签。
  • get : 获取指定object或前缀的所有标签配置，可以通过--keys指定标签key值获取相应的标签value。
  • delete : 删除指定object或前缀的所有标签配置，可以通过--keys删除指定的标签值。
• --recursive 使用该参数时，命令将为所有匹配<BOS_PATH>前缀的Object设置标签。否则只为指定Object设置标签。

设置Object Tagging

示例：

• 通过配置文件上传对象标签 操作示例：

  Plain Text 复制

  1$ bcecmd bos object-tagging bos:/bucket1/prefix1/object1 --method put --tagging file://tag-config.json

  返回示例：

  Plain Text 复制

  1success put object tagging: prefix1/object1.
  2[1] objects of put-tagging on remote.

  标签配置文件示例：

  Plain Text 复制

  1{
  2    "tagInfo": [
  3        { "key": "key001", "value": "value001"},
  4        { "key": "key002", "value": "value002"},
  5        { "key": "key003", "value": "value003"}
  6    ]
  7}

• 固定格式字符串上传对象标签

  操作示例：

  Plain Text 复制

  1$ bcecmd bos object-tagging bos:/bucket1/prefix1/object1 --method put --tagging 'key01=value01&key02=value02'

  返回示例：

  Plain Text 复制

  1success put object tagging: prefix1/object1.
  2[1] objects of put-tagging on remote.

• 批量上传对象标签

  操作示例：

  Plain Text 复制

  1$ bcecmd bos object-tagging bos:/bucket1/prefix1 --method put --tagging 'key01=value01&key02=value02' --recursive

  返回示例：

  Plain Text 复制

  1success put object tagging: prefix1/object1.
  2success put object tagging: prefix1/object2.
  3success put object tagging: prefix1/object3.
  4[3] objects of put-tagging on remote.

追加Object Tagging

示例：

• 通过配置文件追加对象标签 操作示例：

  Plain Text 复制

  1$ bcecmd bos object-tagging bos:/bucket1/prefix1/object1 --method append --tagging file://tag-config.json

  返回示例：

  Plain Text 复制

  1success append object tagging: prefix1/object1.
  2[1] objects of append-tagging on remote.

  标签配置文件示例：

  Plain Text 复制

  1{
  2    "tagInfo": [
  3        { "key": "key001", "value": "value001"},
  4        { "key": "key002", "value": "value002"},
  5        { "key": "key003", "value": "value003"}
  6    ]
  7}

• 固定格式字符串追加对象标签

  操作示例：

  Plain Text 复制

  1$ bcecmd bos object-tagging bos:/bucket1/prefix1/object1 --method append --tagging 'key01=value01&key02=value02'

  返回示例：

  Plain Text 复制

  1success append object tagging: prefix1/object1.
  2[1] objects of append-tagging on remote.

• 批量上传对象标签

  操作示例：

  Plain Text 复制

  1$ bcecmd bos object-tagging bos:/bucket1/prefix1 --method append --tagging 'key01=value01&key02=value02' --recursive

  返回示例：

  Plain Text 复制

  1success append object tagging: prefix1/object1.
  2success append object tagging: prefix1/object2.
  3success append object tagging: prefix1/object3.
  4[3] objects of append-tagging on remote.

获取Object Tagging

示例：

• 获取指定object的所有标签 操作示例：

  Plain Text 复制

  1$ bcecmd bos object-tagging bos:/bucket1/prefix1/object1 --method get

  返回示例：

  Plain Text 复制

  1prefix1/object1    map[key004:value004 key005:value005 key006:value006 key01:value01 key02:value02]
  2[1] objects of get-tagging on remote.

• 获取object的指定标签

  操作示例：

  Plain Text 复制

  1$ bcecmd bos object-tagging bos:/bucket1/prefix1/object1 --method get --keys 'key01&key02'

  返回示例：

  Plain Text 复制

  1prefix1/object1    map[key01:value01 key02:value02]
  2[1] objects of append-tagging on remote.

• 批量获取对象标签

  操作示例：

  Plain Text 复制

  1$ bcecmd bos object-tagging bos:/bucket1/prefix1 --method get --recursive

  返回示例：

  Plain Text 复制

  1prefix1/object1    map[key01:value01 key02:value02]
  2prefix1/object2    map[key01:value01 key02:value02]
  3prefix1/object3    map[key01:value01 key02:value02]
  4[3] objects of append-tagging on remote.

删除Object Tagging

示例：

• 删除指定object的所有标签 操作示例：

  Plain Text 复制

  1$ bcecmd bos object-tagging bos:/bucket1/prefix1/object1 --method delete

  返回示例：

  Plain Text 复制

  1success delete object tagging: prefix1/object1.
  2[1] objects of delete-tagging on remote.

• 获取object的指定标签

  操作示例：

  Plain Text 复制

  1$ bcecmd bos object-tagging bos:/bucket1/prefix1/object1 --method delete --keys 'key01&key02'

  返回示例：

  Plain Text 复制

  1success delete object tagging: prefix1/object1.
  2[1] objects of delete-tagging on remote.

• 批量获取对象标签

  操作示例：

  Plain Text 复制

  1$ bcecmd bos object-tagging bos:/bucket1/prefix1 --method delete --recursive

  返回示例：

  Plain Text 复制

  1success delete object tagging: prefix1/object1.
  2success delete object tagging: prefix1/object2.
  3success delete object tagging: prefix1/object3.
  4[3] objects of delete-tagging on remote.