Herunterladen eines Archivs in Amazon S3 Glacier mithilfe der AWS CLI - Amazon S3 Glacier

Wenn Sie mit dem Archivierungsspeicher in Amazon Simple Storage Service (Amazon S3) noch nicht vertraut sind, empfehlen wir Ihnen, sich zunächst über die S3-Glacier-Speicherklassen in Amazon S3 (S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval und S3 Glacier Deep Archive) zu informieren. Weitere Informationen finden Sie unter S3-Glacier-Speicherklassen und Speicherklassen für die Archivierung von Objekten im Amazon S3-Benutzerhandbuch.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Herunterladen eines Archivs in Amazon S3 Glacier mithilfe der AWS CLI

Sie können Archive in Amazon S3 Glacier (S3 Glacier) über die AWS Command Line Interface (AWS CLI) herunterladen.

(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 die AWS 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 den list-vaults-Befehl, um eine Liste der S3-Glacier-Tresore für das konfigurierte Konto abzurufen. Ersetzen Sie 123456789012 durch Ihre AWS-Konto-ID.

      aws glacier list-vaults --account-id 123456789012
    • Mit dem Befehl aws configure list können Sie die aktuellen Konfigurationsdaten für die AWS CLI abrufen.

      aws configure list

Beispiel: Herunterladen eines Archivs mit der AWS CLI

Anmerkung

Um Ihre Archive herunterzuladen, müssen Sie die Archiv-IDs kennen. Mit den Schritten 1–4 werden die Archiv-IDs abgerufen. Wenn Sie IDs der Archive, die Sie herunterladen möchten, bereits kennen, fahren Sie mit Schritt 5 fort.

  1. Verwenden Sie den initiate-job-Befehl, um einen Inventarabrufauftrag zu starten. Im Inventarbericht werden die Archiv-IDs aufgeführt.

    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 den describe-job-Befehl, um den Status des vorherigen -Auftragsbefehls 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 eine Benachrichtigungskonfiguration für den Tresor eingerichtet oder beim Initiieren des Auftrags ein Amazon Simple Notification Service (Amazon SNS)-Thema angegeben haben, sendet S3 Glacier nach Beenden des Auftrags eine Benachrichtigung 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 Glacier. S3 Glacier sendet jedes Mal eine Nachricht an das angegebene SNS-Thema, wenn das jeweilige Ereignis eintritt.

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

    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 den initiate-job-Befehl, um den Abrufvorgang für jedes Archiv aus einem Tresor zu starten. Sie müssen als Auftragsparameter archive-retrieval wie unten dargestellt angeben.

    aws glacier initiate-job --vault-name awsexamplevault --account-id 111122223333 --job-parameters="{\"Type\":\"archive-retrieval\",\"ArchiveId\":\"*** archiveId ***\"}"
  6. Warten Sie, bis der archive-retrieval-Auftrag abgeschlossen wurde. Verwenden Sie den describe-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 oben beschriebene Auftrag abgeschlossen ist, verwenden Sie den get-job-output-Befehl, um Ihr Archiv herunterzuladen.

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