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à.
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 S3 Glacier (S3 Glacier) crea una risorsa di caricamento in più parti e restituisce il relativo 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 all'avvio di un caricamento in più parti in quanto S3 Glacier non richiede di specificare la dimensione globale dell'archivio.
Una volta completato il caricamento, S3 Glacier rimuove la risorsa a cui fa riferimento l'ID. S3 Glacier rimuoverà inoltre tale risorsa se annulli il caricamento in più parti o eventualmente se non viene registrata alcuna 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 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 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 | Obbligatorio |
|---|---|---|
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: string 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 (offerte di POST lavoro)), l'inventario include questa descrizione per ogni archivio che restituisce nella risposta. Gli spazi iniziali nelle descrizioni degli archivi vengono rimossi. Tipo: string 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, S3 Glacier crea una risorsa di caricamento in più parti identificata da un ID e restituisce il relativo percorso URI dell'ID di caricamento in più parti.
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 relativo percorso URI dell'ID di caricamento in più parti creato da S3 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: string |
x-amz-multipart-upload-id
|
L'ID del caricamento in più parti. Questo valore è incluso anche nell'intestazione 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.
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
S3 Glacier crea una risorsa di caricamento in più parti 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
