全部产品
Search
文档中心

Object Storage Service:GetBucketTags

更新时间:Jul 02, 2025

Anda dapat memanggil operasi ini untuk menanyakan tag yang dikonfigurasi untuk sebuah bucket.

Sintaks permintaan

GET /? tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Catatan

Izin oss:GetBucketTagging diperlukan untuk mendapatkan informasi penandaan bucket dengan memanggil operasi GetBucketTags. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.

Elemen respons

Elemen

Tipe

Deskripsi

Tagging

Container

Kontainer yang menyimpan tag yang dikembalikan dari bucket.

Node induk: Tidak ada

Catatan

Jika tidak ada tag yang dikonfigurasi untuk bucket, pesan XML akan dikembalikan di mana elemen Tagging kosong.

TagSet

Container

Kontainer yang menyimpan tag yang dikembalikan dari bucket.

Node induk: Tidak ada

Tag

Container

Kontainer yang menyimpan tag yang dikembalikan dari bucket.

Node induk: TagSet

Key

String

Kunci untuk sebuah tag.

Node induk: Tag

Value

String

Nilai dari sebuah tag.

Node induk: Tag

Contoh

  • Permintaan Contoh

    GET /? tagging
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    Date: Tue, 20 Dec 2018 13:09:13 GMT
    Authorization: OSS qn6q**************:77Dv****************
  • Respons Contoh

    200 (OK)
    content-length: 237
    server: AliyunOSS
    x-oss-request-id: 5C1B2D24B90AD5490CFE368E
    date: Thu, 20 Dec 2018 13:12:21 GMT
    content-type: application/xml
    <? xml version="1.0" encoding="UTF-8"? >
    <Tagging>
      <TagSet>
        <Tag>
          <Key>testa</Key>
          <Value>value1-test</Value>
        </Tag>
        <Tag>
          <Key>testb</Key>
          <Value>value2-test</Value>
        </Tag>
      </TagSet>
    </Tagging>

OSS SDKs

Anda dapat menggunakan OSS SDK berikut untuk operasi GetBucketTags:

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi GetBucketTags, lihat get-bucket-tags.

Kode kesalahan

Kode kesalahan

Status HTTP

Deskripsi

NoSuchBucket

404

Pesan kesalahan yang dikembalikan karena bucket yang ditentukan tidak ada.

AccessDenied

403

Pesan kesalahan yang dikembalikan karena Anda tidak memiliki izin untuk menanyakan tag yang dikonfigurasi untuk bucket. Hanya pemilik bucket yang dapat menanyakan tag yang dikonfigurasi untuk sebuah bucket.