すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:GetObjectTagging

最終更新日:Feb 23, 2024

この操作を呼び出して、オブジェクトのタグを照会できます。

バージョン管理

既定では、GetObjectTaggingを呼び出してオブジェクトのタグを照会すると、オブジェクトの現在のバージョンのタグのみが返されます。 リクエストでversionIdパラメーターを指定して、指定したバージョンのオブジェクトのタグを照会できます。 オブジェクトの現在のバージョンが削除マーカーである場合、OSSは404 Not Foundを返します。

リクエストの構造

GET /objectname? タグ付け
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: 3月20日水2019 02:02:36GMT
権限付与: SignatureValue 

リクエストヘッダー

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

レスポンスヘッダー

GetObjectTagging要求に対する応答には、共通の応答ヘッダーのみが含まれます。 詳細については、「共通レスポンスヘッダー」をご参照ください。

レスポンス要素

要素データ型説明
タギングContainerタグのコレクションを格納するために使用されるコンテナー。

子ノード: TagSet

タグセットContainerタグのコレクション。

親ノード: タグ付け

子ノード: タグ

タグContainerタグのコレクション。

親ノード: TagSet

子ノード: キーと値

KeyStringオブジェクトタグのキー。

親ノード: タグ

子ノード: なし

Stringオブジェクトタグの値。

親ノード: タグ

子ノード: なし

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

    この例では、objectnameという名前のオブジェクトは、bucketnameという名前の未バージョンのバケットに格納されます。 GetObjectTagging要求は、objectnameの {A: 1} および {b:2} タグを照会するために送信される。 オブジェクトのタグが取得された後、200 OKが返されます。

    GET /objectname? タグ付けのサンプルリクエスト
    
    ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
    日付: 3月20日水2019 02:02:36GMT
    承認: OSS qn6qrrqxo2oawuk53otf ****:kZoYNv66bsmc10 + dcGKw5x2P **** 
    200のサンプル応答
    (OK)
    content-length: 209
    server: AliyunOSS
    x-oss-request-id: 5C919F38461FB4282600 ****
    日付: 3月20日水2019 02:02:32GMT
    content-type: application/xml
    <?xml version="1.0" encoding="UTF-8"?>
    <タグ付け>
      <TagSet>
        <タグ>
          <キー> a</キー>
          <値> 1</値>
        </Tag>
        <タグ>
          <キー> b</キー>
          <値> 2</値>
        </タグ>
      </タグセット>
    </タグ付け> 
  • バージョン管理されたバケット内のオブジェクトのタグを照会します。

    この例では、objectnameという名前のオブジェクトがbucketnameという名前のバージョン付きバケットに格納されます。 GetObjectTaggingリクエストは、objectnameの指定されたバージョンの {age:18} タグを照会するために送信されます。 オブジェクトの指定されたバージョンのタグが取得されると、200 OKが返されます。

    サンプルリクエスト
    のGET /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0 ****
    ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
    日付: 6月24日水2020 08:50:28 GMT
    権限付与: OSS ************:******************** 
    200のサンプル応答
    (OK)
    content-length: 161
    server: AliyunOSS
    x-oss-request-id: 5EF313D44506783438F3 ****
    日付: 6月24日水2020 08:50:28 GMT
    content-type: application/xml
    x-oss-version-id: CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0 ****
    <?xml version="1.0" encoding="UTF-8"?>
    <タグ付け>
      <TagSet>
        <タグ>
          <キー> 年齢 </キー>
          <値> 18</値>
        </タグ>
      </タグセット>
    </タグ付け> 

SDK

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

エラーコード

エラーコードHTTPステータスコード説明
FileAlreadyExists409タグ設定を照会するオブジェクトが、階層名前空間機能が有効になっているバケット内のディレクトリである場合に返されるエラーメッセージ。