**Diese Seite ist nur für Bestandskunden des Amazon Glacier-Service bestimmt, die Vaults und die ursprüngliche REST-API von 2012 verwenden.** Wenn Sie nach Archivspeicherlösungen suchen, empfehlen wir die Verwendung der Amazon Glacier-Speicherklassen in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval und S3 Glacier Deep Archive. Weitere Informationen zu diesen Speicheroptionen finden Sie unter [Amazon Glacier-Speicherklassen](https://aws.amazon.com/s3/storage-classes/glacier/). Amazon Glacier (ursprünglicher eigenständiger, auf Tresor basierender Service) akzeptiert keine Neukunden mehr. Amazon Glacier ist ein eigenständiger Service APIs , der Daten in Tresoren speichert und sich von den Speicherklassen Amazon S3 und Amazon S3 Glacier unterscheidet. Ihre vorhandenen Daten bleiben in Amazon Glacier auf unbestimmte Zeit sicher und zugänglich. Es ist keine Migration erforderlich. Für kostengünstige, langfristige Archivierungsspeicherung AWS empfiehlt sich die [Amazon S3 Glacier-Speicherklasse](https://aws.amazon.com/s3/storage-classes/glacier/), die mit S3-Bucket-Basis, voller AWS-Region Verfügbarkeit APIs, geringeren Kosten und AWS Serviceintegration ein hervorragendes Kundenerlebnis bieten. Wenn Sie erweiterte Funktionen wünschen, sollten Sie eine Migration zu Amazon S3 Glacier-Speicherklassen in Betracht ziehen, indem Sie unseren [AWS Lösungsleitfaden für die Übertragung von Daten aus Amazon Glacier-Tresoren in Amazon S3 Glacier-Speicherklassen](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/) verwenden. 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. # Get Job Output (GET output) ## Description Diese Operation lädt die Ausgabe des Auftrags herunter, den Sie mithilfe von [Initiate Job (POST jobs)](api-initiate-job-post.md) initiiert haben. Abhängig von dem Auftragstyp, den Sie spezifiziert haben, als Sie den Auftrag initiierten, wird die Ausgabe entweder der Inhalt eines Archivs oder ein Tresorbestand sein. Sie können die gesamte Auftragsausgabe oder optional nur einen Teil der Auftragsausgabe herunterladen, indem Sie einen Bytebereich festlegen. Sowohl für Archivierungs- als auch für Inventarabrufaufträge sollten Sie die heruntergeladene Größe mit der Größe vergleichen, die in den Headern von der Antwort **Get Job Output** response zurückgegeben wird. Bei Archivabrufaufträgen sollten Sie auch überprüfen, ob die Größe Ihren Erwartungen entspricht. Wenn Sie einen Teil der Ausgabe herunterladen, basiert die erwartete Größe auf dem von Ihnen angegebenen Bytebereich. Wenn Sie z. B. einen Bereich von `bytes=0-1048575` angeben, sollten Sie überprüfen, ob die Größe Ihres Downloads 1 048 576 Bytes ist. Wenn Sie ein ganzes Archiv herunterladen, entspricht die erwartete Größe der Größe des Archivs, als Sie es auf Amazon Glacier (Amazon Glacier) hochgeladen haben. Die erwartete Größe wird auch in den Headern der Antwort **Get Job Output** zurückgegeben. Bei einem Auftrag zum Abrufen von Archiven gibt Amazon Glacier je nach dem von Ihnen angegebenen Bytebereich die Prüfsumme für den Teil der Daten zurück. Um sicherzustellen, dass der Teil, den Sie heruntergeladen haben, die korrekten Daten enthält, berechnen Sie die Prüfsumme auf dem Client, überprüfen Sie, ob die Werte übereinstimmen und ob die Größe Ihren Erwartungen entspricht. Eine Job-ID läuft mindestens 24 Stunden nach Abschluss des Auftrags durch Amazon Glacier nicht ab. Das heißt, Sie können die Auftragsausgabe innerhalb von 24 Stunden nach Abschluss des Auftrags durch Amazon Glacier herunterladen. ## Anforderungen ### Syntax Um eine Auftragsausgabe abzurufen, senden Sie die HTTP-`GET`-Anfrage an den URI der `output` des jeweiligen Auftrags. ``` 1. GET /AccountId/vaults/VaultName/jobs/JobID/output HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. Range: ByteRangeToRetrieve 6. x-amz-glacier-version: 2012-06-01 ``` **Anmerkung** Der `AccountId` Wert ist die AWS-Konto ID des Kontos, dem der Tresor gehört. Sie können entweder eine AWS-Konto ID oder optional ein einzelnes '`-`' (Bindestrich) angeben. In diesem Fall verwendet Amazon Glacier die AWS-Konto ID, die den Anmeldeinformationen zugeordnet ist, die zum Signieren der Anfrage verwendet wurden. Wenn Sie eine Konto-ID verwenden, darf die ID keine Bindestriche („-“) enthalten. ### Anforderungsparameter Dieser Vorgang verwendet keine Anforderungsparameter. ### Anforderungsheader Bei diesem Vorgang werden zusätzlich zu den Anforderungs-Headern, die allen Vorgängen gemeinsam sind, die folgenden Anforderungs-Header verwendet. Weitere Informationen über allgemeine Anforderungsheader finden Sie unter [Häufig verwendete Anforderungsheader](api-common-request-headers.md). | Name | Description | Erforderlich | | --- | --- | --- | | Range | Der Bytebereich, der von der Ausgabe abgerufen werden soll. Wenn Sie zum Beispiel die ersten 1 048 576 Bytes herunterladen möchten, geben Sie den Bereich an als `bytes=0-1048575`. Weitere Informationen finden Sie unter [Range Header Field Definition](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35). Der Bereich ist relativ zu jedem Bereich, der in der Anfrage zur Auftragsinitiierung angegeben wurde. Standardmäßig lädt diese Operation die gesamte Ausgabe herunter. Wenn die Auftragsausgabe groß ist, können Sie den Header der `Range`-Anforderung verwenden, um einen Teil der Ausgabe abzurufen. Damit können Sie die gesamte Ausgabe in kleineren Byte-Blöcken herunterladen. Angenommen, Sie haben 1 GB Auftragsausgabe, die Sie herunterladen möchten, und Sie beschließen, jeweils Datenblöcke von 128 MB herunterzuladen, insgesamt also acht Anfragen zum Abrufen von Auftragsausgaben. Sie können die Auftragsausgabe mithilfe des folgenden Prozesses herunterladen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazonglacier/latest/dev/api-job-output-get.html) Typ: Zeichenfolge Standard: keiner Einschränkungen: Keine | Nein | ### Anforderungstext Dieser Vorgang besitzt keinen Anforderungstext. ## Antworten ### Syntax Bei einer Anfrage zum Abruf, die alle Auftragsdaten zurückgibt, gibt die Auftragsausgabeantwort einen `200 OK`-Antwortcode zurück. Wenn Teile des Inhalts angefragt werden, z. B. wenn Sie in der Anfrage den `Range`-Header angegeben haben, wird der Antwortcode `206 Partial Content` zurückgegeben. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Content-Type: ContentType 5. Content-Length: Length 6. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier 7. 8. [Body containing job output.] ``` ### Antwort-Header | Header | Description | | --- | --- | | Content-Range | Der von Amazon Glacier zurückgegebene Bytebereich. Wenn nur ein Teil der Ausgabe heruntergeladen wird, enthält die Antwort den Bytebereich, den Amazon Glacier zurückgegeben hat. Zum Beispiel gibt `bytes 0-1048575/8388608` die ersten 1 MB von 8 MB zurück. Weitere Informationen über den `Content-Range`-Header finden Sie unter [Content-Range Header Field Definition](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16). Typ: Zeichenfolge | | Content-Type | Der Inhaltstyp hängt davon ab, ob die Auftragsausgabe ein Archiv oder ein Tresorbestand ist. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazonglacier/latest/dev/api-job-output-get.html) Typ: Zeichenfolge | | x-amz-sha256-tree-hash​ | Die Prüfsumme der Daten in der Antwort. Dieser Header wird nur zurückgegeben, wenn die Ausgabe eines Archivabrufauftrags abgerufen wird. Darüber hinaus wird dieser Header angezeigt, wenn der abgerufene Datenbereich, der in der Anfrage zur Auftragsinitiierung angefragt wurde, mit dem Struktur-Hash abgeglichen ist und der herunterzuladende Bereich in „Get Job Output“ ebenfalls mit dem Struktur-Hash abgeglichen ist. Weitere Informationen zum Abgleichen von Bereichen mit dem Struktur-Hash finden Sie unter [Erhalten von Prüfsummen bei Daten-Download](checksum-calculations-range.md). Wenn Sie z. B. in Ihrer Anfrage zur Auftragsinitiierung einen mit dem Struktur-Hash abgeglichenen Bereich angegeben haben (der das gesamte Archiv umfasst), dann erhalten Sie die Prüfsumme der von Ihnen heruntergeladenen Daten unter den folgenden Bedingungen: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/amazonglacier/latest/dev/api-job-output-get.html) Typ: Zeichenfolge | ### Antworttext Amazon Glacier gibt die Jobausgabe im Antworttext zurück. Je nach Auftragstyp kann die Ausgabe der Inhalt eines Archivs oder der Tresorbestand sein. Im Falle eines Tresorbestands wird standardmäßig die Inventarliste als folgender JSON-Text zurückgegeben. ``` 1. { 2. "VaultARN": String, 3. "InventoryDate": String, 4. "ArchiveList": [ 5. {"ArchiveId": String, 6. "ArchiveDescription": String, 7. "CreationDate": String, 8. "Size": Number, 9. "SHA256TreeHash": String 10. }, 11. ... 12. ] 13. } ``` Wenn Sie das CSV-Ausgabeformat (kommaseparierte Werte) bei der Initiierung des Tresorbestandsauftrags angefordert haben, wird der Tresorbestand im CSV-Format im Text zurückgegeben. Das CSV-Format hat fünf Spalten "ArchiveId„," ArchiveDescription „," CreationDate „, „Größe“ und "SHA256TreeHash" mit denselben Definitionen wie die entsprechenden JSON-Felder. **Anmerkung** In dem zurückgegebenen CSV-Format können Felder zurückgegeben werden, die vollständig in doppelten Anführungszeichen eingeschlossen sind. Felder, die ein Komma oder doppelte Anführungszeichen enthalten, werden immer eingeschlossen in doppelten Anführungszeichen zurückgegeben. Zum Beispiel wird `my archive description,1` als `"my archive description,1"` zurückgegeben. Doppelte Anführungszeichen, die innerhalb von zurückgegebenen Feldern sind, die in doppelten Anführungszeichen eingeschlossen sind, werden durch einen vorangestellten umgekehrten Schrägstrich als *Escape-Zeichen* geschützt. Zum Beispiel wird `my archive description,1"2` zurückgegeben als `"my archive description,1\"2"` und `my archive description,1\"2` zurückgegeben als `"my archive description,1\\"2"`. Das umgekehrte Schrägstrichzeichen wird nicht durch ein Escape-Zeichen geschützt. Der JSON-Antworttext enthält die folgenden JSON-Felder. **ArchiveDescription** Die Beschreibung eines Archivs. *Typ:* Zeichenfolge **ArchiveId** Die ID eines Archivs. *Typ:* Zeichenfolge **ArchiveList** Ein Array von Archivmetadaten. Jedes Objekt in dem Array steht für Metadaten für ein im Tresor enthaltenes Archiv. *Typ*: Array **CreationDate** Datum und Uhrzeit (UTC), wann das Archiv erstellt wurde. *Typ*: Eine Zeichenkettendarstellung im ISO 8601-Datumsformat, z. B. `2013-03-20T17:03:43.221Z`. **InventoryDate** Datum und Uhrzeit (UTC) der letzten Inventur für den Tresor, die nach Änderungen am Tresor abgeschlossen wurde. Amazon Glacier erstellt zwar einmal täglich ein Tresorinventar, das Inventardatum wird jedoch nur aktualisiert, wenn seit der letzten Inventarisierung Archive hinzugefügt oder gelöscht wurden. *Typ*: Eine Zeichenfolgendarstellung im ISO 8601-Datumsformat, z. B. `2013-03-20T17:03:43.221Z`. **SHA256TreeHash** Der Struktur-Hash des Archivs. *Typ:* Zeichenfolge **Größe** Die Größe des Archivs in Bytes. *Typ*: Zahl **VaultARN** Die ARN-Ressource (Amazon-Ressourcenname), von der der Archivabruf angefordert wurde. *Typ:* Zeichenfolge ### Fehler Informationen zu Amazon Glacier-Ausnahmen und Fehlermeldungen finden Sie unter[Fehlermeldungen](api-error-responses.md). ## Beispiele Das folgende Beispiel zeigt die Anfrage für einen Auftrag, der ein Archiv abruft. ### Beispiel 1: Ausgabe herunterladen In diesem Beispiel werden Daten abgerufen, die von Amazon Glacier als Antwort auf Ihre Job-Anfrage zum Initiieren des Archivabrufs vorbereitet wurden. #### Beispielanforderung ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 ``` #### Beispielantwort Es folgt eine Beispielantwort eines Archivabrufauftrags. Beachten Sie, dass der `Content-Type`-Header `application/octet-stream` ist und dass der `x-amz-sha256-tree-hash`-Header in der Antwort enthalten ist, das heißt, dass alle Auftragsdaten zurückgegeben wurden. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 4. Date: Wed, 10 Feb 2017 12:00:00 GMT 5. Content-Type: application/octet-stream 6. Content-Length: 1048576 7. 8. [Archive data.] ``` Es folgt eine Beispielantwort eines Inventarabrufauftrags. Beachten Sie, dass der `Content-Type`-Header `application/json` ist. Beachten Sie auch, dass die Antwort nicht den `x-amz-sha256-tree-hash`-Header enthält. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Type: application/json 5. Content-Length: 906 6. 7. { 8. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault", 9. "InventoryDate": "2011-12-12T14:19:01Z", 10. "ArchiveList": [ 11. { 12. "ArchiveId": "DMTmICA2n5Tdqq5BV2z7og-A20xnpAPKt3UXwWxdWsn_D6auTUrW6kwy5Qyj9xd1MCE1mBYvMQ63LWaT8yTMzMaCxB_9VBWrW4Jw4zsvg5kehAPDVKcppUD1X7b24JukOr4mMAq-oA", 13. "ArchiveDescription": "my archive1", 14. "CreationDate": "2012-05-15T17:19:46.700Z", 15. "Size": 2140123, 16. "SHA256TreeHash": "6b9d4cf8697bd3af6aa1b590a0b27b337da5b18988dbcc619a3e608a554a1e62" 17. }, 18. { 19. "ArchiveId": "2lHzwhKhgF2JHyvCS-ZRuF08IQLuyB4265Hs3AXj9MoAIhz7tbXAvcFeHusgU_hViO1WeCBe0N5lsYYHRyZ7rrmRkNRuYrXUs_sjl2K8ume_7mKO_0i7C-uHE1oHqaW9d37pabXrSA", 20. "ArchiveDescription": "my archive2", 21. "CreationDate": "2012-05-15T17:21:39.339Z", 22. "Size": 2140123, 23. "SHA256TreeHash": "7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3" 24. } 25. ] 26. } ``` ### Beispiel 2: Ausgabe nur teilweise herunterladen In diesem Beispiel wird nur ein Teil des Archivs abgerufen, das von Amazon Glacier als Antwort auf Ihre Anfrage zum Abrufen von Archiven vorbereitet wurde. Die Anfrage verwendet den optionalen `Range`-Header, um nur die ersten 1 024 Bytes abzurufen. #### Beispielanforderung ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. Range: bytes=0-1023 5. x-amz-glacier-version: 2012-06-01 6. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 ``` #### Beispielantwort Die folgende erfolgreiche Antwort zeigt die `206 Partial Content`-Antwort. In diesem Fall enthält die Antwort auch einen `Content-Range` Header, der den Bytebereich angibt, den Amazon Glacier zurückgibt. ``` 1. HTTP/1.1 206 Partial Content 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Range: bytes 0-1023/8388608 5. Content-Type: application/octet-stream 6. Content-Length: 1024 7. 8. [Archive data.] ``` ## Zugehörige Abschnitte + [Describe Job (GET JobID)](api-describe-job-get.md) + [Initiate Job (POST jobs)](api-initiate-job-post.md) + [Identity and Access Management für Amazon Glacier](security-iam.md)