**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. # List Parts (GET uploadID) ## Description Diese mehrteilige Upload-Operation listet die Teile eines Archivs auf, die in einem spezifischen mehrteiligen Upload, der durch eine Upload-ID identifiziert wird, hochgeladen wurde. Weitere Informationen über mehrteilige Uploads finden Sie unter [Hochladen von großen Archiven in Teilen (Multipart Upload)](uploading-archive-mpu.md). Sie können diese Anfrage jederzeit stellen, während ein mehrteiliger Upload in Bearbeitung ist, bevor Sie den mehrteiligen Upload abschließen. Amazon Glacier gibt die Teileliste zurück, sortiert nach dem Bereich, den Sie beim Hochladen jedes Teils angegeben haben. Wenn Sie nach Abschluss des mehrteiligen Uploads eine Anfrage zum Auflisten von Ersatzteilen senden, gibt Amazon Glacier (Amazon Glacier) einen Fehler zurück. Die List Parts-Operation unterstützt Paginierung. Sie sollten immer das Feld `Marker` im Antworttext auf eine Markierung überprüfen, bei der die Liste fortgesetzt werden soll. Wenn keine Elemente mehr vorhanden sind, ist der Wert des Felds `marker` gleich `null`. Wenn der nicht Null `marker` ist, haben Sie zum Abrufen des nächsten Teilesatzes eine weitere List Parts-Anfrage gesendet, wobei der Anforderungsparameter `marker` auf den Markierungswert gesetzt wurde, den Amazon Glacier als Antwort auf Ihre vorherige List Parts-Anfrage zurückgegeben hat. Sie können die in der Antwort zurückgegebene Anzahl der Teile auch begrenzen, indem Sie in der Anfrage den Parameter `limit` angeben. ## Anforderungen ### Syntax Um die Liste der Teile in einem mehrteiligen Upload, der in Bearbeitung ist, aufzulisten, senden Sie eine `GET`-Anfrage an den URI der Ressource mit der ID des mehrteiligen Uploads. Die ID des mehrteiligen Uploads wird zurückgegeben, wenn Sie einen mehrteiligen Upload initiieren ([Mehrteiligen Upload initiieren (POST multipart uploads)](api-multipart-initiate-upload.md)). Sie können optional die Parameter `marker` und `limit` angeben. ``` 1. GET /AccountId/vaults/VaultName/multipart-uploads/uploadID 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 | | --- | --- | --- | | limit | Die maximale Anzahl der zurückzugebenden Teile. Das Standardlimit ist 50. Die Anzahl der zurückgegebenen Teile kann kleiner sein als das festgelegte Limit, aber die Anzahl der zurückgegebenen Teile überschreitet das Limit nie. Typ: Zeichenfolge Beschränkungen: Mindestganzzahlwert `1`. Höchstganzzahlwert `50`. | Nein | | marker | Eine zur Paginierung verwendete opake Zeichenfolge. `marker` gibt den Teil an, mit dem die Auflistung von Teilen beginnen soll. Rufen Sie den `marker`-Wert von der Antwort einer vorherigen List Parts-Antwort ab. Sie müssen den `marker` nur dann einschließen, wenn Sie die Paginierung der Ergebnisse fortsetzen, die in einer vorherigen List Parts-Anfrage gestartet wurde. Typ: Zeichenfolge Einschränkungen: Keine | 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 ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Content-Type: application/json 5. Content-Length: Length 6. 7. { 8. "ArchiveDescription" : String, 9. "CreationDate" : String, 10. "Marker": String, 11. "MultipartUploadId" : String, 12. "PartSizeInBytes" : Number, 13. "Parts" : 14. [ { 15. "RangeInBytes" : String, 16. "SHA256TreeHash" : String 17. }, 18. ... 19. ], 20. "VaultARN" : String 21. } ``` ### 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. **ArchiveDescription** Die Beschreibung des Archivs, die in der Initiate Multipart Upload-Anfrage angegeben wurde. Der Wert dieses Felds ist `null`, wenn in der Initiate Multipart Upload-Operation keine Archivbeschreibung angegeben wurde. *Typ:* Zeichenfolge **CreationDate** Die UTC-Zeit, zu der der mehrteilige Upload initiiert wurde. *Typ:* Zeichenfolge. Eine Zeichenfolgendarstellung im ISO 8601-Datumsformat, zum Beispiel `2013-03-20T17:03:43.221Z`. **Marker** Eine opake Zeichenfolge, die angibt, wo die Paginierung der Ergebnisse fortgesetzt werden soll. Mithilfe des `marker` in einer anderen List Parts-Anfrage erhalten Sie mehr Aufträge in der Liste. Wenn keine anderen Teile vorhanden sind, ist dieser Wert `null`. *Typ:* Zeichenfolge **MultipartUploadId** Die ID des Uploads, zu dem die Teile gehören. *Typ:* Zeichenfolge **PartSizeInBytes** Die Größe des Teils in Bytes. Dies ist derselbe Wert wie der, den Sie in der Initiate Multipart Upload-Anfrage angegeben haben. *Typ*: Zahl **Komponenten** Eine Liste der Teilegrößen des mehrteiligen Uploads. Jedes Objekt im Array enthält ein `RangeBytes` und `sha256-tree-hash` Name-Wert-Paar. *Typ*: Array **RangeInBytes** Der Byte-Bereich eines Teils, einschließlich des oberen Werts des Bereichs. *Typ:* Zeichenfolge **SHA256TreeHash** Der SHA256 Baum-Hash-Wert, den Amazon Glacier für das Teil berechnet hat. Dieses Feld hat niemals den Wert `null`. *Typ:* Zeichenfolge **VaultARN** Der ARN (Amazon-Ressourcenname) des Tresors, für den der mehrteilige Upload initiiert wurde. *Typ:* Zeichenfolge ### Fehler Informationen zu Amazon Glacier-Ausnahmen und Fehlermeldungen finden Sie unter[Fehlermeldungen](api-error-responses.md). ## Beispiele ### Beispiel: Auflisten von Teilen eines mehrteiligen Uploads Im folgenden Beispiel werden alle Teile eines Uploads aufgelistet. In dem Beispiel wird eine HTTP-`GET`-Anfrage an den URI der spezifischen ID des mehrteiligen Uploads gesendet, der in Bearbeitung ist, und es werden bis zu 1 000 Teile zurückgegeben. #### Beispielanforderung ``` 1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE 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 In der Antwort gibt Amazon Glacier eine Liste der hochgeladenen Teile zurück, die der angegebenen mehrteiligen Upload-ID zugeordnet sind. In diesem Beispiel gibt es nur zwei Teile. Der Wert des zurückgegebenen `Marker`-Felds ist `null`. Dadurch wird angezeigt, dass keine Teile des mehrteiligen Uploads mehr 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: 412 6. 7. { 8. "ArchiveDescription" : "archive description", 9. "CreationDate" : "2012-03-20T17:03:43.221Z", 10. "Marker": null, 11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE", 12. "PartSizeInBytes" : 4194304, 13. "Parts" : 14. [ { 15. "RangeInBytes" : "0-4194303", 16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4" 17. }, 18. { 19. "RangeInBytes" : "4194304-8388607", 20. "SHA256TreeHash" : "0195875365afda349fc21c84c099987164" 21. }], 22. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault" 23. } ``` ### Beispiel: Auflisten von Teilen eines mehrteiligen Uploads (Angeben der Parameter Markierung und Limitanfrage) Das folgende Beispiel zeigt, wie Sie Paginierung verwenden können, um eine begrenzte Anzahl von Ergebnissen zu erhalten. In dem Beispiel wird eine HTTP-`GET`-Anfrage an den URI der spezifischen ID eines mehrteiligen Uploads gesendet, der in Bearbeitung ist, um ein Teil zurückzugeben. Ein Start-`marker`-Parameter gibt an, bei welchem Teil die Teileliste startet. Sie können den `marker`-Wert von der Antwort einer vorherigen Anfrage für eine Teileliste abrufen. Darüber hinaus ist der `limit`-Parameter in diesem Beispiel auf 1 eingestellt und es wird ein Teil zurückgegeben. Beachten Sie, dass das `Marker`-Feld nicht `null` ist, was bedeutet, das noch mindestens ein Teil abzurufen ist. #### Beispielanforderung ``` 1. GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 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 In der Antwort gibt Amazon Glacier eine Liste der hochgeladenen Teile zurück, die mit der angegebenen ID für den mehrteiligen Upload in Bearbeitung sind, verknüpft 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: text/json 5. Content-Length: 412 6. 7. { 8. "ArchiveDescription" : "archive description 1", 9. "CreationDate" : "2012-03-20T17:03:43.221Z", 10. "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ", 11. "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE", 12. "PartSizeInBytes" : 4194304, 13. "Parts" : 14. [ { 15. "RangeInBytes" : "4194304-8388607", 16. "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4" 17. }], 18. "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault" 19. } ``` ## Zugehörige Abschnitte + [Mehrteiligen Upload initiieren (POST multipart uploads)](api-multipart-initiate-upload.md) + [Upload Part (PUT uploadID)](api-upload-part.md) + [Complete Multipart Upload (POST uploadID)](api-multipart-complete-upload.md) + [Abort Multipart Upload (DELETE uploadID)](api-multipart-abort-upload.md) + [List Multipart Uploads (GET multipart-uploads)](api-multipart-list-uploads.md) + [Hochladen von großen Archiven in Teilen (Multipart Upload)](uploading-archive-mpu.md) + [Identity and Access Management für Amazon Glacier](security-iam.md)