给某个存储空间添加或修改标签。_对象存储(OSS)-阿里云帮助中心

put-bucket-tags用于给某个存储空间（Bucket）添加或修改标签。

注意事项

阿里云账号默认拥有为Bucket添加或修改标签的权限。如果您需要通过RAM用户或者STS的方式进行添加修改，您必须拥有oss:PutBucketTags权限。具体操作，请参见为RAM用户授权自定义的权限策略。
put-bucket-tags是覆盖语义，即新添加的标签会完全覆盖已有的标签。
最多可设置20对Bucket用户标签。

命令格式

ossutil api put-bucket-tags --bucket value --tagging value [flags]

参数	类型	说明
--bucket	string	Bucket的名称。
--tagging	string	设置Bucket TagSet的容器。

说明

put-bucket-tags命令对应API接口PutBucketTags。关于API中的具体参数含义，请参见PutBucketTags。

--tagging

--tagging配置选项既支持XML语法也支持JSON语法，当选项值包含file://前缀时，表示从文件中读取配置。

XML语法：

<Tagging>
  <TagSet>
    <Tag>
      <Key>string</Key>
      <Value>string</Value>
    </Tag>
    ...
  </TagSet>
</Tagging>

JSON语法：

{
  "TagSet": {
    "Tag": [
      {
        "Key": "string",
        "Value": "string"
      },
      ...
    ]
  }
}

说明

关于支持的全局命令行选项，请参见支持的全局命令行选项。

使用示例

以下示例展示了如何为存储空间examplebucket添加或修改标签。

使用XML配置文件，tagging.xml内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>key1</Key>
      <Value>value1</Value>
    </Tag>
    <Tag>
      <Key>key2</Key>
      <Value>value2</Value>
    </Tag>
  </TagSet>
</Tagging>

命令示例如下：

ossutil api put-bucket-tags --bucket examplebucket --tagging file://tagging.xml

使用JSON配置文件，tagging.json内容如下：

{
    "TagSet": {
        "Tag": [
            {
                "Key": "key1",
                "Value": "value1"
            },
            {
                "Key": "key2",
                "Value": "value2"
            }
        ]
    }
}

命令示例如下：

ossutil api put-bucket-tags --bucket examplebucket --tagging file://tagging.json

使用JSON配置参数，命令示例如下：

ossutil api put-bucket-tags --bucket examplebucket --tagging "{\"TagSet\":{\"Tag\":[{\"Key\":\"key1\",\"Value\":\"value1\"},{\"Key\":\"key2\",\"Value\":\"value2\"}]}}"