全部產品
Search
文件中心

Object Storage Service:GetObjectTagging

更新時間:Jun 19, 2024

調用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為目錄,則返回該錯誤。