Ajout de balises à un coffre (POST tags add) - Amazon S3 Glacier
Syntaxe de la requêteParamètres de demandeRéponsesExemplesSections connexesVoir aussi

Cette page est réservée aux clients existants du service S3 Glacier utilisant Vaults et l'original REST API de 2012.

Si vous recherchez des solutions de stockage d'archives, nous vous conseillons d'utiliser les classes de stockage S3 Glacier dans Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive. Pour en savoir plus sur ces options de stockage, consultez les sections Classes de stockage S3 Glacier et Stockage de données à long terme à l'aide des classes de stockage S3 Glacier dans le guide de l'utilisateur Amazon S3. Ces classes de stockage utilisent Amazon S3API, sont disponibles dans toutes les régions et peuvent être gérées au sein de la console Amazon S3. Ils offrent des fonctionnalités telles que l'analyse des coûts de stockage, Storage Lens, des fonctionnalités de chiffrement optionnelles avancées, etc.

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.

Ajout de balises à un coffre (POST tags add)

Cette opération ajoute les balises spécifiées à un coffre. Chaque balise est constituée d'une clé et d'une valeur. Chaque coffre peut comporter jusqu'à 50 balises. Si votre demande entraîne le dépassement de la limite de balise pour le coffre, l'erreur LimitExceededException est générée par l'opération.

Si une balise existe déjà sur le coffre sous une clé spécifiée, la valeur de clé existante est remplacée. Pour en savoir plus sur les identifications, consultez Balisage des ressources Amazon S3 Glacier.

Syntaxe de la requête

Pour ajouter des balises à un coffre, envoyez une demande HTTP POST à l'URI des balises, comme illustré dans l'exemple de syntaxe suivant.

POST /AccountId/vaults/vaultName/tags?operation=add HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01
			
{
   "Tags": 
      {
         "string": "string",
         "string": "string"
      }        
}

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

Name (Nom) Description Obligatoire
operation=add

Paramètre de chaîne de requête unique operation doté de la valeur add pour le distinguer de l'opération Suppression des balises d'un coffre (POST tags remove).

 Oui

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

Le corps de la demande contient les champs JSON suivants.

Balises

Balises à ajouter au coffre. Chaque balise est constituée d'une clé et d'une valeur. La valeur peut être une chaîne vide.

Type : mappage chaîne/chaîne

Contraintes de longueur : longueur minimale fixée à 1. Longueur maximale fixée à 10.

Obligatoire : oui

Réponses

Si la demande d'opération aboutit, le service renvoie une réponse HTTP 204 No Content.

Syntaxe

HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date

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

Cette opération ne renvoie pas de corps de réponse.

Erreurs

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

Exemples

Exemple de requête

L'exemple suivant envoie une demande HTTP POST avec les balises à ajouter au coffre.

POST /-/vaults/examplevault/tags?operation=add HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
Content-Length: length
x-amz-glacier-version: 2012-06-01
			
{
  "Tags": 
    {
       "examplekey1": "examplevalue1",
       "examplekey2": "examplevalue2"
    }        
}

Exemple de réponse

Si la demande aboutit, S3 Glacier renvoie une réponse HTTP 204 No Content, comme dans l'exemple suivant.

HTTP/1.1 204 No Content
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT

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 :