Object Storage Service:PutObjectTagging

Notes d'utilisation

• Vous pouvez ajouter jusqu'à 10 tags à un objet. Les clés des tags doivent être uniques pour un même objet.

• Une clé de tag peut contenir jusqu'à 128 caractères. Une valeur de tag peut contenir jusqu'à 256 caractères.

• Les clés et les valeurs des tags sont sensibles à la casse.

• Les clés et les valeurs des tags peuvent contenir des lettres, des chiffres, des espaces et les caractères spéciaux suivants :

  + - = . _ : /

  Si les tags de l'en-tête HTTP contiennent des caractères spéciaux, vous devez encoder les clés et les valeurs au format URL.

• La modification des tags d'un objet ne met pas à jour le paramètre Last-Modified de cet objet.

Pour plus d'informations sur les tags d'objet, consultez la rubrique Configurer le tagging d'objets.

Gestion des versions

Par défaut, lorsque vous appelez l'opération PutObjectTagging pour ajouter ou mettre à jour des tags, ceux-ci s'appliquent à la version actuelle de l'objet. Spécifiez le paramètre versionId dans la requête pour cibler une version spécifique de l'objet. Si la version indiquée correspond à un marqueur de suppression, OSS renvoie l'erreur 404 Not Found.

Autorisations

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

Syntaxe de la requête

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>            

Éléments de la requête

Cette opération utilise également des en-têtes de requête communs. Pour plus d'informations, consultez la rubrique En-têtes HTTP communs.

Exemples

• Ajouter des tags à un objet dans un bucket sans gestion des versions

  Dans cet exemple, un objet nommé objectname est stocké dans un bucket nommé bucketname, pour lequel la gestion des versions n'est pas activée. Envoyez une requête PutObjectTagging pour ajouter les tags {a:1} et {b:2} à l'objet objectname. Un code 200 (OK) est renvoyé après l'ajout réussi des deux tags.

  Exemple de requête

  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>

  Exemple de réponse

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

• Ajouter des tags à un objet dans un bucket avec gestion des versions activée

  Dans cet exemple, un objet nommé objectname est stocké dans un bucket nommé bucketname, pour lequel la gestion des versions est activée. Envoyez une requête PutObjectTagging pour ajouter le tag {age:18} à une version spécifique de l'objet objectname. Un code 200 (OK) est renvoyé après l'ajout réussi du tag.

  Exemple de requête

  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>

  Exemple de réponse

  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****

SDK OSS

Utilisez les SDK OSS pour les langages de programmation suivants afin d'appeler l'opération PutObjectTagging :

• Java

• Python V2

• Go V2

• PHP V2

• C++

• .NET

• Node.js

• iOS

• Android

ossutil

Pour plus d'informations sur la commande ossutil correspondant à l'opération PutObjectTagging, consultez la rubrique put-object-tagging.

Codes d'erreur