**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à. # List Parts (GET uploadID) ## Description Questa operazione di caricamento in più parti elenca le parti di un archivio che sono state caricate mediante un determinato caricamento in più parti identificato da un ID di caricamento. Per informazioni sul caricamento in più parti, consulta [Caricamento in parti di archivi di grandi dimensioni (caricamento in più parti)](uploading-archive-mpu.md). Puoi effettuare questa richiesta in qualsiasi momento durante un caricamento in più parti prima che venga completato. Amazon Glacier restituisce l'elenco di parti ordinato per intervallo specificato in ogni caricamento di parte. Se invii una richiesta List Parts dopo aver completato il caricamento multiparte, Amazon Glacier (Amazon Glacier) restituisce un errore. L'operazione List Parts supporta la paginazione. Devi sempre verificare se il campo `Marker` nel corpo della risposta include un contrassegno che segnala il punto dal quale continuare l'elenco. Se non vi sono altri elementi, il campo `marker` è `null`. Se non `marker` è nullo, per recuperare il prossimo set di parti hai inviato un'altra richiesta List Parts con il parametro `marker` request impostato sul valore marker restituito da Amazon Glacier in risposta alla tua precedente richiesta List Parts. Puoi inoltre limitare il numero di parti restituite nella risposta specificando il parametro `limit` nella richiesta. ## Richieste ### Sintassi Per elencare le parti di un caricamento in più parti in corso, devi inviare una richiesta `GET` all'URI della risorsa ID di caricamento in più parti. L'ID di caricamento in più parti viene restituito quando avvii un caricamento in più parti ([Initiate Multipart Upload (POST multipart-uploads)](api-multipart-initiate-upload.md)). Puoi eventualmente specificare i parametri `marker` e `limit`. ``` 1. GET /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. x-amz-glacier-version: 2012-06-01 ``` **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 | Nome | Description | Richiesto | | --- | --- | --- | | limit | Il numero massimo di parti da restituire. Il limite di default è 50. Il numero di parti restituite può essere inferiore al limite specificato, ma mai superiore. Tipo: String Vincoli: il valore intero minimo è `1`. Il valore intero massimo è `50`. | No | | marker | Una stringa opaca utilizzata per la paginazione. Il parametro `marker` specifica la parte da cui deve cominciare l'elenco di parti. Ottieni il valore `marker` da una risposta List Parts precedente. Devi includere `marker` solo se continui la paginazione dei risultati iniziata in una richiesta List Parts precedente. Tipo: String Vincoli: nessuno | No | ### Intestazioni di richiesta Questa operazione utilizza solo le intestazioni di risposta che sono comuni alla maggior parte delle risposte. Per informazioni sulle intestazioni di risposta comuni, consulta [Intestazioni di risposta comuni](api-common-response-headers.md). ### Corpo della richiesta Questa operazione non ha un corpo della richiesta. ## Risposte ### Sintassi ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Content-Type: application/json 5. Content-Length: Length 6. 7. { 8. "ArchiveDescription" : String, 9. "CreationDate" : String, 10. "Marker": String, 11. "MultipartUploadId" : String, 12. "PartSizeInBytes" : Number, 13. "Parts" : 14. [ { 15. "RangeInBytes" : String, 16. "SHA256TreeHash" : String 17. }, 18. ... 19. ], 20. "VaultARN" : String 21. } ``` ### Intestazioni di risposta Questa operazione utilizza solo le intestazioni di risposta che sono comuni alla maggior parte delle risposte. Per informazioni sulle intestazioni di risposta comuni, consulta [Intestazioni di risposta comuni](api-common-response-headers.md). ### Corpo della risposta Il corpo della risposta contiene i campi JSON descritti di seguito. **ArchiveDescription** La descrizione dell'archivio specificata nella richiesta Initiate Multipart Upload. Questo campo è `null` se la descrizione dell'archivio non è stata specificata nell'operazione Initiate Multipart Upload. ▬*Tipo:* stringa **CreationDate** La data e l'ora in formato UTC in cui il caricamento in più parti è stato avviato. *Tipo:* stringa. Una rappresentazione di stringa nel formato di data ISO 8601, ad esempio `2013-03-20T17:03:43.221Z`. **Marker** Una stringa opaca che rappresenta il punto da cui continuare la paginazione dei risultati. Utilizza l'elenco `marker` in una nuova richiesta List Parts per ottenere ulteriori processi nell'elenco. Se non vi sono altre parti, questo valore è `null`. ▬*Tipo:* stringa **MultipartUploadId** L'ID del caricamento a cui sono associate le parti. ▬*Tipo:* stringa **PartSizeInBytes** La dimensione di parte in byte. Si tratta dello stesso valore specificato nella richiesta Initiate Multipart Upload. *Tipo*: numero **Parti** Un elenco di dimensioni di parte del caricamento in più parti. Ogni oggetto nella matrice contiene una coppia nome/valore `RangeBytes` e `sha256-tree-hash`. *Tipo*: matrice **RangeInBytes** L'intervallo di byte di una parte, compreso il valore superiore dell'intervallo. ▬*Tipo:* stringa **SHA256TreeHash** Il valore hash SHA256 dell'albero calcolato da Amazon Glacier per la parte. Questo campo non è mai `null`. ▬*Tipo:* stringa **VaultARN** L'ARN (Amazon Resource Name) del vault in cui è stato avviato il caricamento in più parti. ▬*Tipo:* stringa ### Errori Per informazioni sulle eccezioni e sui messaggi di errore di Amazon Glacier, consulta. [Risposte agli errori](api-error-responses.md) ## Esempi ### Esempio: elenco di parti di un caricamento in più parti L'esempio seguente elenca tutte le parti di un caricamento. L'esempio invia una richiesta HTTP `GET` all'URI dell'ID di un caricamento in più parti in corso e restituisce fino a 1.000 parti. #### Richiesta di esempio ``` 1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. 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 Nella risposta, Amazon Glacier restituisce un elenco di parti caricate associate all'ID di caricamento multiparte specificato. In questo esempio, ci sono solo due parti. Il campo `Marker` restituito è `null` a indicare che non ci sono ulteriori parti del caricamento in più parti. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Type: application/json 5. Content-Length: 412 6. 7. { 8. "ArchiveDescription" : "archive description", 9. "CreationDate" : "2012-03-20T17:03:43.221Z", 10. "Marker": null, 11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE", 12. "PartSizeInBytes" : 4194304, 13. "Parts" : 14. [ { 15. "RangeInBytes" : "0-4194303", 16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4" 17. }, 18. { 19. "RangeInBytes" : "4194304-8388607", 20. "SHA256TreeHash" : "0195875365afda349fc21c84c099987164" 21. }], 22. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault" 23. } ``` ### Esempio: elenco di parti di un caricamento in più parti (specificare i parametri di richiesta di contrassegno e limite) L'esempio seguente mostra come utilizzare la paginazione per ottenere un numero limitato di risultati. L'esempio invia una richiesta HTTP `GET` all'URI dell'ID di un caricamento in più parti in corso per restituire una parte. Un parametro `marker` iniziale specifica la parte da cui cominciare l'elenco. Puoi ottenere il valore `marker` da una risposta di una richiesta precedente per un elenco di parti. Inoltre, in questo esempio, il parametro `limit` è impostato su 1 e restituisce una parte. Nota che il campo `Marker` non è `null`, a indicare che è presente almeno un'altra parte da ottenere. #### Richiesta di esempio ``` 1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. 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 Nella risposta, Amazon Glacier restituisce un elenco di parti caricate associate all'ID di caricamento multiparte in corso specificato. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Type: text/json 5. Content-Length: 412 6. 7. { 8. "ArchiveDescription" : "archive description 1", 9. "CreationDate" : "2012-03-20T17:03:43.221Z", 10. "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ", 11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE", 12. "PartSizeInBytes" : 4194304, 13. "Parts" : 14. [ { 15. "RangeInBytes" : "4194304-8388607", 16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4" 17. }], 18. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault" 19. } ``` ## Sezioni correlate + [Initiate Multipart Upload (POST multipart-uploads)](api-multipart-initiate-upload.md) + [Upload Part (PUT uploadID)](api-upload-part.md) + [Complete Multipart Upload (POST uploadID)](api-multipart-complete-upload.md) + [Abort Multipart Upload (DELETE uploadID)](api-multipart-abort-upload.md) + [List Multipart Uploads (GET multipart-uploads)](api-multipart-list-uploads.md) + [Caricamento in parti di archivi di grandi dimensioni (caricamento in più parti)](uploading-archive-mpu.md) + [Identity and Access Management per Amazon Glacier](security-iam.md)