Object Storage Service:GetObjectTagging

バージョニングについて

デフォルトでは、GetObjectTagging API を呼び出すと、オブジェクトの最新バージョンのタグのみが返されます。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 リクエストのレスポンスには、共通レスポンスヘッダーが含まれます。詳細については、「共通レスポンスヘッダー」をご参照ください。

特定のオブジェクトバージョンのタグを照会すると、レスポンスには x-oss-version-id ヘッダーも含まれます。

レスポンス要素

例

• バージョニングが有効になっていない場合

  この例では、GET リクエストを送信して、バケット bucketname のオブジェクト 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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

レスポンス例

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>

• バージョニングが有効になっている場合

  この例では、GET リクエストを送信して、バケット bucketname のオブジェクト objectname の特定バージョンのタグを照会します。versionId がリクエスト例で指定されています。タグ {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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

レスポンス例

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

GetObjectTagging API の SDK サンプルは、次のプログラミング言語で利用できます。

• Java

• Python V2

• Go V2

• PHP V2

• C++

• .NET

• Node.js

• iOS

• Android

ossutil コマンドラインツール

GetObjectTagging API に対応する ossutil コマンドの詳細については、「GetObjectTagging」をご参照ください。

エラーコード