Exécutez la commande object-tagging pour gérer les tags d'objet - Object Storage Service

Object Storage Service (OSS) vous permet de classer les objets à l'aide de tags. Vous pouvez ainsi gérer les objets partageant le même tag, par exemple en définissant leur période de validité ou en modifiant leur classe de stockage. Exécutez la commande object-tagging pour ajouter, modifier, interroger ou supprimer des tags d'objet.

Notes d'utilisation

Pour ajouter ou modifier un tag d'objet, vous devez disposer de l'autorisation oss:PutObjectTagging. Pour interroger les tags d'un objet, l'autorisation oss:GetObjectTagging est requise. Enfin, pour supprimer un tag d'objet, vous devez avoir l'autorisation oss:DeleteObjectTagging. Pour plus d'informations, consultez la rubrique Accorder une stratégie personnalisée.

À partir de la version 1.6.16 d'ossutil, utilisez directement ossutil comme nom binaire dans la ligne de commande, sans adaptation selon le système d'exploitation. Pour les versions antérieures à 1.6.16, adaptez le nom binaire en fonction de votre système. Pour plus de détails, reportez-vous au guide Démarrage rapide de l'outil de ligne de commande ossutil.
Pour en savoir plus sur les tags d'objet, consultez la documentation relative au Taggage d'objets.

Syntaxe de la commande

ossutil object-tagging oss://bucketname[/prefix][key#value]
--method <value>
[--encoding-type <value>]
[-r, --recursive]
[--payer <value>]
[--version-id <value>]

Le tableau suivant décrit les paramètres et options de cette syntaxe.

Paramètre/Option	Description
bucketname	Nom du bucket.
prefix	Préfixe utilisé dans les noms des ressources, tels que les répertoires et les objets.
key	Clé du tag. Un tag se présente sous la forme d'une paire clé-valeur. Vous pouvez associer jusqu'à 10 tags à chaque objet. Les clés des tags d'un même objet doivent être uniques. La clé d'un tag doit respecter les exigences suivantes : La longueur maximale de la clé est de 128 caractères. La distinction majuscules/minuscules s'applique. La clé peut contenir des lettres, des chiffres, des espaces et les caractères spéciaux suivants : +=._:/
value	Valeur du tag. Elle doit satisfaire aux critères suivants : La longueur maximale de la valeur est de 256 caractères. La distinction majuscules/minuscules s'applique. La valeur peut contenir des lettres, des chiffres, des espaces et les caractères spéciaux suivants : +=._:/
--method	Type de requête. Valeurs possibles : put : ajoute des tags à un objet ou modifie ses tags existants. get : interroge les tags d'un objet. delete : supprime les tags d'un objet.
--encoding-type	Méthode d'encodage appliquée au préfixe qui suit `oss://bucket_name`. Valeur valide : url. Si cette option n'est pas spécifiée, le préfixe n'est pas encodé.
-r, --recursive	Si cette option est indiquée dans la commande, ossutil applique le taggage à tous les objets dont le nom contient le préfixe spécifié par le paramètre prefix. Sans cette option, seul l'objet explicitement désigné est concerné.
--version-id	ID de version de l'objet. Ce paramètre s'applique uniquement aux buckets pour lesquels le contrôle de version est activé ou suspendu.
--payer	Payeur de la requête. Définissez ce paramètre sur requester si vous souhaitez que l'utilisateur qui accède aux ressources du chemin spécifié prenne en charge les frais générés par l'opération (trafic et requêtes).

Ajouter ou modifier des tags d'objet

Seul le propriétaire du bucket et les utilisateurs RAM disposant de l'autorisation PutObjectTagging peuvent ajouter ou modifier des tags sur les objets de ce bucket.

Les exemples suivants illustrent les procédures d'ajout et de modification de tags :

Important

Si l'objet cible ne possède pas encore de tag avec la clé indiquée dans la commande, le tag est ajouté. En revanche, si un tag avec la même clé existe déjà, il est écrasé par la nouvelle valeur.

