GetObjectTagging - Object Storage Service - Alibaba Cloud Dokümantasyon Merkezi

Sürüm oluşturma hakkında

GetObjectTagging işlemini çağırdığınızda varsayılan olarak yalnızca nesnenin mevcut sürümünün etiketleri döndürülür. Belirli bir sürümün etiketlerini sorgulamak için versionId parametresini belirtebilirsiniz. Belirttiğiniz sürüm bir silme işaretçisiyse OSS 404 Not Found hatası döndürür.

İstek sözdizimi

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

İstek parametreleri

Parametre	Tür	Zorunlu	Açıklama
tagging	String	Evet	Bu isteğin bir etiketleme işlemi olduğunu tanımlayan alt kaynak.
versionId	String	Hayır	Nesnenin sürüm kimliği. Belirtilmezse mevcut sürümün etiketleri döndürülür. Belirtilen sürüm bir silme işaretçisiyse OSS 404 Not Found hatası döndürür.

İstek üstbilgileri

GetObjectTagging isteğindeki tüm üstbilgiler ortak istek üstbilgeleridir. Daha fazla bilgi için bkz. Ortak istek üstbilgileri.

Yanıt üstbilgileri

GetObjectTagging isteğine verilen yanıt ortak yanıt üstbilgilerini içerir. Daha fazla bilgi için bkz. Ortak yanıt üstbilgileri.

Belirli bir nesne sürümünün etiketlerini sorguladığınızda yanıt ayrıca x-oss-version-id üstbilgisini de içerir.

Yanıt öğeleri

Ad	Tür	Açıklama
Tagging	Container	Etiketleme yanıtı için kök kapsayıcı. Alt düğümler: TagSet
TagSet	Container	Tüm etiketleri tutan kapsayıcı. Üst düğümler: Tagging Alt düğümler: Tag
Tag	Container	Tek bir etiket. Üst düğümler: TagSet Alt düğümler: Key ve Value
Key	String	Etiketin anahtarı. Üst düğümler: Tag Alt düğümler: yok
Value	String	Etiketin değeri. Üst düğümler: Tag Alt düğümler: yok

Örnekler

Sürüm oluşturma etkinleştirilmemiş durumda. Bu örnekte bucketname paketindeki objectname nesnesinin etiketlerini sorgulamak üzere bir GET isteği gönderilir. {a:1} ve {b:2} etiketleri 200 (OK) durum koduyla döndürülür.

Örnek istek

GET /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 Mar 2019 02:02:36 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Örnek yanıt

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>

Sürüm oluşturma etkinleştirilmiş durumda. Bu örnekte bucketname paketindeki objectname nesnesinin belirli bir sürümünün etiketlerini sorgulamak üzere bir GET isteği gönderilir. Örnek istekte versionId belirtilmiştir. {age:18} etiketi 200 (OK) durum koduyla döndürülür.

Örnek istek

GET /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 24 Jun 2020 08:50:28 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Örnek yanıt

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

GetObjectTagging işlemi için aşağıdaki programlama dillerinde SDK örnekleri mevcuttur:

ossutil komut satırı aracı

GetObjectTagging işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. GetObjectTagging.

Hata kodları

Hata kodu	HTTP durum kodu	Açıklama
FileAlreadyExists	409	Paket hiyerarşik ad alanı özelliği etkinleştirildiğinde ve pakette etiketlerini sorgulamak istediğiniz nesne bir dizin olduğunda döndürülen hata.