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à.
Initiate Multipart Upload (POST multipart-uploads)
Descrizione
Questa operazione avvia una caricamento in più parti (consulta Caricamento in parti di archivi di grandi dimensioni (caricamento in più parti)). Amazon Glacier (Amazon Glacier) crea una risorsa di caricamento multiparte e ne restituisce l'ID nella risposta. Questo ID può essere utilizzato nelle operazioni di caricamento in più parti successive.
Quando avvii un caricamento in più parti, specifichi la dimensione di parte in byte. La dimensione della parte deve essere un mebibyte (MiB) (1024 kibibyte [KiB]) moltiplicato per una potenza di 2, ad esempio 1048576 (1 MiB), 2097152 (2 MiB), 4194304 (4 MiB), 8388608 (8 MiB) e così via. La dimensione di parte minima autorizzata è 1 MiB, mentre quella massima è 4 gibibyte (GiB).
Ogni parte che carichi utilizzando questo ID di caricamento, tranne l'ultima, deve avere la stessa dimensione. L'ultimo parte può avere la stessa dimensione o una dimensione inferiore. Ad esempio, supponi di voler caricare un file di 16,2 MiB. Se avvii il caricamento in più parti con una dimensione di parte di 4 MiB, caricherai quattro parti di 4 MiB ciascuna e una parte di 0,2 MiB.
Nota
Non è necessario conoscere la dimensione dell'archivio quando si avvia un caricamento in più parti, poiché Amazon Glacier non richiede di specificare la dimensione complessiva dell'archivio.
Dopo aver completato il caricamento multiparte, Amazon Glacier rimuove la risorsa di caricamento multiparte a cui fa riferimento l'ID. Amazon Glacier rimuoverà anche la risorsa di caricamento multiparte se annulli il caricamento multiparte o potrebbe essere rimossa se non c'è attività per un periodo di 24 ore. È possibile che l'ID sia ancora disponibile dopo 24 ore, ma è consigliabile non affidarsi a questa eventualità.
Richieste
Per avviare un caricamento in più parti, devi inviare una richiesta HTTP POST all'URI della sottorisorsa multipart-uploads del vault in cui desideri salvare l'archivio. La richiesta deve includere la dimensione di parte ed eventualmente una descrizione dell'archivio.
Sintassi
POST /AccountId/vaults/VaultName/multipart-uploads Host: glacier.us-west-2.amazonaws.com Date:DateAuthorization:SignatureValuex-amz-glacier-version: 2012-06-01 x-amz-archive-description:ArchiveDescriptionx-amz-part-size:PartSize
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 operazione non utilizza parametri 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 |
|---|---|---|
x-amz-part-size
|
La dimensione in byte di ogni parte eccetto l'ultima. La dimensione dell'ultima parte può essere inferiore a questa dimensione. ▬Tipo: stringa Impostazione predefinita: nessuna Vincoli: la dimensione della parte deve essere un mebibyte (1024 KiB) moltiplicato per una potenza di 2, ad esempio 1048576 (1 MiB), 2097152 (2 MiB), 4194304 (4 MiB), 8388608 (8 MiB) e così via. La dimensione di parte minima autorizzata è 1 MiB, mentre quella massima è 4 gibibyte (4096 MiB). |
Sì |
x-amz-archive-description
|
La descrizione dell'archivio di cui stai eseguendo il caricamento in parti. Può essere una descrizione in linguaggio normale o un identificatore univoco che scegli di assegnare. Quando recuperi un inventario vault (vedi Initiate Job (POST jobs)), l'inventario include questa descrizione per ogni archivio che restituisce nella risposta. Gli spazi iniziali nelle descrizioni degli archivi vengono rimossi. ▬Tipo: stringa Impostazione predefinita: nessuna Vincoli: la descrizione deve essere minore o uguale a 1024 byte. 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 |
Corpo della richiesta
Questa operazione non ha un corpo della richiesta.
Risposte
Nella risposta, Amazon Glacier crea una risorsa di caricamento multiparte identificata da un ID e restituisce il percorso URI relativo dell'ID di caricamento multiparte.
Sintassi
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date Location: Location x-amz-multipart-upload-id: multiPartUploadId
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 dell'ID di caricamento multiparte creato da Amazon Glacier. Questo percorso URI viene utilizzato per definire l'ambito delle tue richieste di caricamento di parti e per completare il caricamento in più parti. ▬Tipo: stringa |
x-amz-multipart-upload-id
|
L'ID del caricamento in più parti. Questo valore è incluso anche nell'intestazione ▬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
Esempio
Richiesta di esempio
L'esempio seguente avvia un caricamento in più parti inviando una richiesta HTTP POST all'URI della sottorisorsa multipart-uploads di un vault denominato examplevault. La richiesta include intestazioni che consentono di specificare una dimensione di parte di 4 MiB (4194304 byte) e la descrizione facoltativa dell'archivio.
POST /-/vaults/examplevault/multipart-uploads Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-archive-description: MyArchive-101 x-amz-part-size: 4194304 x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
Risposta di esempio
Amazon Glacier crea una risorsa di caricamento multiparte e la aggiunge alla sottorisorsa multipart-uploads del vault. L'intestazione di risposta Location include il percorso URI relativo all'ID di caricamento in più parti.
HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Location: /111122223333/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE x-amz-multipart-upload-id: OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
Per ulteriori informazioni sul caricamento di singole parti, consulta Upload Part (PUT uploadID).
Sezioni correlate
