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
Amazon Glacier (servizio autonomo originale basato su vault) non accetterà più nuovi clienti a partire dal 15 dicembre 2025, senza alcun impatto sui clienti esistenti. 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
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
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.
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
POST /AccountId/vaults/VaultName/archives Host: glacier.Region.amazonaws.com x-amz-glacier-version: 2012-06-01 Date:DateAuthorization:SignatureValuex-amz-archive-description:Descriptionx-amz-sha256-tree-hash:SHA256 tree hashx-amz-content-sha256:SHA256 linear hashContent-Length:Length<Request body.>
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.
| 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 #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)), 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 ▬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 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
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier Location: Location 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.
| 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 ▬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
Esempi
Richiesta di esempio
L'esempio seguente mostra una richiesta per il caricamento di un archivio.
POST /-/vaults/examplevault/archives HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 x-amz-content-sha256: 7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3 Content-Length: 2097152 x-amz-glacier-version: 2012-06-01 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 <Request body (2097152 bytes).>
Risposta di esempio
La risposta corretta riportata di seguito presenta un'Locationintestazione in cui è possibile ottenere l'ID assegnato da Amazon Glacier all'archivio.
HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
Sezioni correlate
