Object Storage Service:PutObjectTagging

Notes d'utilisation

• Vous pouvez ajouter jusqu'à 10 tags à un objet. Les clés des tags doivent être uniques au sein d'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 peuvent contenir des lettres, des chiffres, des espaces ainsi que les caractères spéciaux suivants :

  + - = . _ : /

  Si les tags inclus dans l'en-tête HTTP contiennent des caractères spéciaux, encodez 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 Configuration des tags d'objet.

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. Si la version indiquée correspond à un marqueur de suppression, OSS renvoie l'erreur 404 Not Found.

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 de détails, reportez-vous à la section En-têtes HTTP communs.

Exemples

• Ajout de tags à un objet dans un bucket sans gestion des versions

  Dans cet exemple, un objet nommé objectname est stocké dans un bucket non versionné appelé bucketname. Une requête PutObjectTagging est envoyée pour ajouter les tags {a:1} et {b:2} à l'objet objectname. Le système renvoie le code 200 (OK) 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: OSS qn6q**************:77Dv****************
  <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

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

  Ici, l'objet objectname réside dans un bucket versionné nommé bucketname. La requête PutObjectTagging ajoute le tag {age:18} à une version spécifique de l'objet. L'opération aboutit avec le code 200 (OK).

  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: OSS qn6q**************:77Dv****************
  <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 disponibles pour les langages suivants afin d'appeler l'opération PutObjectTagging :

• Java

• Python

• Go V2

• PHP

• C++

• .NET

• Node.js

• iOS

ossutil

Pour connaître la commande ossutil correspondant à l'opération PutObjectTagging, consultez la documentation relative à put-object-tagging.

Codes d'erreur