Configurez un tag (clé : tagkey, valeur : tagvalue) pour l'objet exampleobject.txt situé dans le bucket examplebucket :
```
ossutil object-tagging --method put oss://examplebucket/exampleobject.txt tagkey#tagvalue
```
Attribuez plusieurs tags (tagkey1#tagvalue1 et tagkey2#tagvalue2) à l'objet exampleobject.png du bucket examplebucket :
```
ossutil object-tagging --method put oss://examplebucket/exampleobject.txt tagkey1#tagvalue1 tagkey2#tagvalue2
```
Appliquez les tags tagkey3#tagvalue3, tagkey4#tagvalue4 et tagkey5#tagvalue5 à tous les objets dont le nom commence par le préfixe « test » dans le bucket examplebucket :
```
ossutil object-tagging --method put oss://examplebucket/test -r tagkey3#tagvalue3 tagkey4#tagvalue4 tagkey5#tagvalue5
```
Définissez un tag (clé : tagkey6, valeur : tagvalue6) pour une version spécifique de l'objet exampleobject.txt dans le bucket examplebucket :
```
ossutil object-tagging --method put oss://examplebucket/exampleobject.txt tagkey6#tagvalue6 --version-id CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3****
```
Pour lister toutes les versions d'un objet, reportez-vous à la commande ls (Lister des buckets, objets ou parties).
Une fois les commandes précédentes exécutées avec succès, un résultat similaire au suivant s'affiche, indiquant le temps nécessaire au taggage :
```
0.106852(s) elapsed
```

Interroger des tags d'objet

Seul le propriétaire du bucket et les utilisateurs RAM disposant de l'autorisation GetObjectTagging peuvent consulter les tags des objets de ce bucket.

Voici comment interroger les tags d'objets :

Interroger les tags d'un objet

Récupérez les tags de l'objet exampleobject.txt présent dans le bucket examplebucket :

ossutil object-tagging --method get oss://examplebucket/exampleobject.txt

La sortie ci-dessous confirme que l'objet exampleobject.txt possède un tag avec la clé tagkey et la valeur tagvalue.

object index   tag index      tag key   tag value       object
---------------------------------------------------------------------------
1              0              "tagkey"  "tagvalue"      oss://examplebucket/exampleobject.txt

0.068156(s) elapsed

Interroger les tags de plusieurs objets

Récupérez les tags de tous les objets dont le nom commence par le préfixe « test » dans le bucket examplebucket :

ossutil object-tagging --method get oss://examplebucket/test -r

Le résultat indique que les objets correspondant au préfixe « test » possèdent les tags suivants : tagkey3#tagvalue3, tagkey4#tagvalue4 et tagkey5#tagvalue5.

object index   tag index      tag key   tag value       object
---------------------------------------------------------------------------
1              0              "tagkey3" "tagvalue3"     oss://examplebucket/test
1              1              "tagkey4" "tagvalue4"     oss://examplebucket/test
1              2              "tagkey5" "tagvalue5"     oss://examplebucket/test

0.093040(s) elapsed

Supprimer des tags d'objet

Seul le propriétaire du bucket et les utilisateurs RAM disposant de l'autorisation DeleteObjectTagging peuvent supprimer les tags des objets de ce bucket.

Les exemples suivants montrent comment supprimer des tags :

Supprimer les tags d'un objet

Supprimez les tags de l'objet exampleobject.txt dans le bucket examplebucket :
```
ossutil object-tagging --method delete oss://examplebucket/exampleobject.txt
```
Supprimer les tags de plusieurs objets

Supprimez les tags de tous les objets dont le nom commence par le préfixe « test » dans le bucket examplebucket :
```
ossutil object-tagging --method delete oss://examplebucket/test -r
```
En cas de succès, la sortie suivante s'affiche, indiquant le temps nécessaire à la suppression des tags :
```
0.148970(s) elapsed
```

Options courantes

Pour accéder à un bucket situé dans une autre région, utilisez l'option -e afin de spécifier l'endpoint. Pour accéder à un bucket appartenant à un autre compte Alibaba Cloud, indiquez l'AccessKey ID avec l'option -i et l'AccessKey Secret avec l'option -k.

Par exemple, configurez un tag (clé : tagkey7, valeur : tagvalue7) pour l'objet example.png dans le bucket testbucket, situé dans la région Chine (Shanghai) et appartenant à un autre compte Alibaba Cloud :

ossutil object-tagging --method put oss://testbucket/exampletest.png tagkey7#tagvalue7 -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Options courantes.