GetObjectTagging - Object Storage Service - Centre de documentation Alibaba Cloud

À propos du versioning

Par défaut, lorsque vous appelez l'opération GetObjectTagging, seuls les tags de la version actuelle de l'objet sont renvoyés. Vous pouvez spécifier le paramètre versionId pour interroger les tags d'une version spécifique de l'objet. Si la version spécifiée de l'objet est un marqueur de suppression, OSS renvoie une erreur 404 Not Found.

Syntaxe de la requête

GET /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 Mar 2019 02:02:36 GMT
Authorization: SignatureValue

Paramètres de la requête

Paramètre	Type	Obligatoire	Description
tagging	String	Oui	La sous-ressource qui identifie cette opération comme une opération de tag.
versionId	String	Non	L'ID de version de l'objet. S'il n'est pas spécifié, les tags de la version actuelle sont renvoyés. Si la version spécifiée est un marqueur de suppression, OSS renvoie une erreur 404 Not Found.

En-têtes de la requête

Tous les en-têtes d'une requête GetObjectTagging sont des en-têtes de requête communs. Pour plus d'informations, consultez les En-têtes de requête communs.

En-têtes de la réponse

La réponse à une requête GetObjectTagging inclut des en-têtes de réponse communs. Pour plus d'informations, consultez les En-têtes de réponse communs.

Lorsque vous interrogez les tags d'une version spécifique d'un objet, la réponse inclut également l'en-tête x-oss-version-id.

Éléments de la réponse

Nom	Type	Description
Tagging	Container	Le conteneur racine pour la réponse de tag. Nœuds enfants : TagSet
TagSet	Container	Le conteneur qui contient tous les tags. Nœuds parents : Tagging Nœuds enfants : Tag
Tag	Container	Un tag unique. Nœuds parents : TagSet Nœuds enfants : Key et Value
Key	String	La clé du tag. Nœuds parents : Tag Nœuds enfants : aucun
Value	String	La valeur du tag. Nœuds parents : Tag Nœuds enfants : aucun

Exemples

Lorsque le versioning n'est pas activéDans cet exemple, une requête GET est envoyée pour interroger les tags de l'objet objectname dans le bucket bucketname. Les tags {a:1} et {b:2} sont renvoyés avec un code d'état 200 (OK).

Exemple de requête

GET /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 Mar 2019 02:02:36 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Exemple de réponse

200 (OK)
content-length: 209
server: AliyunOSS
x-oss-request-id: 5C919F38461FB4282600****
date: Wed, 20 Mar 2019 02:02:32 GMT
content-type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>a</Key>
      <Value>1</Value>
    </Tag>
    <Tag>
      <Key>b</Key>
      <Value>2</Value>
    </Tag>
  </TagSet>
</Tagging>

Lorsque le versioning est activéDans cet exemple, une requête GET est envoyée pour interroger les tags d'une version spécifique de l'objet objectname dans le bucket bucketname. Le versionId est spécifié dans l'exemple de requête. Le tag {age:18} est renvoyé avec un code d'état 200 (OK).

Exemple de requête

GET /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 24 Jun 2020 08:50:28 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Exemple de réponse

200 (OK)
content-length: 161
server: AliyunOSS
x-oss-request-id: 5EF313D44506783438F3****
date: Wed, 24 Jun 2020 08:50:28 GMT
content-type: application/xml
x-oss-version-id: CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>age</Key>
      <Value>18</Value>
    </Tag>
  </TagSet>
</Tagging>

SDK OSS

Des exemples de SDK pour l'opération GetObjectTagging sont disponibles pour les langages de programmation suivants :

Outil de ligne de commande ossutil

Pour obtenir des informations sur la commande ossutil correspondant à l'opération GetObjectTagging, consultez la section GetObjectTagging.

Codes d'erreur

Code d'erreur	Code d'état HTTP	Description
FileAlreadyExists	409	L'erreur renvoyée car la fonctionnalité d'espace de noms hiérarchique est activée pour le bucket et l'objet dont vous souhaitez interroger les tags dans le bucket est un répertoire.