調用PutObjectTagging接口設置或更新對象(Object)的標簽(Tagging)信息。對象標簽使用一組鍵值對(Key-Value)標記對象。
注意事項
單個Object最多能設置10個標簽,Key不能重復。
每個Key長度不能超過128字符,每個Value長度不能超過256字符。
Key和Value區分大小寫。
標簽的合法字符集包括大小寫字母、數字、空格和以下符號:
+?=._:/
通過HTTP Header的方式設置標簽且標簽中包含任意字符時,您需要對標簽的Key和Value進行URL編碼。
更改標簽信息不會更新Object的Last?Modified時間。
關于對象標簽的更多信息,請參見對象標簽。
版本控制
調用PutObjectTagging接口時,默認設置Object當前版本的標簽信息。您可以通過指定versionId參數來設置指定Object版本的標簽信息。如果Object的對應版本為刪除標記(Delete Marker),則OSS將返回404 Not Found。
請求語法
PUT /objectname?tagging
Content‐Length: 114
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue
<Tagging>
<TagSet>
<Tag>
<Key>Key</Key>
<Value>Value</Value>
</Tag>
</TagSet>
</Tagging>
當您在OSS ON云盒中調用該接口時,您需要將Host替換為云盒Endpoint。更多信息,請參見云盒Endpoint。
請求元素
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
Tagging | 容器 | 是 | 不涉及 | 標簽集合。 子節點:TagSet |
TagSet | 容器 | 是 | 不涉及 | 標簽集合。 父節點:Tagging 子節點:Tag |
Tag | 容器 | 否 | 不涉及 | 標簽集合。 父節點:TagSet 子節點:Key、Value |
Key | 字符串 | 否 | a | 標簽鍵。 父節點:Tag 子節點:無 |
Value | 字符串 | 否 | 1 | 標簽值。 父節點:Tag 子節點:無 |
此接口還涉及其他公共請求頭。更多信息,請參見公共請求頭(Common Request Headers)。
示例
未開啟版本控制
在未開啟版本控制情況下,針對存儲空間bucketname中的對象objectname,通過PUT請求設置{a:1}和{b:2}兩個標簽。標簽設置成功后返回200 (OK)。
請求示例
PUT /objectname?tagging Content‐Length: 114 Host: BucketName.oss-cn-hangzhou.aliyuncs.com Date: Mon, 18 Mar 2019 08:25:17 GMT Authorization: OSS qn6q**************:77Dv**************** <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 connection: keep-alive x‐oss‐request‐id: 5C8F55ED461FB4A64C00**** date: Mon, 18 Mar 2019 08:25:17 GMT
已啟用版本控制
在啟用了版本控制的情況下,針對存儲空間bucketname中的對象objectname的指定版本(即請求示例中的versionId),通過PUT請求設置{age:18}標簽。標簽設置成功后返回200 (OK)。
請求示例
PUT /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0**** Content-Length: 90 Host: BucketName.oss-cn-hangzhou.aliyuncs.com Date: Wed, 24 Jun 2020 08:58:15 GMT Authorization: OSS qn6q**************:77Dv**************** <Tagging> <TagSet> <Tag> <Key>age</Key> <Value>18</Value> </Tag> </TagSet> </Tagging>
返回示例
200 (OK) content-length: 0 server: AliyunOSS connection: keep-alive x-oss-request-id: 5EF315A7FBD3EC3232B4**** date: Wed, 24 Jun 2020 08:58:15 GMT x-oss-version-id: CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****
SDK
PutObjectTagging接口對應的各語言SDK示例如下: