Herunterladen eines Archivs in Amazon S3 Glacier mithilfe desAWS CLI

Sie können Archive in Amazon S3 Glacier (S3 Glacier) herunterladen, indem Sie dieAWS Command Line Interface (AWS CLI) verwenden.

(Voraussetzung) Einrichten der AWS CLI

1. Herunterladen und Konfigurieren von AWS CLI. Eine Anleitung finden Sie unter den folgenden Themen im AWS Command Line Interface-Benutzerhandbuch:

   Installieren des AWS Command Line Interface

   Konfigurieren von AWS Command Line Interface

2. Überprüfen Sie IhreAWS CLI Einrichtung, indem Sie die folgenden Befehle in die Befehlszeile eingeben. Diese Befehle stellen nicht explizit Anmeldeinformationen bereit, daher werden die Anmeldeinformationen des Standardprofils verwendet.

   • Versuchen Sie, den Befehl help zu verwenden.

     aws help

   • Verwenden Sie denlist-vaults Befehl, um eine Liste der S3 Glacier-Tresore für das konfigurierte Konto abzurufen. Ersetzen Sie 123456789012 durch IhreAWS-Konto ID.

     aws glacier list-vaults --account-id 123456789012

   • Um die aktuellen Konfigurationsdaten für zu sehenAWS CLI, verwenden Sie denaws configure list Befehl.

     aws configure list

Beispiel: Laden Sie ein Archiv herunter mit demAWS CLI

Anmerkung

Um Ihre Archive herunterladen zu können, müssen Sie Ihre Archiv-IDs kennen. In den Schritten 1 bis 4 werden Ihre Archiv-IDs abgerufen. Wenn Sie die Archiv-IDs, die Sie herunterladen möchten, bereits kennen, fahren Sie mit Schritt 5 fort.

1. Verwenden Sie deninitiate-job Befehl, um einen Auftrag zum Abrufen von Inventar zu starten. Der Inventarbericht listet Ihre Archiv-IDs auf.

   aws glacier initiate-job --vault-name awsexamplevault --account-id 111122223333 --job-parameters "{\"Type\":\"inventory-retrieval\"}"

   Erwartete Ausgabe:

   
   {
       "location": "/111122223333/vaults/awsexamplevault/jobs/*** jobid ***", 
       "jobId": "*** jobid ***"
   }
   						

2. Verwenden Sie dendescribe-job Befehl, um den Status des vorherigeninventory-retrieval Job-Befehls zu überprüfen.

   aws glacier describe-job --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid ***

   Erwartete Ausgabe:

   {
       "InventoryRetrievalParameters": {
           "Format": "JSON"
       }, 
       "VaultARN": "*** vault arn ***", 
       "Completed": false, 
       "JobId": "*** jobid ***", 
       "Action": "InventoryRetrieval", 
       "CreationDate": "*** job creation date ***", 
       "StatusCode": "InProgress"
   }
   						

3. Warten Sie, bis der Auftrag abgeschlossen wurde.

   Sie müssen warten, bis die Ausgabe des Auftrags zum Download bereit ist. Wenn Sie bei der Initiierung des Jobs eine Benachrichtigungskonfiguration für den Tresor festgelegt oder ein Amazon Simple Notification Service (Amazon SNS) -Thema angegeben haben, sendet S3 Glacier nach Abschluss des Jobs eine Nachricht an das Thema.

   Sie können Benachrichtigungskonfiguration für bestimmte Ereignisse auf dem Tresor einrichten. Weitere Informationen finden Sie unter Konfigurieren von Tresorbenachrichtigungen in Amazon S3 Glac. S3 Glacier sendet jedes Mal, wenn das spezifische Ereignis eintritt, eine Nachricht an das angegebene SNS-Thema.

4. Nach Abschluss laden Sie die Abrufaufgabe mit dem get-job-output-Befehl in die Datei „output.json“ herunter. Diese Datei wird Ihre Archiv-IDs enthalten.

   aws glacier get-job-output --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid *** output.json

   Dieser Befehl erzeugt eine Datei mit den folgenden Feldern.

   
   {
   "VaultARN":"arn:aws:glacier:region:111122223333:vaults/awsexamplevault",
   "InventoryDate":"*** job completion date ***",
   "ArchiveList":[
   {"ArchiveId":"*** archiveid ***",
   "ArchiveDescription":*** archive description (if set) ***,
   "CreationDate":"*** archive creation date ***",
   "Size":"*** archive size (in bytes) ***",
   "SHA256TreeHash":"*** archive hash ***"
   }
   {"ArchiveId":
   ...
   ]}

5. Verwenden Sie deninitiate-job Befehl, um den Abrufvorgang für jedes Archiv aus einem Tresor zu starten. Sie müssen den Job-Parameterarchive-retrieval wie unten gezeigt angeben.

   aws glacier initiate-job --vault-name awsexamplevault --account-id 111122223333 --job-parameters "{\"Type\":\"archive-retrieval\",\"ArchiveId\":\"*** archiveId ***\"}"

6. Warten Sie, bis derarchive-retrieval Job abgeschlossen ist. Verwenden Sie dendescribe-job Befehl, um den Status des vorherigen Befehls zu überprüfen.

   aws glacier describe-job --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid ***

7. Wenn der obige Job abgeschlossen ist, verwenden Sie denget-job-output Befehl, um Ihr Archiv herunterzuladen.

   aws glacier get-job-output --vault-name awsexamplevault --account-id 111122223333 --job-id *** jobid *** output_file_name