Object Storage Service:GetObjectTagging

バージョニング

デフォルトでは、GetObjectTagging を呼び出してオブジェクトのタグをクエリすると、オブジェクトの現在のバージョンのタグのみが返されます。 リクエストで versionId パラメーターを指定して、オブジェクトの指定されたバージョンのタグをクエリできます。 オブジェクトの現在のバージョンが削除マーカーの場合、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

リクエストヘッダー

GetObjectTagging リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通リクエストヘッダー」をご参照ください。

レスポンスヘッダー

GetObjectTagging リクエストへのレスポンスのすべてのヘッダーは、共通レスポンスヘッダーです。 詳細については、「共通レスポンスヘッダー」をご参照ください。

レスポンス要素

例

• バージョン管理されていないバケット内のオブジェクトのタグをクエリします。

  この例では、objectname という名前のオブジェクトが、bucketname という名前のバージョン管理されていないバケットに格納されています。 GetObjectTagging リクエストが送信され、objectname の {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>

• バージョン管理されたバケット内のオブジェクトのタグをクエリします。

  この例では、objectname という名前のオブジェクトが、bucketname という名前のバージョン管理されたバケットに格納されています。 GetObjectTagging リクエストが送信され、objectname の指定されたバージョンの {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>

OSS SDK

次のプログラミング言語の OSS SDK を使用して、GetObjectTagging 操作を呼び出すことができます。

• Java

• Python

• Go V2

• PHP

• C++

• .NET

• Node.js

• iOS

ossutil

GetObjectTagging 操作に対応する ossutil コマンドについては、「get-object-tagging」をご参照ください。

エラーコード