Object Storage Service:PutObjectTagging

Kullanım notları

• Bir nesneye en fazla 10 etiket ekleyebilirsiniz. Bir nesneye eklenen etiketlerin anahtarları benzersiz olmalıdır.

• Etiket anahtarı uzunluğu en fazla 128 karakter olabilir. Etiket değeri uzunluğu en fazla 256 karakter olabilir.

• Etiket anahtarları ve değerleri büyük/küçük harfe duyarlıdır.

• Etiket anahtarı ve değeri harf, rakam, boşluk ve aşağıdaki özel karakterleri içerebilir:

  + - = . _ : /

  HTTP üstbilgilerindeki etiketler özel karakter içeriyorsa etiket anahtarlarını ve değerlerini URL kodlamasına tabi tutmanız gerekir.

• Bir nesnenin etiketlerini değiştirmek nesnenin Last-Modified parametresini güncellemez.

Nesne etiketleme hakkında daha fazla bilgi için bkz. Nesne etiketlemeyi yapılandırma.

Sürüm oluşturma

Varsayılan olarak PutObjectTagging çağrısı yaparak bir nesneye etiket eklediğinizde veya nesne için yapılandırılmış etiketleri güncellediğinizde işlemler nesnenin geçerli sürümü üzerinde uygulanır. Belirli bir sürüme etiket eklemek veya o sürümün etiketlerini güncellemek için istekte versionId parametresini belirtebilirsiniz. Belirtilen sürüm bir silme işaretçisi ise OSS 404 Not Found yanıtını döndürür.

İzinler

Varsayılan olarak Alibaba Cloud hesabı tam yetkilere sahiptir. Bir Alibaba Cloud hesabı altındaki RAM kullanıcıları veya RAM rolleri varsayılan olarak herhangi bir izne sahip değildir. Alibaba Cloud hesabı veya hesap yöneticisi işlem izinlerini RAM ilkeleri veya Paket İlkesi aracılığıyla vermelidir.

İstek sözdizimi

PUT /objectname?tagging
Content-Length: 114
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue
<Tagging>
  <TagSet>
    <Tag>
      <Key>Key</Key>
      <Value>Value</Value>
    </Tag>
  </TagSet>
</Tagging>            

İstek öğeleri

Bu işlem ortak istek üstbilgilerini de içerir. Daha fazla bilgi için bkz. Ortak HTTP üstbilgileri.

Örnekler

• Sürüm oluşturmanın etkin olmadığı bir paketteki nesneye etiket ekleme

  Bu örnekte objectname adlı bir nesne bucketname adlı sürüm oluşturmanın etkin olmadığı bir pakette depolanır. objectname adlı nesneye {a:1} ve {b:2} etiketlerini eklemek için bir PutObjectTagging isteği gönderilir. İki etiket nesneye eklendikten sonra 200 (OK) yanıtı döndürülür.

  Örnek istekler

  PUT /objectname?tagging
  Content-Length: 114
  Host: BucketName.oss-cn-hangzhou.aliyuncs.com
  Date: Mon, 18 Mar 2019 08:25:17 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  <Tagging>
    <TagSet>
      <Tag>
        <Key>a</Key>
        <Value>1</Value>
      </Tag>
      <Tag>
        <Key>b</Key>
        <Value>2</Value>
      </Tag>
    </TagSet>
  </Tagging>

  Örnek yanıtlar

  200 (OK)
  content-length: 0
  server: AliyunOSS
  connection: keep-alive
  x-oss-request-id: 5C8F55ED461FB4A64C00****
  date: Mon, 18 Mar 2019 08:25:17 GMT

• Sürüm oluşturmanın etkin olduğu bir paketteki nesneye etiket ekleme

  Bu örnekte objectname adlı bir nesne bucketname adlı sürüm oluşturma özelliğinin etkin olduğu bir pakette depolanır. objectname nesnesinin belirtilen sürümüne {age:18} etiketini eklemek için bir PutObjectTagging isteği gönderilir. Etiket nesneye eklendikten sonra 200 (OK) yanıtı döndürülür.

  Örnek istekler

  PUT /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****
  Content-Length: 90
  Host: BucketName.oss-cn-hangzhou.aliyuncs.com
  Date: Wed, 24 Jun 2020 08:58:15 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  <Tagging>
    <TagSet>
      <Tag>
        <Key>age</Key>
        <Value>18</Value>
      </Tag>
    </TagSet>
  </Tagging>

  Örnek yanıtlar

  200 (OK)
  content-length: 0
  server: AliyunOSS
  connection: keep-alive
  x-oss-request-id: 5EF315A7FBD3EC3232B4****
  date: Wed, 24 Jun 2020 08:58:15 GMT
  x-oss-version-id: CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****

OSS SDK'ları

PutObjectTagging işlemini çağırmak için aşağıdaki programlama dillerine yönelik OSS SDK'larını kullanabilirsiniz:

• Java

• Python V2

• Go V2

• PHP V2

• C++

• .NET

• Node.js

• iOS

• Android

ossutil

PutObjectTagging işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. put-object-tagging.

Hata kodları