Initiate Job (offerte di POST lavoro) - Amazon S3 Glacier

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

Initiate Job (offerte di POST lavoro)

Questa operazione avvia i seguenti tipi di processo Amazon S3 Glacier (S3 Glacier):

  • archive-retrieval: recupero di un archivio

  • inventory-retrieval: inventario di una vault

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 (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 di 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.

La richiesta di recupero 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 (dati dell'archivio o dell'inventario). Per informazioni su come ottenere l'output di un processo, consulta la sezione sull'operazione Get Job Output (GET output).

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 SNS notifica Amazon: puoi specificare un SNS argomento Amazon su cui S3 Glacier può pubblicare una notifica dopo il completamento del lavoro. Puoi specificare un SNS argomento per ogni richiesta di lavoro. La notifica viene inviata solo dopo che S3 Glacier ha completato il processo. Oltre a specificare un SNS argomento per richiesta di lavoro, è possibile configurare le notifiche di vault per un vault in modo che le notifiche di lavoro vengano inviate per tutti i recuperi. Per ulteriori informazioni, consulta Set Vault Notification Configuration (PUT notification-configuration).

  • Ottenere dettagli sul processo: puoi effettuare una richiesta Describe Job (GET JobID) per ottenere informazioni sullo stato del processo durante la sua esecuzione. Tuttavia, è più efficiente utilizzare una SNS notifica Amazon per determinare quando un lavoro è completo.

Nota

Le informazioni che ottieni tramite le notifiche sono le stesse che ottieni chiamando Describe Job (GET JobID).

Se per un evento specifico, aggiungi sia la configurazione delle notifiche sul vault sia specifichi anche un SNS argomento nella richiesta di avvio del lavoro, S3 Glacier invia entrambe le notifiche. Per ulteriori informazioni, consulta Set Vault Notification Configuration (PUT notification-configuration).

Inventario vault

S3 Glacier aggiorna un inventario vault approssimativamente una volta al giorno, a partire dal giorno del primo caricamento di un archivio nella vault. Se nessun archivio è stato aggiunto o eliminato nel vault dall'ultimo inventario, la data dell'inventario non viene aggiornata. Quando si avvia un processo per un inventario del vault, S3 Glacier restituisce l'ultimo inventario generato, che è un'istantanea e non dati in tempo reale. point-in-time

Dopo che S3 Glacier ha creato il primo inventario per la vault, è 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. Per ulteriori informazioni sui campi dati restituiti nell'output di un processo di inventario, consulta Corpo della risposta.

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) 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)), 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.

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: i recuperi di tipo Bulk sono il metodo meno costoso di S3 Glacier e consentono di recuperare in un solo giorno elevati volumi di dati, anche nell'ordine di petabyte, a costi estremamente ridotti. 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 S3 Glacier mediante console AWS.

Richieste

Per avviare un lavoro, si utilizza il HTTP POST metodo e si indirizza la richiesta alla sottorisorsa del vault. jobs I dettagli della richiesta di lavoro vengono specificati nel JSON documento della richiesta. Il tipo di processo è specificato nel campo Type. Facoltativamente, puoi specificare un SNSTopic campo per indicare un SNS argomento Amazon su cui S3 Glacier può inviare una notifica dopo il completamento del lavoro.

Nota

Per pubblicare una notifica su AmazonSNS, devi creare tu stesso l'argomento se non esiste già. in quanto S3 Glacier non lo crea automaticamente. L'argomento deve disporre delle autorizzazioni per ricevere pubblicazioni da una vault di S3 Glacier. S3 Glacier non verifica se la vault dispone delle autorizzazioni per pubblicare nell'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.

