GetObjectTagging
調(diào)用GetObjectTagging接口獲取對象(Object)的標(biāo)簽(Tagging)信息。
版本控制
調(diào)用GetObjectTagging接口時,默認(rèn)只能獲取Object當(dāng)前版本的標(biāo)簽信息。您可以通過指定versionId參數(shù)來獲取指定Object版本的標(biāo)簽信息。如果Object的對應(yīng)版本為刪除標(biāo)記(Delete Marker),則OSS將返回404 Not Found。
請求語法
GET /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 Mar 2019 02:02:36 GMT
Authorization: SignatureValue
當(dāng)您在OSS ON云盒中調(diào)用該接口時,您需要將Host替換為云盒Endpoint。更多信息,請參見云盒Endpoint。
請求頭
此接口僅涉及公共請求頭。更多信息,請參見公共請求頭(Common Request Headers)。
響應(yīng)頭
此接口僅涉及公共響應(yīng)頭。更多信息,請參見公共響應(yīng)頭(Common Response Headers)。
響應(yīng)元素
名稱 | 類型 | 描述 |
Tagging | 容器 | 標(biāo)簽集合。 子節(jié)點(diǎn):TagSet |
TagSet | 容器 | 標(biāo)簽集合。 父節(jié)點(diǎn):Tagging 子節(jié)點(diǎn):Tag |
Tag | 容器 | 標(biāo)簽集合。 父節(jié)點(diǎn):TagSet 子節(jié)點(diǎn):Key、Value |
Key | 字符串 | 標(biāo)簽鍵。 父節(jié)點(diǎn):Tag 子節(jié)點(diǎn):無 |
Value | 字符串 | 標(biāo)簽值。 父節(jié)點(diǎn):Tag 子節(jié)點(diǎn):無 |
示例
未開啟版本控制
在未開啟版本控制的情況下,針對存儲空間bucketname中的對象objectname發(fā)起GET請求時,獲取到{a:1}和{b:2}的標(biāo)簽信息。標(biāo)簽獲取成功后返回200 (OK)。
請求示例
GET /objectname?tagging Host: BucketName.oss-cn-hangzhou.aliyuncs.com Date: Wed, 20 Mar 2019 02:02:36 GMT Authorization: OSS qn6q**************:77Dv****************
返回示例
200 (OK) content‐length: 209 server: AliyunOSS x‐oss‐request‐id: 5C919F38461FB4282600**** date: Wed, 20 Mar 2019 02:02:32 GMT content‐type: application/xml <?xml version="1.0" encoding="UTF‐8"?> <Tagging> <TagSet> <Tag> <Key>a</Key> <Value>1</Value> </Tag> <Tag> <Key>b</Key> <Value>2</Value> </Tag> </TagSet> </Tagging>
已啟用版本控制
在啟用版本控制的情況下,針對存儲空間bucketname中的對象objectname的指定版本(即請求示例中的versionId)發(fā)起GET請求時,獲取到{age:18}的標(biāo)簽信息。標(biāo)簽獲取成功后返回200 (OK)。
請求示例
GET /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0**** Host: BucketName.oss-cn-hangzhou.aliyuncs.com Date: Wed, 24 Jun 2020 08:50:28 GMT Authorization: OSS qn6q**************:77Dv****************
返回示例
200 (OK) content-length: 161 server: AliyunOSS x-oss-request-id: 5EF313D44506783438F3**** date: Wed, 24 Jun 2020 08:50:28 GMT content-type: application/xml x-oss-version-id: CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0**** <?xml version="1.0" encoding="UTF-8"?> <Tagging> <TagSet> <Tag> <Key>age</Key> <Value>18</Value> </Tag> </TagSet> </Tagging>
SDK
GetObjectTagging接口對應(yīng)的各語言SDK示例如下: