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

命令格式：

1bcecmd bosapi bucket-tagging --bucket-name BUCKET-NAME --method METHOD [--tagging TAGGING] [--keys KEYS]

说明：

• --bucket-name 指定需要进行标签操作的bucket名称

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

  • put : 用 --tagging 指定的新标签完全覆盖已有的标签。
  • append : 追加--tagging指定的新标签，并保留已有的标签。
  • get : 获取指定bucket的所有标签配置，可以通过--keys指定标签key值获取相应的标签value。
  • delete : 删除指定bucket的所有标签配置，可以通过--keys删除指定的标签值。

• 使用--tagging 指定bucket标签配置，用于put和append两种method，支持两种传参方式：

  • 参数值前缀为 file:// 时，表示从文件中读取配置，配置文件必须为json格式。
  • 固定格式字符串指定标签配置，如：'key001=value001&key002=value002'。
• --keys指定想要获取或删除的标签key值，用于get和delete两种method，如果不使用该flag，获取或删除对象将是指定bucket的全部标签。传参格式：'key001&key002&key003'。

设置 Bucket Tagging

示例：

• 使用配置文件上传bucket标签配置

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-tagging --bucket-name bucket1 --method put --tagging file://tag-config.json

  返回示例： 无

  标签配置文件示例：

  Plain Text 复制

  1{
  2    "tags":[
  3        {
  4            "tagKey":"key-222",
  5            "tagValue":"value-xxxx"
  6        },
  7        {
  8             "tagKey":"key-333",
  9            "tagValue":"value-333"
  10        }
  11    ]
  12}

• 通过固定格式字符串指定bucket标签配置

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-tagging --bucket-name bucket1 --method put --tagging 'key001=value001&key3=value3'

  返回示例： 无

追加 Bucket Tagging

示例：

• 使用配置文件上传bucket标签配置

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-tagging --bucket-name bucket1 --method append --tagging file://tag-config.json

  返回示例： 无

  标签配置文件示例：

  Plain Text 复制

  1{
  2    "tags":[
  3        {
  4            "tagKey":"key-222",
  5            "tagValue":"value-xxxx"
  6        },
  7        {
  8             "tagKey":"key-333",
  9            "tagValue":"value-333"
  10        }
  11    ]
  12}

• 通过固定格式字符串指定bucket标签配置

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-tagging --bucket-name bucket1 --method append --tagging 'key001=value001&key3=value3'

  返回示例： 无

获取Bucket Tagging

示例：

• 获取指定bucket的全部标签

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-tagging --bucket-name bucket1 --method get

  返回示例：

  Plain Text 复制

  1{
  2    "tag": [
  3        {
  4            "tag_key": "ttt-222",
  5            "tag_value": "0898dsfijidf"
  6        },
  7        {
  8            "tag_key": "key-333",
  9            "tag_value": "value-333"
  10        },
  11        {
  12            "tag_key": "key-222",
  13            "tag_value": "value-xxxx"
  14        }
  15    ]
  16}

• 获取指定标签key的值

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-tagging --bucket-name bucket1 --method get --keys 'ttt-222&key-333'

  返回示例：

  Plain Text 复制

  1{
  2    "tag": [
  3        {
  4            "tag_key": "ttt-222",
  5            "tag_value": "0898dsfijidf"
  6        },
  7        {
  8            "tag_key": "key-333",
  9            "tag_value": "value-333"
  10        }
  11    ]
  12}

删除Bucket Tagging

示例：

• 删除指定bucket的全部标签

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-tagging --bucket-name bucket1 --method delete

  返回示例： 无

• 删除指定标签key的值

  操作示例：

  Plain Text 复制

  1$ bcecmd bosapi bucket-tagging --bucket-name bucket1 --method get --keys 'ttt-222&key-333'

  返回示例： 无