GetBucketTags - Object Storage Service - Centre de documentation Alibaba Cloud

Appelez cette opération pour récupérer les tags configurés sur un bucket.

Syntaxe de la requête

GET /? tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Remarques

L'autorisation oss:GetBucketTagging est requise pour récupérer les informations de tag du bucket via l'opération GetBucketTags. Pour plus d'informations, consultez la rubrique Grant a custom policy.

Éléments de réponse

Élément	Type	Description
Tagging	Conteneur	Conteneur stockant les tags renvoyés pour le bucket. Nœud parent : aucun Remarque Si aucun tag n'est configuré sur le bucket, le corps du message XML renvoyé contient un élément Tagging vide.
TagSet	Conteneur	Conteneur stockant les tags renvoyés pour le bucket. Nœud parent : aucun
Tag	Conteneur	Conteneur stockant un tag renvoyé pour le bucket. Nœud parent : TagSet
Key	Chaîne	Clé du tag. Nœud parent : Tag
Value	Chaîne	Valeur du tag. Nœud parent : Tag

Exemples

Exemple de requête

GET /? tagging
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Tue, 20 Dec 2018 13:09:13 GMT
Authorization: OSS qn6q**************:77Dv****************

Exemple de réponse

200 (OK)
content-length: 237
server: AliyunOSS
x-oss-request-id: 5C1B2D24B90AD5490CFE368E
date: Thu, 20 Dec 2018 13:12:21 GMT
content-type: application/xml
<? xml version="1.0" encoding="UTF-8"? >
<Tagging>
  <TagSet>
    <Tag>
      <Key>testa</Key>
      <Value>value1-test</Value>
    </Tag>
    <Tag>
      <Key>testb</Key>
      <Value>value2-test</Value>
    </Tag>
  </TagSet>
</Tagging>

SDK OSS

Utilisez les SDK OSS des langages de programmation suivants pour appeler l'opération GetBucketTags :

ossutil

Pour plus d'informations sur la commande ossutil correspondant à l'opération GetBucketTags, consultez la rubrique get-bucket-tags.

Codes d'erreur

Code d'erreur

Code d'état HTTP

Description

NoSuchBucket

404

Le bucket spécifié n'existe pas.

AccessDenied

403

Vous ne disposez pas des autorisations nécessaires pour interroger les tags configurés sur le bucket. Seul le propriétaire du bucket peut interroger ses tags.