POST /AccountId/vaults/VaultName/jobs HTTP/1.1 Host: glacier.Region.amazonaws.com Date: Date Authorization: SignatureValue x-amz-glacier-version: 2012-06-01 { "jobParameters": { "ArchiveId": "string", "Description": "string", "Format": "string", "InventoryRetrievalParameters": { "EndDate": "string", "Limit": "string", "Marker": "string", "StartDate": "string" }, "OutputLocation": { "S3": { "AccessControlList": [ { "Grantee": { "DisplayName": "string", "EmailAddress": "string", "ID": "string", "Type": "string", "URI": "string" }, "Permission": "string" } ], "BucketName": "string", "CannedACL": "string", "Encryption": { "EncryptionType": "string", "KMSContext": "string", "KMSKeyId": "string" }, "Prefix": "string", "StorageClass": "string", "Tagging": { "string" : "string" }, "UserMetadata": { "string" : "string" } } }, "RetrievalByteRange": "string", "SelectParameters": { "Expression": "string", "ExpressionType": "string", "InputSerialization": { "csv": { "Comments": "string", "FieldDelimiter": "string", "FileHeaderInfo": "string", "QuoteCharacter": "string", "QuoteEscapeCharacter": "string", "RecordDelimiter": "string" } }, "OutputSerialization": { "csv": { "FieldDelimiter": "string", "QuoteCharacter": "string", "QuoteEscapeCharacter": "string", "QuoteFields": "string", "RecordDelimiter": "string" } } }, "SNSTopic": "string", "Tier": "string", "Type": "string" } }
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 S3 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 nel JSON formato contenuto nel corpo della richiesta.

jobParameters

Fornisce opzioni per specificare informazioni sul processo.

Tipo: oggetto jobParameters

Campo obbligatorio: sì

Risposte

S3 Glacier crea il processo. Nella risposta, restituisce il URI risultato del lavoro.

Sintassi

HTTP/1.1 202 Accepted x-amzn-RequestId: x-amzn-RequestId Date: Date Location: location x-amz-job-id: jobId x-amz-job-output-path: jobOutputPath

Intestazioni di risposta

Header Descrizione
Location

Il URI percorso relativo del lavoro. È possibile utilizzare questo URI percorso per trovare lo stato del lavoro. Per ulteriori informazioni, consulta Describe Job (GET JobID).

▬Tipo: stringa

Impostazione predefinita: nessuna

x-amz-job-id

L'ID del processo. Questo valore è incluso anche nell'intestazione Location.

▬Tipo: stringa

Impostazione predefinita: nessuna

x-amz-job-output-path

Il percorso alla posizione in cui sono archiviati i risultati del processo Select.

▬Tipo: stringa

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 S3 Glacier. Per informazioni sugli errori di Amazon S3 Glacier e un elenco di codici di errore, consulta Risposte agli errori.

Codice Descrizione HTTPCodice di stato Type
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

POST /-/vaults/examplevault/jobs HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z 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 { "Type": "archive-retrieval", "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", "Description": "My archive description", "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example", "Tier" : "Bulk" }

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

HTTP/1.1 202 Accepted x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 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 valore Format impostato CSV nel corpo della richiesta indica che l'inventario viene restituito in CSV formato.

POST /-/vaults/examplevault/jobs HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z Content-Type: application/x-www-form-urlencoded 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 { "Type": "inventory-retrieval", "Description": "My inventory job", "Format": "CSV", "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-InventoryRetrieval-topic-Example" }

Risposta di esempio

HTTP/1.1 202 Accepted x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 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.

{ "ArchiveId": null, "Description": null, "Format": "CSV", "RetrievalByteRange": null, "SNSTopic": null, "Type": "inventory-retrieval", "InventoryRetrievalParameters": { "StartDate": "2013-12-04T21:25:42Z", "EndDate": "2013-12-05T21:25:42Z", "Limit" : "10000" }, }

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

{ "ArchiveId": null, "Description": null, "Format": "CSV", "RetrievalByteRange": null, "SNSTopic": null, "Type": "inventory-retrieval", "InventoryRetrievalParameters": { "StartDate": "2013-12-04T21:25:42Z", "EndDate": "2013-12-05T21:25:42Z", "Limit": "10000", "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" }, }

Risposta di esempio

HTTP/1.1 202 Accepted x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID x-amz-job-output-path: test/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/

Sezioni correlate