Download di un inventario vault in Amazon S3 Glacier - Amazon S3 Glacier
Informazioni sull'inventario

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 di storage S3 Glacier nella Amazon S3 User Guide. Queste classi di storage utilizzano Amazon S3API, sono disponibili in tutte le regioni e possono essere gestite all'interno della console Amazon S3. Offrono funzionalità come Storage Cost Analysis, Storage Lens, funzionalità di crittografia opzionali avanzate e altro ancora.

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à.

Download di un inventario vault in Amazon S3 Glacier

Dopo il caricamento del primo archivio nel vault, Amazon S3 Glacier (S3 Glacier) crea automaticamente un inventario vault e lo aggiorna approssimativamente una volta al giorno. Dopo che S3 Glacier ha creato il primo inventario, è necessario attendere in genere da una mezza giornata a una giornata per poter recuperare l'inventario. Il recupero di un inventario vault da S3 Glacier è un processo in due passaggi:

  1. Avvio di un processo di recupero di un inventario mediante l'operazione Initiate Job (offerte di POST lavoro).

    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 sul recupero dati, consulta Policy sul recupero dati di S3 Glacier. Per ulteriori informazioni sull'eccezione PolicyEnforcedException, consulta Risposte agli errori.

  2. Download dei byte mediante l'operazione Get Job Output (GET output) dopo il completamento del processo.

Ad esempio, il recupero di un archivio o di un inventario vault richiede dapprima l'avvio di un processo di recupero. La richiesta di processo viene eseguita in modo asincrono. Quando avvii un processo di recupero, S3 Glacier crea un processo e restituisce un ID processo nella risposta. Quando S3 Glacier completa il processo, puoi ottenere l'output del processo, la dimensione in byte dell'archivio o i dati dell'inventario vault.

Per ottenere l'output di un processo, è necessario che il processo sia stato completato. Per determinare lo stato di un processo, puoi procedere come segue:

  • Attendi la notifica relativa al completamento del processo: puoi specificare un argomento di Amazon Simple Notification Service (Amazon SNS) in cui S3 Glacier pubblica una notifica dopo il completamento del processo. Puoi specificare l'argomento di Amazon SNS utilizzando i metodi seguenti:

    • Specifica un argomento di Amazon SNS per processo.

      Quando avvii un processo, puoi eventualmente specificare un argomento di Amazon SNS.

    • Imposta la configurazione delle notifiche per il vault.

      Puoi impostare la configurazione delle notifiche per specifici eventi sul vault (consulta Configurazione delle notifiche di vault in Amazon S3 Glacier). A ogni evento del vault, S3 Glacier invia un messaggio all'argomento di SNS specificato.

    Se hai impostato la configurazione delle notifiche nel vault e specifichi anche un argomento di Amazon SNS all'avvio di un processo, S3 Glacier invia il messaggio sul completamento del processo a entrambi gli argomenti.

    Puoi configurare l'argomento di SNS per ricevere notifiche tramite e-mail oppure memorizzare il messaggio in una coda Amazon Simple Queue Service (Amazon SQS) per eseguirne il polling mediante l'applicazione. Quando un messaggio è visualizzato nella coda, puoi verificare se il completamento del processo è riuscito e quindi scaricare l'output del processo.

  • Richiedi esplicitamente informazioni sul processo: S3 Glacier fornisce anche un'operazione Describe Job (Describe Job (GET JobID)) che ti consente di eseguire il polling delle informazioni relative al processo. Puoi inviare periodicamente questa richiesta per ottenere tali informazioni. Tuttavia, l'utilizzo delle notifiche di Amazon SNS è l'opzione consigliata.

Nota

Le informazioni che ottieni via le notifiche di SNS sono identiche a quelle che ottieni chiamando un'operazione Describe Job.

Argomenti

Informazioni sull'inventario

S3 Glacier aggiorna un inventario vault approssimativamente una volta al giorno, a partire dal giorno del primo caricamento di 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 vault, S3 Glacier restituisce l'ultimo inventario generato, ovvero uno snapshot point-in-time e non dati in tempo reale. Nota che dopo la creazione del primo inventario per il vault da parte di S3 Glacier, è necessario attendere in genere da una mezza giornata a una giornata per poter recuperare l'inventario.

A prima vista, recuperare un inventario vault per ogni caricamento di archivio può non sembrare utile. Tuttavia, supponi di avere un database sul lato client in cui vengono associati i metadati relativi agli archivi che carichi in S3 Glacier. In tal caso, l'inventario vault potrebbe essere utilizzato per risolvere le differenze tra le informazioni nel database e l'inventario vault effettivo. Puoi limitare il numero di elementi di inventario recuperati filtrandoli per data di creazione dell'archivio o impostando una quota. Per ulteriori informazioni sulla limitazione del recupero di inventario, consulta Recupero di un intervallo di inventario.

L'inventario può essere restituito in due formati: CSV o JSON. Puoi eventualmente specificare il formato quando avvii il processo di inventario. Il formato di default è JSON. Per ulteriori informazioni sui campi dati restituiti nell'output di un processo di inventario, consulta la sezione Corpo della risposta nella pagina relativa all'API Get Job Output.