全部产品
Search
文档中心

Object Storage Service:GetObjectTagging

更新时间:Jul 02, 2025

Operasi ini digunakan untuk menanyakan tag dari sebuah objek.

Versioning

Secara default, ketika Anda memanggil GetObjectTagging, hanya tag dari versi saat ini dari objek yang dikembalikan. Untuk menanyakan tag dari versi tertentu, Anda dapat menentukan parameter versionId dalam permintaan. Jika versi saat ini adalah penanda hapus, OSS akan mengembalikan respons 404 Not Found.

Syntax

GET /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 Mar 2019 02:02:36 GMT
Authorization: SignatureValue

Header Permintaan

Semua header dalam permintaan GetObjectTagging merupakan header umum. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Header respons

Semua header dalam respons terhadap permintaan GetObjectTagging merupakan header umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

Elemen respons

Elemen

Tipe

Deskripsi

Tagging

Container

Wadah yang digunakan untuk menyimpan kumpulan tag.

Node anak: TagSet

TagSet

Container

Kumpulan tag.

Node induk: Tagging

Node anak: Tag

Tag

Container

Kumpulan tag.

Node induk: TagSet

Node anak: Key dan Value

Key

String

Kunci dari tag objek.

Node induk: Tag

Node anak: tidak ada

Value

String

Nilai dari tag objek.

Node induk: Tag

Node anak: tidak ada

Contoh

  • Menanyakan tag dari sebuah objek dalam bucket tanpa versi.

    Dalam contoh ini, objek bernama objectname disimpan dalam bucket tanpa versi bernama bucketname. Permintaan GetObjectTagging dikirim untuk menanyakan tag {a:1} dan {b:2} dari objectname. Setelah tag diperoleh, respons 200 OK dikembalikan.

    Contoh Permintaan

    GET /objectname?tagging
    Host: BucketName.oss-cn-hangzhou.aliyuncs.com
    Date: Wed, 20 Mar 2019 02:02:36 GMT
    Authorization: OSS qn6q**************:77Dv****************

    Contoh Respons

    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>
  • Menanyakan tag dari sebuah objek dalam bucket berbasis versi.

    Dalam contoh ini, objek bernama objectname disimpan dalam bucket berbasis versi bernama bucketname. Permintaan GetObjectTagging dikirim untuk menanyakan tag {age:18} dari versi tertentu dari objectname. Setelah tag dari versi tersebut diperoleh, respons 200 OK dikembalikan.

    Contoh Permintaan

    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****************

    Contoh Respons

    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 SDKs

Anda dapat menggunakan OSS SDK untuk bahasa pemrograman berikut guna memanggil operasi GetObjectTagging:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi GetObjectTagging, lihat get-object-tagging.

Kode kesalahan

Kode kesalahan

Kode status HTTP

Deskripsi

FileAlreadyExists

409

Pesan kesalahan dikembalikan karena objek yang konfigurasi tagging-nya ingin Anda tanyakan adalah direktori dalam bucket dengan fitur namespace hierarkis diaktifkan.