**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à.
# Upload Archive (POST archive)
## Descrizione
Questa operazione aggiunge un archivio a un vault. Affinché un caricamento venga eseguito correttamente, i dati sono resi persistenti in modo durevole. In risposta, Amazon Glacier (Amazon Glacier) restituisce l'ID dell'archivio nell'intestazione della risposta. `x-amz-archive-id` Salva questo ID archivio per poter accedere all'archivio in seguito.
Devi fornire un hash ad SHA256 albero dei dati che stai caricando. Per informazioni sul calcolo dell'hash di un SHA256 albero, consulta. [Calcolo di checksum](checksum-calculations.md)
**Nota**
L'hash SHA256 dell'albero è richiesto solo per l'azione Upload Archive (archivio POST) quando si utilizza l'API. Non è necessario quando si utilizza. AWS CLI
Quando carichi un archivio, puoi eventualmente specificare una descrizione che può contenere fino a 1.024 caratteri ASCII stampabili. Amazon Glacier restituisce la descrizione dell'archivio quando recuperi l'archivio o ottieni l'inventario del vault. Amazon Glacier non interpreta in alcun modo la descrizione. Una descrizione di archivio non deve essere univoca e non può essere utilizzata per recuperare o ordinare l'elenco di archivi.
Ad eccezione della descrizione opzionale dell'archivio, Amazon Glacier non supporta metadati aggiuntivi per gli archivi. L'ID archivio è una sequenza di caratteri opaca da cui non è possibile dedurre alcuna informazione relativa all'archivio. Di conseguenza, puoi conservare i metadati sugli archivi sul lato client. Per ulteriori informazioni, consulta [Lavorare con gli archivi in Amazon Glacier](working-with-archives.md).
Gli archivi non sono modificabili. Dopo il caricamento di un archivio, non è possibile modificarne il contenuto o la descrizione.
## Richieste
Per caricare un archivio, utilizzi il metodo HTTP `POST` e definisci l'ambito della richiesta per la sottorisorsa `archives` del vault in cui desideri salvare l'archivio. La richiesta deve includere la dimensione del payload dell'archivio, il checksum (SHA256 tree hash) e può facoltativamente includere una descrizione dell'archivio.
### Sintassi
```
1. POST /AccountId/vaults/VaultName/archives
2. Host: glacier.Region.amazonaws.com
3. x-amz-glacier-version: 2012-06-01
4. Date: Date
5. Authorization: SignatureValue
6. x-amz-archive-description: Description
7. x-amz-sha256-tree-hash: SHA256 tree hash
8. x-amz-content-sha256: SHA256 linear hash
9. Content-Length: Length
10.
11.
```
**Nota**
Il `AccountId` valore è l' Account AWS ID dell'account proprietario del vault. 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 utilizzi un ID account, non includere alcun trattino ("-") nell'ID.
### Parametri della richiesta
Questa implementazione dell'operazione non utilizza parametri di richiesta.
### Intestazioni di richiesta
Questa operazione utilizza le seguenti intestazioni di richiesta, oltre alle intestazioni di richiesta comuni a tutte le operazioni. Per ulteriori informazioni sulle intestazioni richiesta comuni, consulta [Intestazioni di richiesta comuni](api-common-request-headers.md).
| Nome | Descrizione | Richiesto |
| --- | --- | --- |
| Content-Length | La dimensione dell'oggetto in byte. [Per ulteriori informazioni, vai a http://www.w3. org/Protocols/rfc2616/rfc2616-sec14.html \$1sec14 .13.](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13) Tipo: numero Impostazione predefinita: nessuna Vincoli: nessuno | Sì |
| x-amz-archive-description | La descrizione facoltativa dell'archivio che stai caricando. Può trattarsi di una descrizione in linguaggio normale o di un identificatore che scegli di assegnare. La descrizione di archivio non deve essere univoca. Quando recuperi un inventario vault (vedi [Initiate Job (POST jobs)](api-initiate-job-post.md)), l'inventario include questa descrizione per ogni archivio che restituisce nella risposta. ▬Tipo: stringa Impostazione predefinita: nessuna Vincoli: la descrizione non deve contenere più di 1.024 caratteri. I caratteri consentiti sono caratteri ASCII a 7 bit senza codici di controllo, in particolare valori ASCII da 32 a 126 in decimale o da 0x20 a 0x7E in esadecimale. | No |
| x-amz-content-sha256 | Il SHA256 checksum (un hash lineare) del payload. Non si tratta dello stesso valore che specifichi nell'intestazione `x-amz-sha256-tree-hash`. ▬Tipo: stringa Impostazione predefinita: nessuna Vincoli: nessuno | Sì |
| x-amz-sha256-tree-hash | Il checksum, l'hash dell' SHA256 albero, calcolato dall'utente del payload. Per informazioni sul calcolo dell'hash dell' SHA256 albero, vedere. [Calcolo di checksum](checksum-calculations.md) Se Amazon Glacier calcola un checksum diverso del payload, rifiuterà la richiesta. ▬Tipo: stringa Impostazione predefinita: nessuna Vincoli: nessuno | Sì |
### Corpo della richiesta
Il corpo della richiesta contiene i dati da caricare.
## Risposte
In risposta, Amazon Glacier archivia l'archivio in modo duraturo e restituisce un percorso URI all'ID dell'archivio.
### Sintassi
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier
5. Location: Location
6. x-amz-archive-id: ArchiveId
```
### Intestazioni di risposta
Una risposta corretta include le seguenti intestazioni di risposta, oltre alle intestazioni di risposta comuni a tutte le operazioni. Per informazioni sulle intestazioni di risposta comuni, consulta [Intestazioni di risposta comuni](api-common-response-headers.md).
| Nome | Descrizione |
| --- | --- |
| Location | Il percorso URI relativo della risorsa di archivio aggiunta. ▬Tipo: stringa |
| x-amz-archive-id | L'ID dell'archivio. Questo valore è incluso anche nell'intestazione `Location`. ▬Tipo: stringa |
| x-amz-sha256-tree-hash | Il checksum dell'archivio calcolato da Amazon Glacier. ▬Tipo: stringa |
### 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 mostra una richiesta per il caricamento di un archivio.
```
1. POST /-/vaults/examplevault/archives HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
5. x-amz-content-sha256: 7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3
6. Content-Length: 2097152
7. x-amz-glacier-version: 2012-06-01
8. Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace
9.
10.
```
### Risposta di esempio
La risposta corretta riportata di seguito presenta un'`Location`intestazione in cui è possibile ottenere l'ID assegnato da Amazon Glacier all'archivio.
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
5. Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
6. x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
```
## Sezioni correlate
+ [Lavorare con gli archivi in Amazon Glacier](working-with-archives.md)
+ [Caricamento in parti di archivi di grandi dimensioni (caricamento in più parti)](uploading-archive-mpu.md)
+ [Delete Archive (DELETE archive)](api-archive-delete.md)
+ [Identity and Access Management per Amazon Glacier](security-iam.md)