Affichage des balises d'un coffre (GET tags) - Amazon S3 Glacier
Syntaxe de la requêteParamètres de demandeEn-têtes de demandeCorps de la requêteRéponsesExemplesSections connexesVoir aussi

Si vous débutez dans le stockage d'archives dans Amazon Simple Storage Service (Amazon S3), nous vous recommandons dans un premier temps de vous familiariser avec les classes de stockage S3 Glacier dans Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive. Pour plus d'informations, consultez les sections Classes de stockage S3 Glacier et Classes de stockage pour l'archivage d'objets dans le guide de l'utilisateur Amazon S3.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Affichage des balises d'un coffre (GET tags)

Cette opération affiche la liste de toutes les balises attachées à un coffre. En l'absence de balises, elle renvoie un mappage vide. Pour en savoir plus sur les identifications, consultez Balisage des ressources Amazon S3 Glacier.

Syntaxe de la requête

Pour afficher la liste des balises attachées à un coffre, envoyez une demande HTTP GET à l'URI des balises, comme illustré dans l'exemple de syntaxe suivant.

GET /AccountId/vaults/vaultName/tags HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

Note

La valeur de AccountId est l'ID de Compte AWS. Cette valeur doit correspondre à l'ID de Compte AWS associé aux informations d'identification utilisées pour signer la demande. Vous pouvez spécifier un ID de Compte AWS ou éventuellement un simple « - » (trait d'union), auquel cas Amazon S3 Glacier utilise l'ID de Compte AWS associé aux informations d'identification utilisées pour signer la demande. Si vous spécifiez votre ID de compte, n'incluez pas de traits d'union (« - ») dans l'ID.

Paramètres de demande

Cette opération n'utilise pas les paramètres de demande.

En-têtes de demande

Cette opération utilise uniquement les en-têtes de demande qui sont communs à toutes les opérations. Pour plus d'informations sur les en-têtes de demande communs, consultez En-têtes de demande communs.

Corps de la requête

Cette opération n'a pas de corps de demande.

Réponses

Si l'opération aboutit, le service renvoie une réponse HTTP 200 OK.

Syntaxe de la réponse

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length
{
   "Tags": 
      {
         "string" : "string",
         "string" : "string"
      }
}

En-têtes de réponse

Cette opération utilise uniquement les en-têtes de réponse qui sont communs à la plupart des réponses. Pour plus d'informations sur les en-têtes de réponse communs, consultez En-têtes de réponse communs.

Corps de la réponse

Le corps de la réponse contient les champs JSON suivants.

Balises

Balises attachées au coffre. Chaque balise est constituée d'une clé et d'une valeur.

Type : mappage chaîne/chaîne

Obligatoire : oui

Erreurs

Pour en savoir plus sur les exceptions et les messages d'erreur Amazon S3 Glacier, consultez Réponses d'erreur.

Exemples

Exemple : Affichage de la liste des balises attachées à un coffre

L'exemple suivant affiche la liste des balises attachées à un coffre.

Exemple de requête

Dans cet exemple, une demande GET est envoyée pour extraire une liste de balises du coffre spécifié.

GET /-/vaults/examplevault/tags HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

Exemple de réponse

Si la demande aboutit, Amazon S3 Glacier (S3 Glacier) renvoie HTTP 200 OK avec la liste des balises du coffre, comme l'illustre l'exemple suivant.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Content-Type: application/json
Content-Length: length

{
   "Tags",
      {
         "examplekey1": "examplevalue1",
         "examplekey2": "examplevalue2"
      }  
}

Voir aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK Amazon propres au langage, consultez la ressource suivante :