**Cette page est réservée aux clients existants du service Amazon Glacier utilisant Vaults et l'API REST d'origine datant de 2012.**

Si vous recherchez des solutions de stockage d'archives, nous vous recommandons d'utiliser les classes de stockage Amazon 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 [classes de stockage Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (service autonome d'origine basé sur un coffre-fort) n'accepte plus de nouveaux clients. Amazon Glacier est un service autonome doté de son propre service APIs qui stocke les données dans des coffres-forts et qui se distingue des classes de stockage Amazon S3 et Amazon S3 Glacier. Vos données existantes resteront sécurisées et accessibles indéfiniment dans Amazon Glacier. Aucune migration n'est requise. Pour un stockage d'archivage à long terme et à faible coût AWS , nous [recommandons les classes de stockage Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), qui offrent une expérience client supérieure avec des compartiments S3, une Région AWS disponibilité totale APIs, des coûts réduits et AWS une intégration des services. Si vous souhaitez des fonctionnalités améliorées, envisagez de migrer vers les classes de stockage Amazon S3 Glacier en suivant nos [conseils relatifs aux AWS solutions pour le transfert de données depuis les coffres-forts Amazon Glacier vers les classes de stockage Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-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.

# Ajout de balises à un coffre (POST tags add)
<a name="api-AddTagsToVault"></a>

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 Glacier](tagging.md).

## Syntaxe de la requête
<a name="api-AddTagsToVault-requestSyntax"></a>

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

```
 1. POST /AccountId/vaults/vaultName/tags?operation=add HTTP/1.1
 2. Host: glacier.Region.amazonaws.com
 3. Date: Date
 4. Authorization: SignatureValue
 5. Content-Length: Length
 6. x-amz-glacier-version: 2012-06-01
 7. 			
 8. {
 9.    "Tags": 
10.       {
11.          "string": "string",
12.          "string": "string"
13.       }        
14. }
```

 

**Note**  
La `AccountId` valeur est l' Compte AWS ID. Cette valeur doit correspondre à l' Compte AWS ID associé aux informations d'identification utilisées pour signer la demande. Vous pouvez spécifier un Compte AWS identifiant ou éventuellement un seul « `-` » (trait d'union), auquel cas Amazon Glacier utilise l' Compte AWS identifiant 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
<a name="api-AddTagsToVault-requestParameters"></a>


|  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)](api-RemoveTagsFromVault.md).  |  Oui  | 

### En-têtes de demande
<a name="api-AddTagsToVault-requests-headers"></a>

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](api-common-request-headers.md).

### Corps de la requête
<a name="api-AddTagsToVault-requests-elements"></a>

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
<a name="api-AddTagsToVault-responses"></a>

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

### Syntaxe
<a name="api-AddTagsToVault-response-syntax"></a>

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

### En-têtes de réponse
<a name="api-AddTagsToVault-responses-headers"></a>

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](api-common-response-headers.md).

### Corps de la réponse
<a name="api-AddTagsToVault-responses-elements"></a>

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

### Erreurs
<a name="api-AddTagsToVault-responses-errors"></a>

Pour plus d'informations sur les exceptions et les messages d'erreur d'Amazon Glacier, consultez[Réponses d’erreur](api-error-responses.md).

## Exemples
<a name="api-AddTagsToVault-examples"></a>

### Exemple de requête
<a name="api-AddTagsToVault-example-request"></a>

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

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

### Exemple de réponse
<a name="api-AddTagsToVault-example-response"></a>

Si la demande est acceptée, Amazon Glacier renvoie un`HTTP 204 No Content`, comme indiqué dans l'exemple suivant.

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

## Sections connexes
<a name="related-sections-AddTagsToVault"></a>

 
+ [Affichage des balises d'un coffre (GET tags)](api-ListTagsForVault.md)

 
+ [Suppression des balises d'un coffre (POST tags remove)](api-RemoveTagsFromVault.md)

## consultez aussi
<a name="api-AddTagsToVault-SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages Amazon spécifiques SDKs, consultez ce qui suit :
+  [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/add-tags-to-vault.html)