put-object-tagging

注意事项

• 阿里云账号默认拥有设置或更新对象的标签的权限。如果您需要通过RAM用户或者STS的方式进行设置或更新，您必须拥有oss:PutObjectTagging权限。具体操作，请参见为RAM用户授权自定义的权限策略。

• 对象标签使用一组键值对（Key-Value）标记对象。单个Object最多能设置10个标签，Key不能重复。每个Key长度不能超过128字符，每个Value长度不能超过256字符。Key和Value区分大小写。标签的合法字符集包括大小写字母、数字、空格和以下符号：+‑=._:/。

• 更改标签信息不会更新Object的Last-Modified时间。

命令格式

ossutil api put-object-tagging --bucket value --key value --tagging value [flags]

--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"
        },
        ...
      ]
    }
  }

使用示例

为对象exampleobject添加或修改标签。

• 使用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-object-tagging --bucket examplebucket --key exampleobject --tagging file://tagging.xml

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

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

  命令示例如下：

  ossutil api put-object-tagging --bucket examplebucket --key exampleobject --tagging file://tagging.json

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

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