**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. # Auftragsoperationen Im Folgenden sind die in Amazon Glacier verfügbaren Auftragsoperationen aufgeführt. **Topics** + [Describe Job (GET JobID)](api-describe-job-get.md) + [Get Job Output (GET output)](api-job-output-get.md) + [Initiate Job (POST jobs)](api-initiate-job-post.md) + [Aufträge auflisten (GET jobs)](api-jobs-get.md) # Describe Job (GET JobID) ## Description Dieser Vorgang gibt Informationen über einen Job zurück, den Sie zuvor initiiert haben, einschließlich des Initiierungsdatums des Jobs, des Benutzers, der den Job initiiert hat, des Job-Statuscodes/der Job-Nachricht und des Themas Amazon Simple Notification Service (Amazon SNS), das nach Abschluss des Auftrags durch Amazon Glacier (Amazon Glacier) benachrichtigt werden soll. Weitere Informationen zur Initiierung eines Auftrags finden Sie unter [Initiate Job (POST jobs)](api-initiate-job-post.md). **Anmerkung** Mit dieser Operation können Sie den Status Ihres Auftrags prüfen. Wir empfehlen Ihnen jedoch dringend, ein Amazon SNS SNS-Thema einzurichten und es in Ihrer Job-Initiation-Anfrage anzugeben, damit Amazon Glacier das Thema nach Abschluss des Jobs benachrichtigen kann. Eine Job-ID läuft mindestens 24 Stunden nach Abschluss des Auftrags durch Amazon Glacier nicht ab. ## Anforderungen ### Syntax Um Informationen zu einem Auftrag zu erhalten, verwenden Sie die HTTP-`GET`-Methode und beschränken Sie den Umfang der Anfrage auf den bestimmten Auftrag. Beachten Sie, dass der relative URI-Pfad derselbe ist, den Amazon Glacier Ihnen zurückgegeben hat, als Sie den Job initiiert haben. ``` 1. GET /AccountID/vaults/VaultName/jobs/JobID HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: date 4. Authorization: signatureValue 5. 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. **Anmerkung** Wenn Sie in der Anfrage die `JobID` weglassen, gibt die Antwort eine Liste aller aktiven Aufträge für den angegebenen Tresor zurück. Weitere Informationen über das Auflisten von Aufträgen finden Sie unter [Aufträge auflisten (GET jobs)](api-jobs-get.md). ### Anforderungsparameter Dieser Vorgang verwendet keine Anforderungsparameter. ### Anforderungsheader Für diesen Vorgang werden ausschließlich Anforderungs-Header verwendet, die für alle Vorgänge gelten. Weitere Informationen über allgemeine Anforderungs-Header finden Sie unter [Häufig verwendete Anforderungsheader](api-common-request-headers.md). ### Anforderungstext Dieser Vorgang besitzt keinen Anforderungstext. ## Antworten ### Syntax ``` HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: Length { "Action": "string", "ArchiveId": "string", "ArchiveSHA256TreeHash": "string", "ArchiveSizeInBytes": number, "Completed": boolean, "CompletionDate": "string", "CreationDate": "string", "InventoryRetrievalParameters": { "EndDate": "string", "Format": "string", "Limit": "string", "Marker": "string", "StartDate": "string" }, "InventorySizeInBytes": number, "JobDescription": "string", "JobId": "string", "JobOutputPath": "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" } } }, "SHA256TreeHash": "string", "SNSTopic": "string", "StatusCode": "string", "StatusMessage": "string", "Tier": "string", "VaultARN": "string" } ``` ### Antwort-Header Für diesen Vorgang werden ausschließlich Antwort-Header verwendet, die für die meisten Antworten gelten. Weitere Informationen über allgemeine Antwort-Header finden Sie unter [Allgemeine Antwort-Header](api-common-response-headers.md). ### Antworttext Der Antworttext enthält die folgenden JSON-Felder. **Action (Aktion)** Der Auftragstyp. Er ist entweder `ArchiveRetrieval`, `InventoryRetrieval` oder `Select`. *Typ:* Zeichenfolge **ArchiveId** Die Archiv-ID, die für eine Auswahl oder einen Archivabruf angefordert wurde. Andernfalls ist dieses Feld `null`. *Typ:* Zeichenfolge **ArchivSHA256TreeHash** Der SHA256 Struktur-Hash des gesamten Archivs für einen Job zum Abrufen von Archiven. Für Inventarabrufaufträge ist dieses Feld `null`. *Typ:* Zeichenfolge **ArchiveSizeInBytes** Für einen `ArchiveRetrieval`-Auftrag ist dies die Größe in Bytes des zum Herunterladen angeforderten Archivs. Für den `InventoryRetrieval`-Auftrag ist der Wert `null`. *Typ*: Zahl **Completed** Der Auftragsstatus. Wenn ein Archiv- oder Inventarabrufauftrag abgeschlossen wurde, können Sie die Ausgabe des Auftrags über [Get Job Output (GET output)](api-job-output-get.md) abrufen. *Typ*: Boolesch **CompletionDate** Uhrzeit der Fertigstellung der Auftragsanforderung in UTC (Universal Coordinated Time). Während der Auftrag in Bearbeitung ist, ist der Wert Null. *Typ:* Zeichenfolge **CreationDate** Der Zeitpunkt (UTC) der Erstellung des Auftrags. *Typ*: Eine Zeichenfolgendarstellung im ISO 8601-Datumsformat, z. B. `2013-03-20T17:03:43.221Z`. **InventoryRetrievalParameters** Die Eingabeparameter für die Inventarabfrage für einzelne Bereiche *Typ*: [InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md) Objekt **InventorySizeInBytes** Für einen `InventoryRetrieval`-Auftrag ist dies die Größe in Bytes des zum Herunterladen angeforderten Inventars. Für den `ArchiveRetrieval`- oder `Select`-Auftrag ist der Wert `null`. *Typ*: Zahl **JobDescription** Die Auftragsbeschreibung, die Sie bei der Initiierung des Auftrags angegeben haben. *Typ:* Zeichenfolge **JobId** Die ID, die den Job in Amazon Glacier identifiziert. *Typ:* Zeichenfolge **JobOutputPath** Enthält den Speicherort für die Auftragsausgabe. *Typ:* Zeichenfolge **OutputLocation** Ein Objekt, das Informationen zum Speicherort der Ergebnisse und Fehler des ausgewählten Jobs enthält *Typ*: [OutputLocation](api-OutputLocation.md) Objekt **RetrievalByteRange** Der abgerufene Bytebereich für Jobs zum Abrufen von Archiven in der Form "*StartByteValue*-“*EndByteValue*. Wenn Sie beim Archivabruf keinen Bereich angeben, wird das gesamte Archiv abgerufen. Dies *StartByteValue*entspricht ebenfalls 0 und *EndByteValue*entspricht der Größe des Archivs minus 1. Für Inventarabruf- und Auswahlaufträge ist dieses Feld `null`. *Typ:* Zeichenfolge **SelectParameters** Ein Objekt mit Informationen zu den Parametern für eine Auswahl *Typ*: [SelectParameters](api-SelectParameters.md) Objekt **SHA256TreeHash** Der SHA256 Struktur-Hashwert für den angeforderten Bereich eines Archivs. Wenn in der [Initiate Job (POST jobs)](api-initiate-job-post.md)-Anfrage für ein Archiv ein mit dem Struktur-Hash abgeglichener Bereich angegeben wurde, gibt dieses Feld einen Wert zurück. Weitere Informationen zur Verwendung von mit dem Struktur-Hash abgeglichenen Bereichen beim Abrufen von Archivbereichen finden Sie unter [Erhalten von Prüfsummen bei Daten-Download](checksum-calculations-range.md). Wenn das gesamte Archiv abgerufen wird, ist dieser Wert mit dem `ArchiveSHA256TreeHash`-Wert identisch. In den folgenden Situationen hat dieses Feld den Wert `null`. + Aufträge zum Abruf von Archiven, die einen Bereich angeben, der nicht mit dem Struktur-Hash abgeglichen ist. + Archivaufträge, die einen Bereich festlegen, der das gesamte Archiv einschließt, und deren Auftragsstatus `InProgress` lautet. + Inventaraufträge. + Wählen Sie die Aufträge aus. *Typ:* Zeichenfolge **SNSTopic** Ein Amazon-SNS-Thema, das Benachrichtigungen empfängt *Typ:* Zeichenfolge **StatusCode** Der Code, der den Status des Auftrags angibt *Zulässige Werte*: `InProgress` \$1 `Succeeded` \$1 `Failed` *Typ:* Zeichenfolge **StatusMessage** Eine freundliche Nachricht, die den Auftragsstatus beschreibt. *Typ:* Zeichenfolge **Stufe** Das Datenzugriffskontingent, das für die Auswahl oder den Archivabruf verwendet wird *Zulässige Werte*: `Bulk` \$1 `Expedited` \$1 `Standard` *Typ:* Zeichenfolge **VaultARN** Der Amazon-Ressourcennamen (ARN) des Tresors, von dem der Auftrag eine Unterressource ist. *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. ### Beispielanfrage: Auftragsbeschreibung abrufen ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 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 Der Antworttext enthält JSON zur Beschreibung des angegebenen Auftrags. Beachten Sie, dass für den Inventarabruf und für den Archivabruf die JSON-Felder gleich sind. Wenn jedoch ein Feld für den Auftragstyp nicht gültig ist, ist sein Wert `null`. Es folgt eine Beispielantwort auf einen Archivabrufauftrag. Beachten Sie Folgendes: + Der Wert des `Action`-Felds ist `ArchiveRetrieval`. + Das `ArchiveSizeInBytes`-Feld zeigt die Größe des im Archivabrufauftrag angeforderten Archivs. + Das `ArchiveSHA256TreeHash` Feld zeigt den SHA256 Baumhash für das gesamte Archiv. + Das `RetrievalByteRange`-Feld zeigt den in der Anfrage zur Auftragsinitiierung angeforderten Bereich. In diesem Beispiel wird das gesamte Archiv angefordert. + Das `SHA256TreeHash` Feld zeigt den SHA256 Baumhash für den Bereich, der in der Anfrage „Job initiieren“ angefordert wurde. In diesem Beispiel ist es gleich dem `ArchiveSHA256TreeHash`-Feld, das heißt, dass das gesamte Archiv angefordert wurde. + Der Wert des `InventorySizeInBytes`-Felds ist `null`, weil es für einen Archivabrufauftrag nicht gültig ist. ``` 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: 419 6. { 7. "Action": "ArchiveRetrieval", 8. "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", 9. "ArchiveSizeInBytes": 16777216, 10. "ArchiveSHA256TreeHash": "beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60", 11. "Completed": false, 12. "CompletionDate": null, 13. "CreationDate": "2012-05-15T17:21:39.339Z", 14. "InventorySizeInBytes": null, 15. "JobDescription": "My ArchiveRetrieval Job", 16. "JobId": "HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID", 17. "RetrievalByteRange": "0-16777215", 18. "SHA256TreeHash": "beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60", 19. "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic", 20. "StatusCode": "InProgress", 21. "StatusMessage": "Operation in progress.", 22. "Tier": "Bulk", 23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 24. } ``` Es folgt eine Beispielantwort auf einen Inventarabrufauftrag. Beachten Sie Folgendes: + Der Wert des `Action`-Felds ist `InventoryRetrieval`. + Die Werte der Felder `ArchiveSizeInBytes`, `ArchiveSHA256TreeHash` und `RetrievalByteRange` sind Null, weil diese Felder für einen Inventarabrufauftrag nicht gültig sind. + Der Wert des `InventorySizeInBytes`-Felds ist `null`, weil der Auftrag noch in Bearbeitung ist und das Inventar noch nicht vollständig zum Herunterladen vorbereitet hat. Wenn der Auftrag vor Ihrer Anforderung zur Auftragsbeschreibung abgeschlossen war, zeigt dieses Feld Ihnen die Größe der Ausgabe an. ``` { "Action": "InventoryRetrieval", "ArchiveId": null, "ArchiveSizeInBytes": null, "ArchiveSHA256TreeHash": null, "Completed": false, "CompletionDate": null, "CreationDate": "2012-05-15T23:18:13.224Z", "InventorySizeInBytes": null, "JobDescription": "Inventory Description", "JobId": "HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID", "RetrievalByteRange": null, "SHA256TreeHash": null, "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic", "StatusCode": "InProgress", "StatusMessage": "Operation in progress.", "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" } ``` Es folgt eine Beispielantwort auf einen abgeschlossenen Bestandsabrufauftrag mit einer Markierung, durch die die Paginierung des Tresorinventarabrufs fortgesetzt wird. ``` { "Action": "InventoryRetrieval", "ArchiveId": null, "ArchiveSHA256TreeHash": null, "ArchiveSizeInBytes": null, "Completed": true, "CompletionDate": "2013-12-05T21:51:13.591Z", "CreationDate": "2013-12-05T21:51:12.281Z", "InventorySizeInBytes": 777062, "JobDescription": null, "JobId": "sCC2RZNBF2nildYD_roe0J9bHRdPQUbDRkmTdg-mXi2u3lc49uW6TcEhDF2D9pB2phx-BN30JaBru7PMyOlfXHdStzu8", "NextInventoryRetrievalMarker": null, "RetrievalByteRange": null, "SHA256TreeHash": null, "SNSTopic": null, "StatusCode": "Succeeded", "StatusMessage": "Succeeded", "Tier": "Bulk", "VaultARN": "arn:aws:glacier-devo:us-west-2:836579025725:vaults/inventory-icecube-2", "InventoryRetrievalParameters": { "StartDate": "2013-11-12T13:43:12Z", "EndDate": "2013-11-20T08:12:45Z", "Limit": "120000", "Format": "JSON", "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" }, } ``` ## Zugehörige Abschnitte + [Get Job Output (GET output)](api-job-output-get.md) + [Identity and Access Management für Amazon Glacier](security-iam.md) # 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) # Initiate Job (POST jobs) Dieser Vorgang initiiert die folgenden Typen von Amazon Glacier-Aufträgen (Amazon Glacier): + `archive-retrieval`: Ein Archiv abrufen + `inventory-retrieval`: Bestand eines Tresors erfassen **Topics** + [Initiieren eines Archiv- oder Tresorbestandsabrufs](#api-initiate-job-post-description) + [Anforderungen](#api-initiate-job-post-requests) + [Antworten](#api-initiate-job-post-responses) + [Beispiele](#api-initiate-job-post-examples) + [Zugehörige Abschnitte](#more-info-api-initiate-job-post) ## Initiieren eines Archiv- oder Tresorbestandsabrufs Das Abrufen eines Archivs oder des Tresorbestands ist ein asynchroner Vorgang, für den Sie einen Auftrag initiieren müssen. Nach dem Start kann die Aufgabe nicht abgebrochen werden. Das Abrufen erfolgt in zwei Schritten: 1. Initiieren Sie einen Abrufauftrag mit der Operation [Initiate Job (POST jobs)](#api-initiate-job-post). **Wichtig** Eine Richtlinie für den Datenabruf kann dazu führen, dass die Anforderung zur Abrufinitiierung zu einer `PolicyEnforcedException`-Ausnahme führt und fehlschlägt. Weitere Informationen zu Datenabrufrichtlinien finden Sie unter [Amazon Glacier-Richtlinien für den Datenabruf](data-retrieval-policy.md). Weitere Informationen zur `PolicyEnforcedException`-Ausnahme finden Sie unter [Fehlermeldungen](api-error-responses.md). 1. Laden Sie nach Abschluss des Auftrags die Bytes mit der Operation [Get Job Output (GET output)](api-job-output-get.md) herunter. Die Abrufanforderung wird asynchron ausgeführt. Wenn Sie einen Abrufauftrag initiieren, erstellt Amazon Glacier einen Auftrag und gibt eine Auftrags-ID in der Antwort zurück. Wenn Amazon Glacier den Auftrag abgeschlossen hat, können Sie die Auftragsausgabe (Archiv- oder Inventardaten) abrufen. Weitere Informationen über das Abrufen der Auftragsausgabe finden Sie in den Hinweisen zum [Get Job Output (GET output)](api-job-output-get.md)-Vorgang. Der Auftrag muss abgeschlossen sein, bevor Sie die Ausgabe abrufen können. Verwenden Sie eine der folgenden Optionen, um festzustellen, wann ein Auftrag abgeschlossen ist: + **Eine Amazon SNS SNS-Benachrichtigung verwenden —** Sie können ein Amazon SNS SNS-Thema angeben, zu dem Amazon Glacier nach Abschluss des Auftrags eine Benachrichtigung veröffentlichen kann. Geben Sie dazu ein SNS-Thema für jede Auftragsanforderung an. Die Benachrichtigung wird erst gesendet, nachdem Amazon Glacier den Auftrag abgeschlossen hat. Zusätzlich zur Angabe eines SNS-Themas für jede Auftragsanforderung können Sie Tresorbenachrichtigungen für einen Tresor konfigurieren, sodass Auftragsbenachrichtigungen für alle Abrufvorgänge gesendet werden. Weitere Informationen finden Sie unter [Set Vault Notification Configuration (PUT notification-configuration)](api-vault-notifications-put.md). + **Auftragsdetails abrufen**: Sie können eine [Describe Job (GET JobID)](api-describe-job-get.md)-Anforderung senden, um Informationen zum Auftragsstatus zu erhalten, während der Auftrag noch ausgeführt wird. Es ist jedoch effizienter, wenn Sie sich durch eine Amazon-SNS-Benachrichtigung darüber informieren lassen, dass ein Auftrag abgeschlossen ist. **Anmerkung** Die Informationen, die Sie in der Benachrichtigung erhalten, sind identisch mit den Informationen, die durch den [Describe Job (GET JobID)](api-describe-job-get.md)-Aufruf ermittelt werden. Wenn Sie für ein bestimmtes Ereignis sowohl die Benachrichtigungskonfiguration im Tresor hinzufügen als auch ein SNS-Thema in Ihrer Job-Initiation-Anfrage angeben, sendet Amazon Glacier beide Benachrichtigungen. Weitere Informationen finden Sie unter [Set Vault Notification Configuration (PUT notification-configuration)](api-vault-notifications-put.md). ### Die Inventarliste des Tresors Amazon Glacier aktualisiert ein Tresorinventar ungefähr einmal täglich, beginnend mit dem Tag, an dem Sie ein Archiv zum ersten Mal in den Tresor hochladen. Wenn dem Tresor seit der letzten Inventur keine Archive hinzugefügt oder aus ihm gelöscht wurden, wird das Inventurdatum nicht aktualisiert. Wenn Sie einen Job für ein Tresorinventar initiieren, gibt Amazon Glacier das zuletzt generierte Inventar zurück. Dabei handelt es sich um einen point-in-time Snapshot und nicht um Echtzeitdaten. Nachdem Amazon Glacier das erste Inventar für den Tresor erstellt hat, dauert es in der Regel einen halben Tag und bis zu einem Tag, bis dieses Inventar abgerufen werden kann. Möglicherweise finden Sie es nicht nützlich, einen Tresorbestand für jeden Archiv-Upload abzurufen. Nehmen wir jedoch an, dass Sie auf der Clientseite eine Datenbank verwalten, die Metadaten zu den Archiven verknüpft, die Sie auf Amazon Glacier hochladen. Dann finden Sie es möglicherweise nützlich, wenn die Tresorinventur die Informationen in Ihrer Datenbank nach Bedarf mit dem aktuellen Tresorbestand abgleicht. Weitere Informationen über die Datenfelder, die bei einer Inventarabfrage zurückgegeben werden, finden Sie unter [Antworttext](api-job-output-get.md#api-job-output-get-responses-elements). ### Inventarabfrage für einzelne Bereiche Sie können die Anzahl der abgerufenen Tresorbestandselemente beschränken, indem Sie nach dem Archiverstellungsdatum filtern oder ein Limit festlegen. **Filtern nach dem Archiverstellungsdatum** Sie können Inventarelemente für Archive abrufen, die zwischen dem `StartDate` und dem `EndDate` erstellt wurden, indem Sie die Werte für diese Parameter in der **Initiate Job**-Anforderung angeben. Dadurch werden Archive zurückgegeben, die am oder nach dem `StartDate` und vor dem `EndDate` erstellt wurden. Wenn Sie nur das `StartDate` ohne das `EndDate` angeben, wird die Inventarliste für alle Archive abgerufen, die am oder nach dem `StartDate` erstellt wurden. Wenn Sie nur das `EndDate` ohne das `StartDate` angeben, wird die Inventarliste für alle Archive erstellt, die vor dem `EndDate` erstellt wurden. **Beschränken der Inventarelemente für einzelne Abrufvorgänge** Sie können die Anzahl der zurückgegebenen Inventarelemente beschränken, indem Sie den `Limit`-Parameter in der **Initiate Job**-Anforderung festlegen. Die Ausgabe für den Inventarauftrag enthält Inventarelemente bis zum festgelegten `Limit`. Wenn mehr Inventarelemente vorhanden sind, wird das Ergebnis paginiert. Nachdem ein Auftrag abgeschlossen ist, können Sie mithilfe der [Describe Job (GET JobID)](api-describe-job-get.md)-Operation eine Markierung abrufen, die Sie für eine nachfolgende **Initiate Job**-Anforderung verwenden können. Die Markierung kennzeichnet den Startpunkt, ab dem die nächste Gruppe der Inventarelemente abgerufen wird. Sie können durch das gesamte Inventar blättern, indem Sie wiederholt **Initiate Job**-Anforderungen mit der Markierung aus der vorherigen **Describe Job**-Ausgabe ausführen. Verfahren Sie so, bis eine Markierung von **Describe Job** mit Null zurückgegeben wird. Dies bedeutet, dass keine Inventarelemente mehr verfügbar sind. Sie können die `Limit`-Parameter zusammen mit den Datenbereichsparametern verwenden. ### Abrufen eines Archivbereichs Sie können den Abrufvorgang für das gesamte Archiv oder einen Bereich des Archivs initiieren. Beim Abrufen von Archivbereichen haben Sie die Möglichkeit einen Bytebereich anzugeben oder das gesamte Archiv abzurufen. Der Bereich muss in Megabytewerten (MB) angegeben werden. Das bedeutet, der Startwert muss 1 MB oder ein Vielfaches davon sein und der Bereichsendwert plus 1 muss durch 1 MB teilbar sein oder dem Ende des Archivs entsprechen. Wenn beim Abrufen eines Archivbereichs keine ganzen Megabytewerte angegeben werden, wird als Antwort `400` zurückgegeben. Um sicherzustellen, dass Sie Prüfsummenwerte für Daten erhalten, die Sie mit der Funktion **Get Job Output** ([Get Job Output (GET output)](api-job-output-get.md)) herunterladen, muss der Bereich mit dem Struktur-Hash abgeglichen sein. Weitere Informationen zum Abgleichen von Bereichen mit dem Struktur-Hash finden Sie unter [Erhalten von Prüfsummen bei Daten-Download](checksum-calculations-range.md). ### Expedited-, Standard- und Bulk-Kontingente Beim Initiieren eines Archivabrufauftrags können Sie eine der folgenden Optionen im Feld `Tier` des Anforderungstexts angeben: + **`Expedited`** – „Expedited“-Abrufe ermöglichen Ihnen den schnellen Zugriff auf Ihre Daten, wenn gelegentliche dringende Anforderungen zum Wiederherstellen von Archiven erforderlich sind. Daten, die unter Verwendung des "Expedited"-Kontingents abgerufen werden, stehen normalerweise innerhalb von 1 bis 5 Minuten zur Verfügung, außer wenn es sich um sehr große Archive (250 MB und mehr) handelt. + **`Standard`** – Mit „Standard“-Abrufen können Sie innerhalb von mehreren Stunden auf jedes Ihrer Archive zugreifen. Daten, die über das Standardkontingent abgerufen werden, sind in der Regel innerhalb von drei bis fünf Stunden verfügbar. Diese Option ist für Auftragsanforderungen, für die kein Kontingent angegeben wird, das Standardkontingent. + **`Bulk`**— Bulk ist die kostengünstigste Stufe für Amazon Glacier, mit der Sie große Datenmengen, sogar Petabyte, kostengünstig an einem Tag abrufen können. Daten, die über das Bulk-Kontingent abgerufen werden, sind in der Regel innerhalb von 5 bis 12 Stunden verfügbar. Weitere Informationen zu Expedited- und Bulk-Abrufen finden Sie unter [Amazon Glacier-Archive abrufen](downloading-an-archive-two-steps.md). ## Anforderungen Verwenden Sie zum Initiieren eines Auftrags die HTTP-`POST`-Methode und beschränken Sie den Umfang der Anforderung auf die `jobs`-Unterressource des Tresors. Sie legen die Details der Auftragsanforderung im JSON-Dokument für Ihre Anforderung fest. Der Auftragstyp wird im Feld `Type` angegeben. Optional können Sie ein `SNSTopic` Feld angeben, um ein Amazon SNS SNS-Thema anzugeben, zu dem Amazon Glacier nach Abschluss des Auftrags eine Benachrichtigung senden kann. **Anmerkung** Damit eine Benachrichtigung an Amazon SNS übermittelt wird, müssen Sie das Thema selbst erstellen, falls es noch nicht vorhanden ist. Amazon Glacier erstellt das Thema nicht für Sie. Das Thema muss über Berechtigungen zum Empfangen von Veröffentlichungen aus einem Amazon Glacier-Tresor verfügen. Amazon Glacier überprüft nicht, ob der Tresor berechtigt ist, das Thema zu veröffentlichen. Wenn die Berechtigungen nicht ordnungsgemäß konfiguriert sind, erhalten Sie unter Umständen selbst nach Beendigung des Auftrags keine Benachrichtigung. ### Syntax Nachfolgend sehen Sie die Anforderungssyntax für das Initiieren eines Auftrags. ``` 1. POST /AccountId/vaults/VaultName/jobs HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. x-amz-glacier-version: 2012-06-01 6. 7. { 8. "jobParameters": { 9. "ArchiveId": "string", 10. "Description": "string", 11. "Format": "string", 12. "InventoryRetrievalParameters": { 13. "EndDate": "string", 14. "Limit": "string", 15. "Marker": "string", 16. "StartDate": "string" 17. }, 18. "OutputLocation": { 19. "S3": { 20. "AccessControlList": [ 21. { 22. "Grantee": { 23. "DisplayName": "string", 24. "EmailAddress": "string", 25. "ID": "string", 26. "Type": "string", 27. "URI": "string" 28. }, 29. "Permission": "string" 30. } 31. ], 32. "BucketName": "string", 33. "CannedACL": "string", 34. "Encryption": { 35. "EncryptionType": "string", 36. "KMSContext": "string", 37. "KMSKeyId": "string" 38. }, 39. "Prefix": "string", 40. "StorageClass": "string", 41. "Tagging": { 42. "string" : "string" 43. }, 44. "UserMetadata": { 45. "string" : "string" 46. } 47. } 48. }, 49. "RetrievalByteRange": "string", 50. "SelectParameters": { 51. "Expression": "string", 52. "ExpressionType": "string", 53. "InputSerialization": { 54. "csv": { 55. "Comments": "string", 56. "FieldDelimiter": "string", 57. "FileHeaderInfo": "string", 58. "QuoteCharacter": "string", 59. "QuoteEscapeCharacter": "string", 60. "RecordDelimiter": "string" 61. } 62. }, 63. "OutputSerialization": { 64. "csv": { 65. "FieldDelimiter": "string", 66. "QuoteCharacter": "string", 67. "QuoteEscapeCharacter": "string", 68. "QuoteFields": "string", 69. "RecordDelimiter": "string" 70. } 71. } 72. }, 73. "SNSTopic": "string", 74. "Tier": "string", 75. "Type": "string" 76. } 77. } ``` **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 diese keine Bindestriche („-“) enthalten. ### Anforderungstext Die Anforderung akzeptiert die folgenden Daten im JSON-Format im Text der Anforderung. jobParameters Bietet Optionen für die Angabe von Auftragsinformationen. *Typ*: [jobParameters](api-jobParameters.md) Objekt *Erforderlich*: Ja ## Antworten Amazon Glacier schafft den Job. In der Antwort wird der URI des Auftrags zurückgegeben. ### Syntax ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Location: location 5. x-amz-job-id: jobId 6. x-amz-job-output-path: jobOutputPath ``` ### Antwort-Header | Header | Description | | --- | --- | | Location | Der relative URI-Pfad des Auftrags. Sie können diesen URI-Pfad verwenden, um den Auftragsstatus zu ermitteln. Weitere Informationen finden Sie unter [Describe Job (GET JobID)](api-describe-job-get.md). Typ: Zeichenfolge Standard: keiner | | x-amz-job-id | Die ID des Auftrags. Dieser Wert wird ebenfalls als Teil des `Location`-Headers angegeben. Typ: Zeichenfolge Standard: keiner | | x-amz-job-output-path | Der Pfad des Speicherorts, an dem die Auswahlergebnisse gespeichert werden Typ: Zeichenfolge Standard: keiner | ### Antworttext Dieser Vorgang gibt keinen Antworttext zurück. ### Fehler Dieser Vorgang umfasst zusätzlich zu den möglichen Fehlern, die allen Amazon Glacier-Vorgängen gemeinsam sind, die folgenden Fehler oder Fehler. Informationen zu Amazon Glacier-Fehlern und eine Liste der Fehlercodes finden Sie unter[Fehlermeldungen](api-error-responses.md). | Code | Description | HTTP-Statuscode | Typ | | --- | --- | --- | --- | | InsufficientCapacityException | Wird zurückgegeben, wenn die vorhandene Kapazität nicht ausreicht, um diese beschleunigte Anforderung zu verarbeiten. Dieser Fehler gilt nur für beschleunigte Abrufe und nicht für Standard- oder Massenabrufe. | 503 Service Unavailable | Server | ## Beispiele ### Beispielanforderung: Initiieren eines Auftrags zum Abrufen eines Archivs ``` 1. POST /-/vaults/examplevault/jobs 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 6. 7. { 8. "Type": "archive-retrieval", 9. "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", 10. "Description": "My archive description", 11. "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-ArchiveRetrieval-topic-Example", 12. "Tier" : "Bulk" 13. } ``` Das folgende Beispiel zeigt den Text einer Anforderung, durch die ein abzurufender Archivbereich mithilfe des `RetrievalByteRange`-Feldes festgelegt wird. ``` { "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" } ``` ### Beispielantwort ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID ``` ### Beispielanforderung: Initiieren eines Auftrags zum Abrufen des Inventars Die folgende Anforderung initiiert einen Auftrag für eine Inventarabfrage, durch die eine Liste der Archive im `examplevault`-Tresor angefordert wird. Da das `Format` im Text der Anforderung auf `CSV` festgelegt ist, wird das Inventar im CSV-Format zurückgegeben. ``` 1. POST /-/vaults/examplevault/jobs HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. Content-Type: application/x-www-form-urlencoded 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 7. 8. { 9. "Type": "inventory-retrieval", 10. "Description": "My inventory job", 11. "Format": "CSV", 12. "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-InventoryRetrieval-topic-Example" 13. } ``` ### Beispielantwort ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID ``` ### Beispielanforderungen: Initiieren eines Inventarabrufs unter Verwendung von Datenfiltern mit festem Limit und einer Folgeanforderung zum Abrufen der nächsten Seite der Inventarelemente Die folgende Anforderung initiiert einen Auftrag zum Abrufen des Tresorbestands durch Filtern der Daten und Festlegen eines Limits. ``` 1. { 2. "ArchiveId": null, 3. "Description": null, 4. "Format": "CSV", 5. "RetrievalByteRange": null, 6. "SNSTopic": null, 7. "Type": "inventory-retrieval", 8. "InventoryRetrievalParameters": { 9. "StartDate": "2013-12-04T21:25:42Z", 10. "EndDate": "2013-12-05T21:25:42Z", 11. "Limit" : "10000" 12. }, 13. } ``` Die folgende Anforderung ist ein Beispiel für eine Folgeanforderung zum Abrufen der nächsten Seite der Inventarelemente mithilfe einer Markierung, die durch [Describe Job (GET JobID)](api-describe-job-get.md) übermittelt wurde. ``` 1. { 2. "ArchiveId": null, 3. "Description": null, 4. "Format": "CSV", 5. "RetrievalByteRange": null, 6. "SNSTopic": null, 7. "Type": "inventory-retrieval", 8. "InventoryRetrievalParameters": { 9. "StartDate": "2013-12-04T21:25:42Z", 10. "EndDate": "2013-12-05T21:25:42Z", 11. "Limit": "10000", 12. "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" 13. }, 14. } ``` ### Beispielantwort ``` 1. HTTP/1.1 202 Accepted 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Location: /111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 5. x-amz-job-id: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 6. x-amz-job-output-path: test/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/ ``` ## Zugehörige Abschnitte + [Describe Job (GET JobID)](api-describe-job-get.md) + [Get Job Output (GET output)](api-job-output-get.md) + [Identity and Access Management für Amazon Glacier](security-iam.md) # Aufträge auflisten (GET jobs) ## Description Durch diese Operation wird eine Liste der Aufträge für einen Tresor erstellt, einschließlich der Aufträge, die gerade ausgeführt werden, und der vor kurzem abgeschlossenen Aufträge. **Anmerkung** Amazon Glacier (Amazon Glacier) speichert kürzlich abgeschlossene Jobs für einen bestimmten Zeitraum, bevor sie gelöscht werden. Schließlich werden jedoch abgeschlossene Jobs entfernt. Die Ausgabe der abgeschlossenen Aufträge kann abgerufen werden. Da abgeschlossene Aufträge nicht sofort entfernt werden, haben Sie die Möglichkeit, die Auftragsausgabe auch dann noch herunterzuladen, wenn Sie die Benachrichtigung über den Abschluss des Auftrags verpasst haben oder wenn Ihr erster Versuch, die Daten herunterzuladen, nicht gelingt. Angenommen, Sie starten einen Auftrag zum Abrufen eines Archivs, um ein Archiv herunterzuladen. Sie starten den Download, nachdem der Auftrag abgeschlossen ist, aber gerade in diesem Moment tritt ein Netzwerkfehler auf. Solange der Auftrag noch vorhanden ist, können Sie erneut versuchen, das Archiv herunterzuladen. Die `List Jobs`-Operation unterstützt Paginierung. Sie sollten immer das `Marker`-Antwortfeld überprüfen. Wenn keine Aufträge mehr vorhanden sind, wird das `Marker`-Feld auf `null` gesetzt. Wenn weitere Aufträge aufgeführt werden können, zeigt das `Marker`-Feld einen anderen Wert als null an. Sie können diesen Wert verwenden, um die Paginierung der Liste fortzusetzen. Wenn eine Liste aller Aufträge ab einem bestimmten Auftrag zurückgegeben werden soll, legen Sie den `marker`-Anforderungsparameter auf den `Marker`-Wert fest, den Sie für den entsprechenden Auftrag bei einer vorherigen `List Jobs`-Anforderung ermittelt haben. Mit dem `limit`-Parameter in der Anforderung können Sie eine Höchstgrenze für die Anzahl der Aufträge festlegen, die in der Antwort zurückgegeben werden. Das Standardlimit ist 50. Die Anzahl der zurückgegebenen Aufträge kann kleiner sein als das festgelegte Limit, aber die Anzahl der zurückgegebenen Aufträge überschreitet das Limit nie. Darüber hinaus können Sie die zurückgegebene Auftragsliste filtern, indem Sie wahlweise den Parameter `statuscode` und/oder den Parameter `completed` festlegen. Bei Verwendung des Parameters `statuscode` können Sie weiterhin angeben, dass nur die Aufträge zurückgegeben werden sollen, die einen der folgenden Status aufweisen: `InProgress`, `Succeeded` oder `Failed`. Bei Verwendung des Parameters `completed` können Sie angeben, dass entweder nur abgeschlossene (`true`) oder nur die noch nicht abgeschlossenen Aufträge (`false`) zurückgegeben werden sollen. ## Anforderungen ### Syntax Um eine Liste der Aufträge jedes Typs abzurufen, senden Sie eine `GET`-Anforderung an den URI der `jobs`-Unterressource des Tresors. ``` 1. GET /AccountId/vaults/VaultName/jobs HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. 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 | Name | Description | Erforderlich | | --- | --- | --- | | completed | Der Status der zurückzugebenden Aufträge. Sie können `true` oder `false` angeben. Typ: Boolescher Wert Einschränkungen: Keine | Nein | | limit | Die maximale Anzahl der zurückzugebenden Aufträge. Das Standardlimit ist 50. Die Anzahl der zurückgegebenen Aufträge kann kleiner sein als das festgelegte Limit, aber die Anzahl der zurückgegebenen Aufträge überschreitet das Limit nie. Typ: Zeichenfolge Beschränkungen: Mindestganzzahlwert 1. Höchstganzzahlwert 50. | Nein | | marker | Eine opake Zeichenfolge für die Paginierung, durch die der Auftrag festgelegt wird, mit dem die Liste der Aufträge beginnen soll. Sie können den Wert für `marker` der Antwort auf eine vorherige `List Jobs`-Anforderung entnehmen. Sie müssen `marker` nur dann einschließen, wenn Sie die Paginierung der Ergebnisse fortsetzen, die in einer vorherigen „“-Anforderung gestartet wurde.`List Jobs` Typ: Zeichenfolge Einschränkungen: Keine | Nein | | statuscode | Der Auftragsstatus, der zurückgegeben werden soll. Typ: Zeichenfolge Einschränkungen: Einer der folgenden Werte: `InProgress`, `Succeeded` oder `Failed`. | Nein | ### Anforderungsheader Für diesen Vorgang werden ausschließlich Antwort-Header verwendet, die für die meisten Antworten gelten. Weitere Informationen über allgemeine Antwort-Header finden Sie unter [Allgemeine Antwort-Header](api-common-response-headers.md). ### Anforderungstext Dieser Vorgang besitzt keinen Anforderungstext. ## Antworten ### Syntax ``` HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Location: Location Content-Type: application/json Content-Length: Length { "JobList": [ { "Action": "string", "ArchiveId": "string", "ArchiveSHA256TreeHash": "string", "ArchiveSizeInBytes": number, "Completed": boolean, "CompletionDate": "string", "CreationDate": "string", "InventoryRetrievalParameters": { "EndDate": "string", "Format": "string", "Limit": "string", "Marker": "string", "StartDate": "string" }, "InventorySizeInBytes": number, "JobDescription": "string", "JobId": "string", "JobOutputPath": "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" } } }, "SHA256TreeHash": "string", "SNSTopic": "string", "StatusCode": "string", "StatusMessage": "string", "Tier": "string", "VaultARN": "string" } ], "Marker": "string" } ``` ### Antwort-Header Für diesen Vorgang werden ausschließlich Antwort-Header verwendet, die für die meisten Antworten gelten. Weitere Informationen über allgemeine Antwort-Header finden Sie unter [Allgemeine Antwort-Header](api-common-response-headers.md). ### Antworttext Der Antworttext enthält die folgenden JSON-Felder. **JobList** Eine Liste der Auftragsobjekte. Jedes Auftragsobjekt enthält Metadaten, die den Auftrag beschreiben. *Typ*: Array von [GlacierJobDescription](api-GlacierJobDescription.md)-Objekten **Marker** Eine opake Zeichenfolge, die angibt, wo die Paginierung der Ergebnisse fortgesetzt werden soll. Verwenden Sie den `marker`-Wert in einer neuen ` List Jobs`-Anforderung, um weitere Aufträge in der Liste zu erhalten. Wenn keine weiteren Aufträge vorhanden sind, ist dieser Wert `null`. *Typ:* Zeichenfolge ### Fehler Informationen zu Amazon Glacier-Ausnahmen und Fehlermeldungen finden Sie unter[Fehlermeldungen](api-error-responses.md). ## Beispiele Die folgenden Beispiele zeigen, wie Informationen über Tresoraufträge zurückgegeben werden. Im ersten Beispiel wird eine Liste mit zwei Aufträgen zurückgegeben, während das zweite Beispiel zeigt, wie eine Untermenge von Aufträgen zurückgegeben wird. ### Beispiel: Alle Aufträge zurückgeben #### Beispielanforderung Die folgende `GET`-Anforderung gibt die Aufträge für einen Tresor zurück. ``` 1. GET /-/vaults/examplevault/jobs 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 Die folgende Antwort enthält einen Auftrag zum Abrufen eines Archivs und einen Tresorbestandsabrufauftrag mit einer Markierung, durch die die Paginierung des Tresorbestandsabrufs fortgesetzt wird. Die Antwort zeigt außerdem, dass das `Marker`-Feld auf `null` gesetzt wurde, wodurch angezeigt wird, dass keine weiteren Aufträge vorhanden sind. ``` 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: 1444 6. 7. { 8. "JobList": [ 9. { 10. "Action": "ArchiveRetrieval", 11. "ArchiveId": "BDfaUQul0dVzYwAMr8YSa_6_8abbhZq-i1oT69g8ByClfJyBgAGBkWl2QbF5os851P7Y7KdZDOHWJIn4rh1ZHaOYD3MgFhK_g0oDPesW34uHQoVGwoIqubf6BgUEfQm_wrU4Jlm3cA", 12. "ArchiveSizeInBytes": 1048576, 13. "ArchiveSHA256TreeHash": "25499381569ab2f85e1fd0eb93c5406a178ab77c5933056eb5d6e7d4adda609b", 14. "Completed": true, 15. "CompletionDate": "2012-05-01T00:00:09.304Z", 16. "CreationDate": "2012-05-01T00:00:06.663Z", 17. "InventorySizeInBytes": null, 18. "JobDescription": null, 19. "JobId": "hDe9t9DTHXqFw8sBGpLQQOmIM0-JrGtu1O_YFKLnzQ64548qJc667BRWTwBLZC76Ygy1jHYruqXkdcAhRsh0hYv4eVRU", 20. "RetrievalByteRange": "0-1048575", 21. "SHA256TreeHash": "25499381569ab2f85e1fd0eb93c5406a178ab77c5933056eb5d6e7d4adda609b", 22. "SNSTopic": null, 23. "StatusCode": "Succeeded", 24. "StatusMessage": "Succeeded", 25. "Tier": "Bulk", 26. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 27. }, 28. { 29. "Action": "InventoryRetrieval", 30. "ArchiveId": null, 31. "ArchiveSizeInBytes": null, 32. "ArchiveSHA256TreeHash": null, 33. "Completed": true, 34. "CompletionDate": "2013-05-11T00:25:18.831Z", 35. "CreationDate": "2013-05-11T00:25:14.981Z", 36. "InventorySizeInBytes": 1988, 37. "JobDescription": null, 38. "JobId": "2cvVOnBL36btzyP3pobwIceiaJebM1bx9vZOOUtmNAr0KaVZ4WkWgVjiPldJ73VU7imlm0pnZriBVBebnqaAcirZq_C5", 39. "RetrievalByteRange": null, 40. "SHA256TreeHash": null, 41. "SNSTopic": null, 42. "StatusCode": "Succeeded", 43. "StatusMessage": "Succeeded", 44. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 45. "InventoryRetrievalParameters": { 46. "StartDate": "2013-11-12T13:43:12Z", 47. "EndDate": "2013-11-20T08:12:45Z", 48. "Limit": "120000", 49. "Format": "JSON", 50. "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" 51. } 52. ], 53. "Marker": null 54. } ``` ### Beispiel: Teilliste der Aufträge zurückgeben #### Beispielanforderung Mit der folgenden `GET`-Anforderung wird der Auftrag zurückgegeben, der durch den `marker`-Parameter festgelegt wurde. Wenn der `limit`-Parameter auf gesetzt wird, werden bis zu zwei Aufträge zurückgegeben.`2` ``` 1. GET /-/vaults/examplevault/jobs?marker=HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID&limit=2 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 Die folgende Antwort zeigt zwei zurückgegebene Aufträge und das `Marker`-Feld enthält einen anderen Wert als null. Dieser Wert kann verwendet werden, um die Paginierung der Auftragsliste fortzusetzen. ``` 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: 1744 6. 7. { 8. "JobList": [ 9. { 10. "Action": "ArchiveRetrieval", 11. "ArchiveId": "58-3KpZfcMPUznvMZNPaKyJx9wODCsWTnqcjtx2CjKZ6b-XgxEuA8yvZOYTPQfd7gWR4GRm2XR08gcnWbLV4VPV_kDWtZJKi0TFhKKVPzwrZnA4-FXuIBfViYUIVveeiBE51FO4bvg", 12. "ArchiveSizeInBytes": 8388608, 13. "ArchiveSHA256TreeHash": "106086b256ddf0fedf3d9e72f461d5983a2566247ebe7e1949246bc61359b4f4", 14. "Completed": true, 15. "CompletionDate": "2012-05-01T00:25:20.043Z", 16. "CreationDate": "2012-05-01T00:25:16.344Z", 17. "InventorySizeInBytes": null, 18. "JobDescription": "aaabbbccc", 19. "JobId": "s4MvaNHIh6mOa1f8iY4ioG2921SDPihXxh3Kv0FBX-JbNPctpRvE4c2_BifuhdGLqEhGBNGeB6Ub-JMunR9JoVa8y1hQ", 20. "RetrievalByteRange": "0-8388607", 21. "SHA256TreeHash": "106086b256ddf0fedf3d9e72f461d5983a2566247ebe7e1949246bc61359b4f4", 22. "SNSTopic": null, 23. "StatusCode": "Succeeded", 24. "StatusMessage": "Succeeded", 25. "Tier": "Bulk", 26. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 27. }, 28. { 29. "Action": "ArchiveRetrieval", 30. "ArchiveId": "2NVGpf83U6qB9M2u-Ihh61yoFLRDEoh7YLZWKBn80A2i1xG8uieBwGjAr4RkzOHA0E07ZjtI267R03Z-6Hxd8pyGQkBdciCSH1-Lw63Kx9qKpZbPCdU0uTW_WAdwF6lR6w8iSyKdvw", 31. "ArchiveSizeInBytes": 1048576, 32. "ArchiveSHA256TreeHash": "3d2ae052b2978727e0c51c0a5e32961c6a56650d1f2e4ceccab6472a5ed4a0", 33. "Completed": true, 34. "CompletionDate": "2012-05-01T16:59:48.444Z", 35. "CreationDate": "2012-05-01T16:59:42.977Z", 36. "InventorySizeInBytes": null, 37. "JobDescription": "aaabbbccc", 38. "JobId": "CQ_tf6fOR4jrJCL61Mfk6VM03oY8lmnWK93KK4gLig1UPAbZiN3UV4G_5nq4AfmJHQ_dOMLOX5k8ItFv0wCPN0oaz5dG", 39. "RetrievalByteRange": "0-1048575", 40. "SHA256TreeHash": "3d2ae052b2978727e0c51c0a5e32961c6a56650d1f2e4ceccab6472a5ed4a0", 41. "SNSTopic": null, 42. "StatusCode": "Succeeded", 43. "StatusMessage": "Succeeded", 44. "Tier": "Standard", 45. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 46. } 47. ], 48. "Marker": "CQ_tf6fOR4jrJCL61Mfk6VM03oY8lmnWK93KK4gLig1UPAbZiN3UV4G_5nq4AfmJHQ_dOMLOX5k8ItFv0wCPN0oaz5dG" 49. } ``` ## Zugehörige Abschnitte + [Describe Job (GET JobID)](api-describe-job-get.md) + [Identity and Access Management für Amazon Glacier](security-iam.md)