您可以通過PutObjectTagging介面設定或更新對象的標籤（Object Tagging）。

請求文法

PUT /objectname?tagging
Content‐Length: 114
Host: bucketname.oss‐cn‐hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
<Tagging>
  <TagSet>
    <Tag>
      <Key>Key</Key>
      <Value>Value</Value>
    </Tag>
  </TagSet>
</Tagging>

請求元素

名稱 類型 是否必需 描述
Tagging 容器 是 子節點：TagSet
TagSet 容器 是

父節點：Tagging

子節點：Tag
Tag 容器 否

父節點：TagSet

子節點：Key，Value
Key 字串 否

父節點：Tag

子節點：無
Value 字串 否

父節點：Tag

子節點：無

細節分析

  • 要求者需要有PutObjectTagging許可權。
  • 更改Tagging不會更新Object Last‑Modified時間。
  • 標籤合法字元集包括大小寫字母、數字、空格和以下符號：

    +‑=._:/

示例

  • 請求樣本 
    PUT /objectname?tagging
Content‐Length: 114
Host: bucketname.oss‐cn‐hangzhou.aliyuncs.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: OSS ***********:*********************
<Tagging>
  <TagSet>
    <Tag>
      <Key>a</Key>
      <Value>1</Value>
    </Tag>
    <Tag>
      <Key>b</Key>
      <Value>2</Value>
    </Tag>
  </TagSet>
</Tagging>
  • 返回樣本 
    200 (OK)
content‐length: 0
server: AliyunOSS
x‐oss‐request‐id: 5C8F55ED461FB4A64C000004
date: Mon, 18 Mar 2019 08:25:17 GMT