Object Storage Service:bucket-tagging

Notes

• Pour ajouter ou modifier des tags de compartiment, vous devez disposer de l'autorisation oss:PutBucketTagging. Pour interroger les tags de compartiment, l'autorisation oss:GetBucketTagging est requise. Pour supprimer des tags de compartiment, vous devez détenir l'autorisation oss:DeleteBucketTagging. 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. Il n'est plus nécessaire d'adapter le nom du binaire en fonction du système d'exploitation. Pour les versions antérieures à 1.6.16, cette adaptation reste requise. 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 de compartiment, consultez la rubrique Gérer les tags de compartiment.

Ajouter des tags à un compartiment ou modifier ses tags existants

Le marquage des compartiments utilise des paires clé-valeur pour identifier les compartiments. Seul le propriétaire du compartiment ainsi que les utilisateurs disposant de l'autorisation PutBucketTags peuvent ajouter ou modifier des tags. Toute tentative effectuée par d'autres utilisateurs entraîne une erreur 403 Forbidden avec le code d'erreur AccessDenied.

• Syntaxe de la commande

  ossutil bucket-tagging --method put oss://bucketname key#value

  Le tableau suivant décrit les paramètres mentionnés ci-dessus.

  Paramètre	Description
  bucketname	Nom du compartiment auquel vous souhaitez ajouter un tag ou dont vous souhaitez modifier le tag.
  key#value	Paire clé-valeur du tag. La clé et la valeur du tag sont séparées par un dièse (#) et doivent être encodées en UTF-8. La clé peut contenir jusqu'à 64 caractères. Elle ne doit pas commencer par les préfixes http://, https:// ou Aliyun. La clé ne peut pas être vide. La valeur peut atteindre 128 caractères. Elle peut rester vide.

  Si le tag spécifié dans la commande n'existe pas, il est ajouté au compartiment. S'il existe déjà, le tag existant est écrasé.

• Exemples

  La commande suivante ajoute deux tags à un compartiment nommé examplebucket. Le premier tag possède la clé tag1 et la valeur test1, tandis que le second a pour clé tag2 et pour valeur test2.

  ossutil bucket-tagging --method put oss://examplebucket  tag1#test1 tag2#test2

  Le résultat suivant confirme l'ajout des tags.

  0.300600(s) elapsed

Interroger les tags d'un compartiment

• Syntaxe de la commande

  ossutil bucket-tagging --method get oss://bucketname

• Exemples

  Interrogez les tags du compartiment examplebucket avec la commande suivante :

  ossutil bucket-tagging --method get oss://examplebucket

  Le résultat indique que le compartiment examplebucket comporte deux tags : l'un avec la clé tag1 et la valeur test1, l'autre avec la clé tag2 et la valeur test2.

  index     tag key       tag value
  ---------------------------------------------------
  0         "tag1"        "test1"
  1         "tag2"        "test2"
  
  0.283359(s) elapsed

Supprimer des tags

• Syntaxe de la commande

  ossutil bucket-tagging --method delete oss://bucketname 

• Exemples

  L'exemple suivant supprime tous les tags du compartiment examplebucket.

  Remarque

  ossutil permet uniquement de supprimer l'intégralité des tags d'un compartiment. Il n'est pas possible de supprimer sélectivement certains tags via cet outil. Pour retirer des tags spécifiques, appelez l'opération DeleteBucketTags.

  ossutil bucket-tagging --method delete oss://examplebucket

  Le résultat ci-dessous confirme la suppression de tous les tags du compartiment examplebucket.

  0.530750(s) elapsed

Options courantes

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

ossutil bucket-tagging--method put oss://examplebucket key#value -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Options courantes.