Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:GetBucketTags

Son Güncelleme:Oct 01, 2026

Bir paket için yapılandırılan etiketleri sorgulamak üzere bu işlemi çağırabilirsiniz.

İstek sözdizimi

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

Notlar

GetBucketTags işlemini çağırarak paketin etiketleme bilgilerini almak için oss:GetBucketTagging iznine sahip olmanız gerekir. Daha fazla bilgi için bkz. Özel bir ilke atayın.

Yanıt öğeleri

Öğe

Tür

Açıklama

Tagging

Konteyner

Paketin döndürülen etiketlerini depolayan konteyner.

Üst düğüm: Yok

Not

Paket için hiçbir etiket yapılandırılmamışsa, Tagging öğesinin boş olduğu bir XML mesaj gövdesi döndürülür.

TagSet

Konteyner

Paketin döndürülen etiketlerini depolayan konteyner.

Üst düğüm: Yok

Tag

Konteyner

Paketin döndürülen bir etiketini depolayan konteyner.

Üst düğüm: TagSet

Key

Dize

Etiket anahtarı.

Üst düğüm: Tag

Value

Dize

Etiket değeri.

Üst düğüm: Tag

Örnekler

  • Örnek istek

    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
  • Örnek yanıt

    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 SDK'ları

GetBucketTags işlemini kullanmak için aşağıdaki programlama dillerine ait OSS SDK'larından yararlanabilirsiniz:

ossutil

GetBucketTags işlemine karşılık gelen ossutil komutu hakkında bilgi almak için bkz. get-bucket-tags.

Hata kodları


Hata kodu


HTTP durum kodu


Açıklama


NoSuchBucket


404


Belirtilen paket mevcut olmadığından hata iletisi döndürüldü.


AccessDenied


403


Paket için yapılandırılan etiketleri sorgulama izniniz bulunmadığından hata iletisi döndürüldü. Bir paket için yapılandırılan etiketleri yalnızca paket sahibi sorgulayabilir.