**Questa pagina è riservata ai clienti esistenti del servizio Amazon Glacier che utilizzano Vaults e l'API REST originale del 2012.**
Se stai cercando soluzioni di archiviazione, ti consigliamo di utilizzare le classi di storage Amazon Glacier in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Per ulteriori informazioni su queste opzioni di storage, consulta le classi di storage di [Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).
Amazon Glacier (servizio autonomo originale basato su vault) non accetta più nuovi clienti. Amazon Glacier è un servizio APIs autonomo che archivia i dati in vault ed è distinto dalle classi di storage Amazon S3 e Amazon S3 Glacier. I dati esistenti rimarranno sicuri e accessibili in Amazon Glacier a tempo indeterminato. Non è richiesta alcuna migrazione. Per uno storage di archiviazione a lungo termine a basso costo, AWS consiglia le classi di storage [Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), che offrono un'esperienza cliente superiore con disponibilità Regione AWS completa, costi inferiori e integrazione dei servizi APIs basata su bucket S3. AWS Se desideri funzionalità avanzate, prendi in considerazione la migrazione alle classi di storage Amazon S3 Glacier utilizzando la [AWS nostra Solutions Guidance per il trasferimento di dati dai vault Amazon Glacier alle classi di storage Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Add Tags To Vault (POST tags add)
Questa operazione aggiunge i tag specificati a un vault. Ogni tag consiste di una chiave e un valore. Ogni vault può avere fino a 50 tag. Se la tua richiesta comporta il superamento del limite di tag per il vault, l'operazione genera l'errore `LimitExceededException`.
Se un tag con una chiave specificata è già presente nel vault, il valore di chiave esistente verrà sovrascritto. Per ulteriori informazioni sui tag, consulta [Etichettare le risorse di Amazon Glacier](tagging.md).
## Sintassi della richiesta
Per aggiungere tag a un vault, invia una richiesta HTTP POST all'URI dei tag come illustrato nell'esempio di sintassi seguente.
```
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. }
```
**Nota**
Il `AccountId` valore è l' Account AWS ID. Questo valore deve corrispondere all' Account AWS ID associato alle credenziali utilizzate per firmare la richiesta. Puoi specificare un Account AWS ID o, facoltativamente, un singolo '`-`' (trattino), nel qual caso Amazon Glacier utilizza Account AWS l'ID associato alle credenziali utilizzate per firmare la richiesta. Se specifichi l'ID del tuo account, non devi includere trattini ("-") nell'ID.
## Parametri della richiesta
| Nome | Descrizione | Richiesto |
| --- | --- | --- |
| operation=add | Un singolo parametro di stringa di query `operation` con un valore `add` per differenziarlo da [Remove Tags From Vault (POST tags remove)](api-RemoveTagsFromVault.md). | Sì |
### Intestazioni di richiesta
Questa operazione utilizza solo le intestazioni richiesta che sono comuni a tutte le operazioni. Per informazioni sulle intestazioni richiesta comuni, consulta [Intestazioni di richiesta comuni](api-common-request-headers.md).
### Corpo della richiesta
Il corpo della richiesta contiene i campi JSON descritti di seguito.
**Tags**
I tag da aggiungere al vault. Ogni tag consiste di una chiave e un valore. Il valore può essere una stringa vuota.
*Tipo:* mappatura stringa a stringa
*Vincoli della lunghezza*: lunghezza minima 1. Lunghezza massima 10.
*Campo obbligatorio*: sì
## Risposte
Se la richiesta riesce, il servizio restituisce una risposta HTTP `204 No Content`.
### Sintassi
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### Intestazioni di risposta
Questa operazione utilizza solo le intestazioni di risposta che sono comuni alla maggior parte delle risposte. Per informazioni sulle intestazioni di risposta comuni, consulta [Intestazioni di risposta comuni](api-common-response-headers.md).
### Corpo della risposta
Questa operazione non restituisce un corpo della risposta.
### Errori
Per informazioni sulle eccezioni e sui messaggi di errore di Amazon Glacier, consulta. [Risposte agli errori](api-error-responses.md)
## Esempi
### Richiesta di esempio
L'esempio seguente invia una richiesta HTTP POST con i tag da aggiungere al vault.
```
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. }
```
### Risposta di esempio
Se la richiesta ha avuto esito positivo, Amazon Glacier restituisce `HTTP 204 No Content` un come illustrato nell'esempio seguente.
```
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
```
## Sezioni correlate
+ [List Tags For Vault (GET tags)](api-ListTagsForVault.md)
+ [Remove Tags From Vault (POST tags remove)](api-RemoveTagsFromVault.md)
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue SDKs Amazon specifiche per lingua, consulta quanto segue:
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/add-tags-to-vault.html)