Object Storage Service:PutBucketTags

Remarques sur l'utilisation

Lors de l'appel à PutBucketTags, tenez compte des points suivants :

• Seul le propriétaire du bucket et les utilisateurs RAM autorisés peuvent configurer les tags du bucket. Les autres utilisateurs reçoivent une erreur 403 Forbidden avec le code d'erreur AccessDenied.

• Chaque bucket prend en charge jusqu'à 20 tags (paires clé-valeur).

• PutBucketTags utilise une sémantique d'écrasement : un nouveau tag remplace tout tag existant ayant la même clé.

Permissions

Par défaut, un compte Alibaba Cloud dispose de toutes les permissions. Les utilisateurs RAM ou les rôles RAM associés à un compte Alibaba Cloud ne disposent d'aucune permission par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les permissions d'opération via des politiques RAM ou une Bucket Policy.

Syntaxe de la requête

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>

En-têtes de requête

Cette requête utilise uniquement des en-têtes de requête communs. Pour plus d'informations, consultez les En-têtes de requête communs.

Éléments de requête

En-têtes de réponse

Cette réponse utilise uniquement des en-têtes de réponse communs. Pour plus d'informations, consultez les En-têtes de réponse communs.

Exemples

• Exemple de requête

  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>

• Exemple de réponse

  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

Kits SDK OSS

Vous pouvez appeler PutBucketTags en utilisant les kits SDK OSS pour les langages suivants :

• Java

• Python V2

• Go V2

• C++

• Node.js

• .NET

• PHP V2

ossutil

Pour obtenir des informations sur la commande ossutil correspondant à l'opération PutBucketTags, consultez put-bucket-tags.