All Products
Search

This Product

    Object Storage Service:GetBucketTags

    Document Center

    Object Storage Service:GetBucketTags

    Last Updated:Sep 09, 2026

    Anda dapat memanggil operasi ini untuk mengkueri tag yang dikonfigurasi pada suatu 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 tagging bucket melalui operasi GetBucketTags. Untuk informasi selengkapnya, lihat Grant a custom policy.

    Elemen respons

    Element

    Type

    Description

    Tagging

    Container

    Container yang menyimpan tag bucket yang dikembalikan.

    Parent node: None

    Catatan

    Jika tidak ada tag yang dikonfigurasi untuk bucket, badan pesan XML dikembalikan dengan elemen Tagging kosong.

    TagSet

    Container

    Container yang menyimpan tag bucket yang dikembalikan.

    Parent node: None

    Tag

    Container

    Container yang menyimpan satu tag bucket yang dikembalikan.

    Parent node: TagSet

    Key

    String

    Kunci dari sebuah tag.

    Parent node: Tag

    Value

    String

    Nilai dari sebuah tag.

    Parent node: Tag

    Contoh

    • Permintaan Contoh

      GET /? tagging
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 13:09:13 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    • 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 menjalankan operasi GetBucketTags:

    ossutil

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

    Kode error

    Error code

    HTTP status code

    Description

    NoSuchBucket

    404

    Pesan error yang dikembalikan karena bucket yang ditentukan tidak ada.

    AccessDenied

    403

    Pesan error yang dikembalikan karena Anda tidak memiliki izin untuk mengkueri tag yang dikonfigurasi untuk bucket tersebut. Hanya Pemilik bucket yang dapat mengkueri tag yang dikonfigurasi untuk suatu bucket.