Initiate Job (POST jobs) - Amazon Glacier
Avvio di un processo di recupero di un archivio o di un inventario vault RichiesteRisposteEsempiSezioni correlate

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.

Amazon Glacier (servizio autonomo originale basato su vault) non accetterà più nuovi clienti a partire dal 15 dicembre 2025, senza alcun impatto sui clienti esistenti. 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, 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.

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

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

    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. 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, Amazon Glacier crea un processo e restituisce un ID del lavoro 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).

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

  • Ottenere dettagli sul processo: puoi effettuare una richiesta Describe Job (GET JobID) 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).

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

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.

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

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.

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

Campo obbligatorio: sì

Risposte

Amazon Glacier crea posti di lavoro. e restituisce l'URI del processo nella risposta.

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 percorso URI relativo del processo. Puoi utilizzare questo percorso per trovare lo stato del processo. 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 Glacier. Per informazioni sugli errori di Amazon Glacier e un elenco di codici di errore, consulta. Risposte agli errori

Codice Descrizione 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

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 parametro Format impostato su CSV nel corpo della richiesta indica che l'inventario viene restituito in formato CSV.

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