PutBucketTags - Add or modify bucket tags - Object Storage Service

Paket etiketleri ekler veya değiştirir.

Kullanım notları

PutBucketTags çağrısı yaparken aşağıdaki hususlara dikkat edin:

Yalnızca paket sahibi ve yetkilendirilmiş RAM kullanıcıları paket etiketlerini yapılandırabilir. Diğer kullanıcılar AccessDenied hata koduyla 403 Forbidden hatası alır.
Her paket en fazla 20 etiketi (anahtar-değer çifti) destekler.
PutBucketTags üzerine yazma semantiği kullanır; yeni bir etiket, aynı anahtara sahip mevcut etiketin yerine geçer.

İzinler

Varsayılan olarak bir Alibaba Cloud hesabı tam izinlere sahiptir. Bir Alibaba Cloud hesabı altındaki RAM kullanıcıları veya RAM rollerinin varsayılan olarak izni yoktur. Alibaba Cloud hesabı veya hesap yöneticisi, işlem izinlerini RAM ilkeleri veya Paket İlkesi aracılığıyla vermelidir.

API	Eylem	Açıklama
PutBucketTags	oss:PutBucketTagging	Bir pakete etiket ekler veya paketin etiketlerini değiştirir.

İstek sözdizimi

PUT /?tagging HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Authorization: SignatureValue
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>key1</Key>
      <Value>value1</Value>
    </Tag>
    <Tag>
      <Key>key2</Key>
      <Value>value2</Value>
    </Tag>
  </TagSet>
</Tagging>

İstek üstbilgileri

Bu istek yalnızca ortak istek üstbilgilerini kullanır. Daha fazla bilgi için bkz. Ortak istek üstbilgileri.

İstek öğeleri

Öğe	Tür	Gerekli	Açıklama
Tagging	Konteyner	Evet	TagSet için konteyner. Alt düğümler: TagSet Üst düğümler: yok
TagSet	Konteyner	Evet	Etiketler için konteyner. Alt düğümler: Tag Üst düğümler: Tagging
Tag	Konteyner	Evet	Eklenecek veya değiştirilecek etiket için konteyner. Alt düğümler: Key ve Value Üst düğümler: TagSet
Key	STRING	Evet	Etiket anahtarı. Maksimum uzunluk: 64 bayt. Bir etiket anahtarı `http://`, `https://` veya `Aliyun` ile başlayamaz. UTF-8 kodlamalı olmalıdır. Boş bırakılamaz. Alt düğümler: yok Üst düğümler: Tag
Value	STRING	Hayır	Etiket değeri. Maksimum uzunluk: 128 bayt. UTF-8 kodlamalı olmalıdır. Boş olabilir. Alt düğümler: yok Üst düğümler: Tag

Yanıt üstbilgileri

Bu yanıt yalnızca ortak yanıt üstbilgilerini kullanır. Daha fazla bilgi için bkz. Ortak yanıt üstbilgileri.

Örnekler

Örnek istek

PUT /?tagging
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 11:49:13 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<Tagging>
  <TagSet>
    <Tag>
      <Key>testa</Key>
      <Value>testv1</Value>
    </Tag>
    <Tag>
      <Key>testb</Key>
      <Value>testv2</Value>
    </Tag>
  </TagSet>
</Tagging>

Örnek yanıt

200 (OK)
content-length: 0
server: AliyunOSS
x-oss-request-id: 5C1B138A109F4E405B2D****
date: Thu, 20 Dec 2018 11:59:06 GMT
x-oss-server-time: 148
connection: keep-alive

OSS SDK'ları

Aşağıdaki diller için OSS SDK'larını kullanarak PutBucketTags çağrısı yapabilirsiniz:

ossutil

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