GetObjectTagging - Object Storage Service

調用GetObjectTagging介面擷取對象（Object）的標籤（Tagging）資訊。

版本控制

調用GetObjectTagging介面時，預設只能擷取Object目前的版本的標籤資訊。您可以通過指定versionId參數來擷取指定Object版本的標籤資訊。如果Object的對應版本為刪除標記（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

要求標頭

此介面僅涉及公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。

回應標頭

此介面僅涉及公用回應標頭。更多資訊，請參見公用回應標頭（Common Response Headers）。

響應元素

名稱	類型	描述
Tagging	容器	標籤集合。子節點：TagSet
TagSet	容器	標籤集合。父節點：Tagging 子節點：Tag
Tag	容器	標籤集合。父節點：TagSet 子節點：Key、Value
Key	字串	標籤鍵。父節點：Tag 子節點：無
Value	字串	標籤值。父節點：Tag 子節點：無

樣本

未開啟版本控制

在未開啟版本控制的情況下，針對儲存空間bucketname中的對象objectname發起GET請求時，擷取到{a:1}和{b:2}的標籤資訊。標籤擷取成功後返回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）發起GET請求時，擷取到{age:18}的標籤資訊。標籤擷取成功後返回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介面對應的各語言SDK樣本如下：

錯誤碼

錯誤碼	HTTP狀態代碼	描述
FileAlreadyExists	409	Bucket開啟階層命名空間後，當您要在該Bucket中擷取某個Object的標籤資訊時，如果設定的Object為目錄，則返回該錯誤。