**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à. # Get Job Output (GET output) ## Description Questa operazione scarica l'output del processo avviato utilizzando [Initiate Job (POST jobs)](api-initiate-job-post.md). A seconda del tipo di processo specificato all'avvio del processo, l'output sarà il contenuto di un archivio o di un inventario vault. Puoi scaricare tutto l'output del processo o soltanto una parte specificando un intervallo di byte. Per i processi di recupero di archivio e di inventario, devi confrontare la dimensione scaricata e quella restituita nelle intestazioni della risposta **Get Job Output**. Per i processi di recupero di archivio, devi inoltre verificare che la dimensione sia quella prevista. Se scarichi una parte dell'output, la dimensione prevista è basata sull'intervallo di byte specificato. Ad esempio, se specifichi un intervallo `bytes=0-1048575`, la dimensione del download deve essere 1.048.576 byte. Se scarichi un intero archivio, la dimensione prevista è la dimensione dell'archivio quando lo hai caricato su Amazon Glacier (Amazon Glacier). La dimensione prevista è inoltre restituita nelle intestazioni dalla risposta **Get Job Output**. Nel caso di un processo di recupero dell'archivio, a seconda dell'intervallo di byte specificato, Amazon Glacier restituisce il checksum per la parte di dati. Per assicurarti che la parte scaricata sia quella corretta, calcola il checksum sul client, verifica che i valori corrispondano e che la dimensione sia quella prevista. L'ID del lavoro non scade per almeno 24 ore dopo il completamento del lavoro da parte di Amazon Glacier. In altre parole, puoi scaricare l'output del lavoro entro 24 ore dal completamento del processo da parte di Amazon Glacier. ## Richieste ### Sintassi Per recuperare un processo di output, invii la richiesta HTTP `GET` all'URI dell'`output` del processo. ``` 1. GET /AccountId/vaults/VaultName/jobs/JobID/output HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. Range: ByteRangeToRetrieve 6. 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 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](api-common-request-headers.md). | Nome | Description | Richiesto | | --- | --- | --- | | Range | L'intervallo di byte da recuperare dall'output. Ad esempio, se desideri scaricare i primi 1.048.576 byte, specifica l'intervallo `bytes=0-1048575`. Per ulteriori informazioni, consulta la sezione relativa alla [definizione del campo dell'intestazione Range](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35). L'intervallo è relativo a qualsiasi intervallo specificato nella richiesta Initiate Job. Per impostazione predefinita, questa operazione scarica l'intero output. Se l'output del processo è di grandi dimensioni, puoi utilizzare l'intestazione della richiesta `Range` per recuperare una parte dell'output. Ciò ti consente di scaricare l'intero output in blocchi di byte più piccoli. Ad esempio, supponi di avere un output di processo di 1 GB e che decidi di scaricarlo in blocchi di 128 MB di dati mediante otto richieste Get Job Output. Per scaricare l'output, devi procedere come segue: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/amazonglacier/latest/dev/api-job-output-get.html) Tipo: String Impostazione predefinita: nessuna Vincoli: nessuno | No | ### Corpo della richiesta Questa operazione non ha un corpo della richiesta. ## Risposte ### Sintassi Per una richiesta di recupero che restituisce tutti i dati del processo, la risposta del relativo output restituisce un codice di risposta `200 OK`. Quando viene richiesto un contenuto parziale, ad esempio, se hai specificato l'intestazione `Range` nella richiesta, viene restituito il codice di risposta `206 Partial Content`. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Content-Type: ContentType 5. Content-Length: Length 6. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier 7. 8. [Body containing job output.] ``` ### Intestazioni di risposta | Header | Description | | --- | --- | | Content-Range | L'intervallo di byte restituito da Amazon Glacier. Se viene scaricato solo un output parziale, la risposta fornisce l'intervallo di byte restituito da Amazon Glacier. Ad esempio, `bytes 0-1048575/8388608` restituisce il primo blocco da 1 MB di 8 MB. Per ulteriori informazioni sull'intestazione `Content-Range`, consulta la pagina relativa alla [definizione del campo dell'intestazione Content-Range](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16). Tipo: String | | Content-Type | Content-Type varia a seconda se l'output del processo è un archivio o un inventario vault. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/amazonglacier/latest/dev/api-job-output-get.html) Tipo: String | | x-amz-sha256-tree-hash​ | Il checksum dei dati nella risposta. Questa intestazione viene restituita solo per il recupero dell'output di un processo di recupero di archivio. Viene inoltre visualizzata quando l'intervallo di dati richiesto in Initiate Job è allineato alla struttura hash e l'intervallo da scaricare richiesto nelle richiesta Get Job Output è anch'esso allineato alla struttura hash. Per ulteriori informazioni sugli intervalli allineati alla struttura hash, vedi [Ottenimento di checksum durante il download di dati](checksum-calculations-range.md). Ad esempio, se nella richiesta Initiate Job hai specificato un intervallo da recuperare che è allineato alla struttura hash (include l'intero archivio), riceverai il checksum dei dati che scarichi quando: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/amazonglacier/latest/dev/api-job-output-get.html) Tipo: String | ### Corpo della risposta Amazon Glacier restituisce l'output del lavoro nel corpo della risposta. A seconda del tipo di processo, l'output può essere il contenuto dell'archivio o l'inventario vault. Nel caso di un inventario vault, per impostazione predefinita l'elenco viene restituito come corpo JSON, come mostrato di seguito. ``` 1. { 2. "VaultARN": String, 3. "InventoryDate": String, 4. "ArchiveList": [ 5. {"ArchiveId": String, 6. "ArchiveDescription": String, 7. "CreationDate": String, 8. "Size": Number, 9. "SHA256TreeHash": String 10. }, 11. ... 12. ] 13. } ``` Se hai richiesto l'output in formato CSV all'avvio del processo di inventario vault, l'inventario vault viene restituito in formato CSV nel corpo della risposta. Il formato CSV ha cinque colonne "ArchiveId«," ArchiveDescription «," CreationDate «, «Size» e "SHA256TreeHash" con le stesse definizioni dei campi JSON corrispondenti. **Nota** Nel formato CSV restituito, i campi possono essere restituiti racchiusi tra virgolette. I campi che contengono una virgola o virgolette vengono sempre restituiti racchiusi tra virgolette. Ad esempio, `my archive description,1` viene restituito come `"my archive description,1"`. Le virgolette presenti nei campi restituiti tra virgolette sono *precedute da un carattere di escape*, ovvero una barra rovesciata. Ad esempio, `my archive description,1"2` viene restituito come `"my archive description,1\"2"` e `my archive description,1\"2` viene restituito come `"my archive description,1\\"2"`. La barra rovesciata non è preceduta da un carattere di escape. Il corpo della risposta JSON contiene i campi JSON descritti di seguito. **ArchiveDescription** La descrizione di un archivio. ▬*Tipo:* stringa **ArchiveId** L'ID di un archivio. ▬*Tipo:* stringa **ArchiveList** Una matrice di metadati dell'archivio. Ogni oggetto nella matrice rappresenta metadati per un archivio contenuto nel vault. *Tipo*: matrice **CreationDate** La data e l'ora di creazione dell'archivio in formato UTC. *Tipo*: una rappresentazione di stringa nel formato data ISO 8601, ad esempio `2013-03-20T17:03:43.221Z`. **InventoryDate** La data e l'ora in formato UTC dell'ultimo inventario del vault completato dopo le modifiche al vault. Anche se Amazon Glacier prepara un inventario del vault una volta al giorno, la data dell'inventario viene aggiornata solo se sono state aggiunte o eliminate dall'archivio dopo l'ultimo inventario. *Tipo*: una rappresentazione di stringa nel formato data ISO 8601, ad esempio `2013-03-20T17:03:43.221Z`. **SHA256TreeHash** La struttura hash dell'archivio. ▬*Tipo:* stringa **Dimensioni** La dimensione in byte dell'archivio. *Tipo*: numero **VaultARN** La risorsa ARN (Amazon Resource Name) da cui è stato richiesto il recupero dell'archivio. ▬*Tipo:* stringa ### Errori Per informazioni sulle eccezioni e sui messaggi di errore di Amazon Glacier, consulta. [Risposte agli errori](api-error-responses.md) ## Esempi L'esempio seguente mostra la richiesta per un processo che recupera un archivio. ### Esempio 1: download dell'output Questo esempio recupera i dati preparati da Amazon Glacier in risposta alla tua richiesta di lavoro di avvio del recupero dell'archivio. #### Richiesta di esempio ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output 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 Di seguito è riportato un esempio di risposta di un processo di recupero di archivio. Nota che l'intestazione `Content-Type` è `application/octet-stream` e che l'intestazione `x-amz-sha256-tree-hash` è inclusa nella risposta, il che significa che vengono restituiti tutti i dati del processo. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 4. Date: Wed, 10 Feb 2017 12:00:00 GMT 5. Content-Type: application/octet-stream 6. Content-Length: 1048576 7. 8. [Archive data.] ``` Di seguito è riportato un esempio di risposta di un processo di recupero di inventario. Nota che l'intestazione `Content-Type` è `application/json`. Considera inoltre che la risposta non include l'intestazione `x-amz-sha256-tree-hash`. ``` 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: 906 6. 7. { 8. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault", 9. "InventoryDate": "2011-12-12T14:19:01Z", 10. "ArchiveList": [ 11. { 12. "ArchiveId": "DMTmICA2n5Tdqq5BV2z7og-A20xnpAPKt3UXwWxdWsn_D6auTUrW6kwy5Qyj9xd1MCE1mBYvMQ63LWaT8yTMzMaCxB_9VBWrW4Jw4zsvg5kehAPDVKcppUD1X7b24JukOr4mMAq-oA", 13. "ArchiveDescription": "my archive1", 14. "CreationDate": "2012-05-15T17:19:46.700Z", 15. "Size": 2140123, 16. "SHA256TreeHash": "6b9d4cf8697bd3af6aa1b590a0b27b337da5b18988dbcc619a3e608a554a1e62" 17. }, 18. { 19. "ArchiveId": "2lHzwhKhgF2JHyvCS-ZRuF08IQLuyB4265Hs3AXj9MoAIhz7tbXAvcFeHusgU_hViO1WeCBe0N5lsYYHRyZ7rrmRkNRuYrXUs_sjl2K8ume_7mKO_0i7C-uHE1oHqaW9d37pabXrSA", 20. "ArchiveDescription": "my archive2", 21. "CreationDate": "2012-05-15T17:21:39.339Z", 22. "Size": 2140123, 23. "SHA256TreeHash": "7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3" 24. } 25. ] 26. } ``` ### Esempio 2: download unicamente di un output parziale Questo esempio recupera solo una parte dell'archivio preparato da Amazon Glacier in risposta alla tua richiesta di lavoro di avvio del recupero dell'archivio. La richiesta utilizza l'intestazione facoltativa `Range` per recuperare solo i primi 1.024 byte. #### Richiesta di esempio ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. Range: bytes=0-1023 5. x-amz-glacier-version: 2012-06-01 6. 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 La risposta corretta seguente mostra la risposta `206 Partial Content`. In questo caso, la risposta include anche un'`Content-Range`intestazione che specifica l'intervallo di byte restituito da Amazon Glacier. ``` 1. HTTP/1.1 206 Partial Content 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Range: bytes 0-1023/8388608 5. Content-Type: application/octet-stream 6. Content-Length: 1024 7. 8. [Archive data.] ``` ## Sezioni correlate + [Describe Job (GET JobID)](api-describe-job-get.md) + [Initiate Job (POST jobs)](api-initiate-job-post.md) + [Identity and Access Management per Amazon Glacier](security-iam.md)