Questa pagina è riservata ai clienti esistenti del servizio S3 Glacier che utilizzano Vaults e l'originale del 2012. REST API
Se stai cercando soluzioni di archiviazione, ti consigliamo di utilizzare le classi di storage S3 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 S3 Glacier e lo storage dei dati a lungo termine con le classi
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 S3 Glacier (S3 Glacier) restituisce l'ID archivio nell'intestazione x-amz-archive-id
della risposta. Salva questo ID archivio per poter accedere all'archivio in seguito.
Devi fornire una struttura hash SHA256 dei dati che stai caricando. Per informazioni sul calcolo di una struttura hash SHA256, consulta Calcolo di checksum.
Nota
La struttura hash SHA256 è richiesta solo per l'azione Upload Archive (archivio POST) quando si utilizza l'API. Non è necessaria quando si utilizza la AWS CLI.
Quando carichi un archivio, puoi eventualmente specificare una descrizione che può contenere fino a 1.024 caratteri ASCII stampabili. S3 Glacier restituisce la descrizione dell'archivio quando recuperi l'archivio o ottieni l'inventario vault. S3 Glacier non interpreta la descrizione in alcun modo. 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 di archivio facoltativa, S3 Glacier non supporta altri metadati 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 Utilizzo degli archivi in Amazon S3 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 (struttura hash SHA256) ed eventualmente una descrizione dell'archivio.
Sintassi
POST /
AccountId
/vaults/VaultName
/archives Host: glacier.Region
.amazonaws.com x-amz-glacier-version: 2012-06-01 Date:Date
Authorization:SignatureValue
x-amz-archive-description:Description
x-amz-sha256-tree-hash:SHA256 tree hash
x-amz-content-sha256:SHA256 linear hash
Content-Length:Length
<Request body.>
Nota
Il valore AccountId
è l'ID dell'Account AWS dell'account proprietario del vault. Puoi specificare l'ID dell'Account AWS o eventualmente un "-
" (trattino), nel qual caso Amazon S3 Glacier utilizza l'ID dell'Account AWS 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 | Obbligatorio |
---|---|---|
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 (offerte di POST lavoro)), l'inventario include questa descrizione per ogni archivio che restituisce nella risposta. Tipo: string 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 checksum SHA256 (un hash lineare) del payload. Non si tratta dello stesso valore che specifichi nell'intestazione Tipo: string Impostazione predefinita: nessuna Vincoli: nessuno |
Sì |
x-amz-sha256-tree-hash
|
Il checksum del payload calcolato dall'utente, ovvero una struttura hash SHA256. Per informazioni sul calcolo della struttura hash SHA256, consulta Calcolo di checksum. Se il checksum del payload calcolato da S3 Glacier è differente, la richiesta viene respinta. Tipo: string Impostazione predefinita: nessuna Vincoli: nessuno |
Sì |
Corpo della richiesta
Il corpo della richiesta contiene i dati da caricare.
Risposte
In risposta, S3 Glacier conserva in modo durevole l'archivio e restituisce un percorso URI all'ID 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: string |
x-amz-archive-id
|
L'ID dell'archivio. Questo valore è incluso anche nell'intestazione Tipo: string |
x-amz-sha256-tree-hash |
Il checksum dell'archivio calcolato da S3 Glacier. Tipo: string |
Corpo della risposta
Questa operazione non restituisce un corpo della risposta.
Errori
Per informazioni sulle eccezioni e i messaggi di errore di Amazon S3 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 che segue include un'intestazione Location
indicante l'ID che S3 Glacier ha assegnato 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