**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à. # Initiate Job (POST jobs) Questa operazione avvia i seguenti tipi di processi Amazon Glacier (Amazon Glacier): + `archive-retrieval`: recupero di un archivio + `inventory-retrieval`: inventario di una vault **Topics** + [Avvio di un processo di recupero di un archivio o di un inventario vault](#api-initiate-job-post-description) + [Richieste](#api-initiate-job-post-requests) + [Risposte](#api-initiate-job-post-responses) + [Esempi](#api-initiate-job-post-examples) + [Sezioni correlate](#more-info-api-initiate-job-post) ## Avvio di un processo di recupero di un archivio o di un inventario vault Il recupero di un archivio o di un inventario vault è un'operazione asincrona che richiede l'avvio di un processo. Una volta avviato, il processo non può essere annullato. Un processo di recupero comporta due fasi: 1. Avvio di un processo di recupero mediante l'operazione [Initiate Job (POST jobs)](#api-initiate-job-post). **Importante** L'utilizzo di una policy di recupero dati può causare un errore nella richiesta di avvio di un processo di recupero e generare l'eccezione `PolicyEnforcedException`. Per ulteriori informazioni sulle policy di recupero dati, consulta [Politiche di recupero dei dati di Amazon Glacier](data-retrieval-policy.md). Per ulteriori informazioni sull'eccezione `PolicyEnforcedException`, consulta [Risposte agli errori](api-error-responses.md). 1. Download dei byte mediante l'operazione [Get Job Output (GET output)](api-job-output-get.md) dopo il completamento del processo. La richiesta di recupero viene eseguita in modo asincrono. Quando si avvia un processo di recupero, Amazon Glacier crea un processo e restituisce un ID di processo nella risposta. Quando Amazon Glacier completa il lavoro, puoi ottenere l'output del lavoro (dati di archivio o di inventario). Per informazioni su come ottenere l'output di un processo, consulta la sezione sull'operazione [Get Job Output (GET output)](api-job-output-get.md). Per ottenere l'output di un processo, è necessario che il processo sia stato completato. Per determinare se un processo è completato, disponi delle seguenti opzioni: + **Usa una notifica Amazon SNS:** puoi specificare un argomento Amazon SNS su cui Amazon Glacier può pubblicare una notifica dopo il completamento del processo. Puoi specificare un argomento di SNS per ogni richiesta di processo. La notifica viene inviata solo dopo che Amazon Glacier ha completato il processo. Oltre a specificare un argomento di SNS per ogni richiesta di processo, puoi configurare notifiche per un vault di modo che siano inviate per tutte le operazioni di recupero. Per ulteriori informazioni, consulta [Set Vault Notification Configuration (PUT notification-configuration)](api-vault-notifications-put.md). + **Ottenere dettagli sul processo:** puoi effettuare una richiesta [Describe Job (GET JobID)](api-describe-job-get.md) per ottenere informazioni sullo stato del processo durante la sua esecuzione. È comunque consigliato utilizzare un notifica di Amazon SNS per stabilire se un processo è completato. **Nota** Le informazioni che ottieni tramite le notifiche sono le stesse che ottieni chiamando [Describe Job (GET JobID)](api-describe-job-get.md). Se per un evento specifico, aggiungi sia la configurazione delle notifiche sul vault sia specifichi anche un argomento SNS nella richiesta di avvio del lavoro, Amazon Glacier invia entrambe le notifiche. Per ulteriori informazioni, consulta [Set Vault Notification Configuration (PUT notification-configuration)](api-vault-notifications-put.md). ### Inventario vault Amazon Glacier aggiorna un inventario del vault circa una volta al giorno, a partire dal giorno in cui carichi per la prima volta un archivio nel vault. Se nessun archivio è stato aggiunto o eliminato nel vault dall'ultimo inventario, la data dell'inventario non viene aggiornata. Quando avvii un processo per un inventario del vault, Amazon Glacier restituisce l'ultimo inventario generato, che è point-in-time uno snapshot e non dati in tempo reale. Dopo che Amazon Glacier ha creato il primo inventario per il vault, in genere occorre mezza giornata e fino a un giorno prima che l'inventario sia disponibile per il recupero. A prima vista, recuperare un inventario vault per ogni caricamento di archivio può non sembrare utile. Tuttavia, supponiamo che tu gestisca un database sul lato client che associ i metadati sugli archivi che carichi su Amazon Glacier. In tal caso, l'inventario vault potrebbe essere utilizzato per risolvere le differenze tra le informazioni nel database e l'inventario vault effettivo. Per ulteriori informazioni sui campi dati restituiti nell'output di un processo di inventario, consulta [Corpo della risposta](api-job-output-get.md#api-job-output-get-responses-elements). ### Recupero di un intervallo di inventario Puoi limitare il numero di elementi di inventario recuperati filtrandoli per data di creazione dell'archivio o impostando un limite. **Filtro in base alla data di creazione dell'archivio** Puoi recuperare elementi di inventario degli archivi creati tra `StartDate` ed `EndDate` specificando i valori di tali parametri nella richiesta **Initiate Job**. In questo modo, vengono restituiti gli archivi creati dopo `StartDate` e prima di `EndDate`. Se indichi solo il valore `StartDate` senza `EndDate`, recuperi l'inventario per tutti gli archivi creati a partire da `StartDate`. Se indichi solo il valore `EndDate` senza `StartDate`, recuperi l'inventario per tutti gli archivi creati prima di `EndDate`. **Limitazione degli elementi di inventario recuperati** Puoi limitare il numero di elementi di inventario restituiti impostando il parametro `Limit` nella richiesta **Initiate Job**. L'output del processo di inventario contiene elementi di inventario fino al valore `Limit` specificato. Se sono disponibili ulteriori elementi di inventario, viene eseguita la paginazione del risultato. Dopo il completamento di un processo, puoi utilizzare l'operazione [Describe Job (GET JobID)](api-describe-job-get.md) per ottenere un contrassegno da utilizzare in una richiesta **Initiate Job** successiva. Il contrassegno indica il punto iniziale per il recupero del set di elementi di inventario successivo. Puoi scorrere l'intero inventario effettuando ripetutamente richieste **Initiate Job** con il contrassegno dell'output della richiesta **Describe Job** precedente. Procedi in questo modo fino a ottenere un contrassegno da **Describe Job** che restituisce null, a indicare che non ci sono altri elementi di inventario disponibili. Puoi utilizzare il parametro `Limit` con i parametri relativi agli intervalli di date. ### Recupero di un intervallo di archivio Puoi avviare il recupero di un intero archivio oppure di un intervallo dell'archivio. Per il recupero di un intervallo di archivio, devi specificare un intervallo di byte da restituire o l'intero archivio. L'intervallo specificato deve essere allineato in termini di megabyte (MB). In altre parole, il valore di inizio dell'intervallo deve essere divisibile per 1 MB e quello di fine più 1 deve essere divisibile per 1 MB o uguale alla fine dell'archivio. Se il recupero di un intervallo di archivio non è allineato in termini di megabyte, l'operazione restituisce una risposta `400`. Inoltre, per ottenere i valori di checksum dei dati scaricati utilizzando la richiesta **Get Job Output** ([Get Job Output (GET output)](api-job-output-get.md)), l'intervallo deve essere 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). ### Recuperi di tipo Expedited, Standard e Bulk Quando avvii un processo di recupero di archivio, puoi specificare una delle seguenti opzioni nel campo `Tier` del corpo della richiesta: + **`Expedited`**: i recuperi di tipo Expedited consentono di accedere rapidamente ai tuoi dati in caso di richieste occasionali e urgenti di ripristino degli archivi. Per gli archivi di dimensioni inferiori a 250 MB, i tempi di recupero con il livello Expedited sono in genere compresi tra 1 e 5 minuti. + **`Standard`**: i recuperi di tipo Standard consentono l'accesso a qualsiasi archivio nel giro di qualche ora. I tempi di recupero sono in genere inclusi tra le 3 e le 5 ore. Questa è l'opzione predefinita per le richieste di processo in cui non viene specificato il tipo di recupero. + **`Bulk`**— Bulk è il livello più economico per Amazon Glacier, che consente di recuperare grandi quantità di dati, anche petabyte, a costi contenuti in un giorno. I tempi di recupero sono inclusi in genere tra le 5 e le 12 ore. Per ulteriori informazioni sui recuperi di tipo Expedited e Bulk, consulta [Recupero degli archivi Amazon Glacier](downloading-an-archive-two-steps.md). ## Richieste Per avviare un processo, utilizzi il metodo HTTP `POST` e definisci l'ambito della richiesta per la sottorisorsa `jobs` del vault. I dettagli relativi alla richiesta di processo devono essere indicati nel documento JSON della richiesta. Il tipo di processo è specificato nel campo `Type`. Facoltativamente, puoi specificare un `SNSTopic` campo per indicare un argomento di Amazon SNS su cui Amazon Glacier può inviare notifiche dopo il completamento del processo. **Nota** Per pubblicare una notifica in Amazon SNS, devi creare l'argomento se ancora non esiste, Amazon Glacier non crea l'argomento per te. L'argomento deve disporre delle autorizzazioni per ricevere pubblicazioni da un vault Amazon Glacier. Amazon Glacier non verifica se il vault è autorizzato a pubblicare sull'argomento. Se le autorizzazioni non sono configurate in modo appropriato, potresti non ricevere la notifica anche dopo il completamento del processo. ### Sintassi Di seguito viene riportata la sintassi della richiesta di avvio di un processo. ``` 1. POST /{{AccountId}}/vaults/{{VaultName}}/jobs HTTP/1.1 2. Host: glacier.{{Region}}.amazonaws.com 3. Date: {{Date}} 4. Authorization: {{SignatureValue}} 5. x-amz-glacier-version: 2012-06-01 6. 7. { 8. "jobParameters": { 9. "ArchiveId": "{{string}}", 10. "Description": "{{string}}", 11. "Format": "{{string}}", 12. "InventoryRetrievalParameters": { 13. "EndDate": "{{string}}", 14. "Limit": "{{string}}", 15. "Marker": "{{string}}", 16. "StartDate": "{{string}}" 17. }, 18. "OutputLocation": { 19. "S3": { 20. "AccessControlList": [ 21. { 22. "Grantee": { 23. "DisplayName": "{{string}}", 24. "EmailAddress": "{{string}}", 25. "ID": "{{string}}", 26. "Type": "{{string}}", 27. "URI": "{{string}}" 28. }, 29. "Permission": "{{string}}" 30. } 31. ], 32. "BucketName": "{{string}}", 33. "CannedACL": "{{string}}", 34. "Encryption": { 35. "EncryptionType": "{{string}}", 36. "KMSContext": "{{string}}", 37. "KMSKeyId": "{{string}}" 38. }, 39. "Prefix": "{{string}}", 40. "StorageClass": "{{string}}", 41. "Tagging": { 42. "{{string}}" : "{{string}}" 43. }, 44. "UserMetadata": { 45. "{{string}}" : "{{string}}" 46. } 47. } 48. }, 49. "RetrievalByteRange": "{{string}}", 50. "SelectParameters": { 51. "Expression": "{{string}}", 52. "ExpressionType": "{{string}}", 53. "InputSerialization": { 54. "csv": { 55. "Comments": "{{string}}", 56. "FieldDelimiter": "{{string}}", 57. "FileHeaderInfo": "{{string}}", 58. "QuoteCharacter": "{{string}}", 59. "QuoteEscapeCharacter": "{{string}}", 60. "RecordDelimiter": "{{string}}" 61. } 62. }, 63. "OutputSerialization": { 64. "csv": { 65. "FieldDelimiter": "{{string}}", 66. "QuoteCharacter": "{{string}}", 67. "QuoteEscapeCharacter": "{{string}}", 68. "QuoteFields": "{{string}}", 69. "RecordDelimiter": "{{string}}" 70. } 71. } 72. }, 73. "SNSTopic": "{{string}}", 74. "Tier": "{{string}}", 75. "Type": "{{string}}" 76. } 77. } ``` **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. ### Corpo della richiesta La richiesta accetta i seguenti dati in formato JSON nel corpo della richiesta. jobParameters Fornisce opzioni per specificare informazioni sul processo. *Tipo*: oggetto [jobParameters](api-jobParameters.md) *Obbligatorio:* sì ## Risposte Amazon Glacier crea posti di lavoro. e restituisce l'URI del processo nella risposta. ### Sintassi ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Location: {{location}} 5. x-amz-job-id: {{jobId}} 6. x-amz-job-output-path: {{jobOutputPath}} ``` ### Intestazioni di risposta | Header | Description | | --- | --- | | Location | Il percorso URI relativo del processo. Puoi utilizzare questo percorso per trovare lo stato del processo. Per ulteriori informazioni, consulta [Describe Job (GET JobID)](api-describe-job-get.md).
Tipo: String
Impostazione predefinita: nessuna | | x-amz-job-id | L'ID del processo. Questo valore è incluso anche nell'intestazione `Location`.
Tipo: String
Impostazione predefinita: nessuna | | x-amz-job-output-path | Il percorso alla posizione in cui sono archiviati i risultati del processo Select.
Tipo: String
Impostazione predefinita: nessuna | ### Corpo della risposta Questa operazione non restituisce un corpo della risposta. ### Errori Questa operazione include l'errore o gli errori seguenti, oltre ai possibili errori comuni a tutte le operazioni di Amazon Glacier. Per informazioni sugli errori di Amazon Glacier e un elenco di codici di errore, consulta. [Risposte agli errori](api-error-responses.md) | Codice | Description | Codice di stato HTTP | Tipo | | --- | --- | --- | --- | | InsufficientCapacityException | Restituito in caso di capacità insufficiente per elaborare la richiesta di tipo Expedited. Questo errore è relativo solo ai recuperi di tipo Expedited e non a quelli di tipo Standard o Bulk. | 503 Service Unavailable | Server | ## Esempi ### Esempio di richiesta: avvio di un processo di recupero di archivio ``` 1. POST /-/vaults/examplevault/jobs 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 6. 7. { 8. "Type": "archive-retrieval", 9. "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", 10. "Description": "My archive description", 11. "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example", 12. "Tier" : "Bulk" 13. } ``` Di seguito viene riportato un esempio del corpo di una richiesta che specifica un intervallo dell'archivio da recuperare mediante il campo `RetrievalByteRange`. ``` { "Type": "archive-retrieval", "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", "Description": "My archive description", "RetrievalByteRange": "2097152-4194303", "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example", "Tier" : "Bulk" } ``` ### Risposta di esempio ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID ``` ### Esempio di richiesta: avvio di un processo di recupero di inventario La richiesta seguente avvia un processo di recupero di inventario per ottenere un elenco di archivi dal vault `examplevault`. Il parametro `Format` impostato su `CSV` nel corpo della richiesta indica che l'inventario viene restituito in formato CSV. ``` 1. POST /-/vaults/examplevault/jobs HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. Content-Type: application/x-www-form-urlencoded 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 7. 8. { 9. "Type": "inventory-retrieval", 10. "Description": "My inventory job", 11. "Format": "CSV", 12. "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-InventoryRetrieval-topic-Example" 13. } ``` ### Risposta di esempio ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID ``` ### Esempio di richieste: avvio di un processo di recupero di inventario utilizzando un filtro data con un limite definito e richiesta di recupero successiva della pagina di elementi di inventario seguente. La richiesta che segue avvia un processo di recupero di inventario vault mediante un filtro data e un limite definito. ``` 1. { 2. "ArchiveId": null, 3. "Description": null, 4. "Format": "CSV", 5. "RetrievalByteRange": null, 6. "SNSTopic": null, 7. "Type": "inventory-retrieval", 8. "InventoryRetrievalParameters": { 9. "StartDate": "2013-12-04T21:25:42Z", 10. "EndDate": "2013-12-05T21:25:42Z", 11. "Limit" : "10000" 12. }, 13. } ``` La richiesta che segue è un esempio di richiesta di recupero successiva della pagina di elementi di inventario seguente mediante un contrassegno ottenuto da [Describe Job (GET JobID)](api-describe-job-get.md). ``` 1. { 2. "ArchiveId": null, 3. "Description": null, 4. "Format": "CSV", 5. "RetrievalByteRange": null, 6. "SNSTopic": null, 7. "Type": "inventory-retrieval", 8. "InventoryRetrievalParameters": { 9. "StartDate": "2013-12-04T21:25:42Z", 10. "EndDate": "2013-12-05T21:25:42Z", 11. "Limit": "10000", 12. "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" 13. }, 14. } ``` ### Risposta di esempio ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 6. x-amz-job-output-path: test/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/ ``` ## Sezioni correlate + [Describe Job (GET JobID)](api-describe-job-get.md) + [Get Job Output (GET output)](api-job-output-get.md) + [Identity and Access Management per Amazon Glacier](security-iam.md)