Complete Multipart Upload (POST uploadID) - Amazon Glacier
BeschreibungAnforderungenAntwortenBeispielZugehörige Abschnitte

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.

Amazon Glacier (ursprünglicher eigenständiger, vault-basierter Service) akzeptiert ab dem 15. Dezember 2025 keine Neukunden mehr, ohne dass dies Auswirkungen auf Bestandskunden hat. 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, 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 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.

Complete Multipart Upload (POST uploadID)

Beschreibung

Sie rufen diesen mehrteiligen Upload-Vorgang auf, um Amazon Glacier (Amazon Glacier) darüber zu informieren, dass alle Archivteile hochgeladen wurden und Amazon Glacier das Archiv nun aus den hochgeladenen Teilen zusammenstellen kann.

Weitere Informationen über mehrteilige Uploads finden Sie unter Hochladen von großen Archiven in Teilen (Multipart Upload).

Nach dem Zusammenstellen und Speichern des Archivs im Tresor gibt Amazon Glacier die Archiv-ID der neu erstellten Archivressource zurück. Nachdem Sie ein Archiv hochgeladen haben, sollten Sie die zurückgegebene Archiv-ID speichern, um das Archiv an einem späteren Zeitpunkt abrufen zu können.

In der Anfrage müssen Sie den berechneten SHA256 Baumhash des gesamten Archivs angeben, das Sie hochgeladen haben. Hinweise zur Berechnung eines SHA256 Baumhashs finden Sie unterBerechnen von Prüfsummen. Auf der Serverseite erstellt Amazon Glacier auch den SHA256 Tree-Hash des zusammengestellten Archivs. Wenn die Werte übereinstimmen, speichert Amazon Glacier das Archiv im Tresor. Andernfalls wird ein Fehler zurückgegeben und der Vorgang schlägt fehl. Die List Parts (GET uploadID)-Operation gibt eine Liste der hochgeladenen Teile für einen bestimmten mehrteiligen Upload zurück. Sie enthält die Prüfsummeninformationen für jeden hochgeladenen Teil, die zum Debuggen eines Problems mit einer falschen Prüfsumme genutzt werden können.

Darüber hinaus sucht Amazon Glacier auch nach fehlenden Inhaltsbereichen. Beim Upload von Teilen geben Sie Bereichswerte an, die bestimmen, wie die Teile in der endgültigen Zusammenstellung des Archivs zusammenpassen. Beim Zusammenstellen des endgültigen Archivs sucht Amazon Glacier nach fehlenden Inhaltsbereichen und ob Inhaltsbereiche fehlen, gibt Amazon Glacier einen Fehler zurück und der Vorgang Complete Multipart Upload schlägt fehl.

Die „Complete Multipart Upload“-Operation ist idempotent. Wenn Sie die Operation innerhalb von kurzer Zeit nach der ersten erfolgreichen „Complete Multipart Upload“-Operation erneut aufrufen, ist diese Operation erfolgreich und gibt die gleiche Archiv-ID zurück. Dies ist bei Netzwerkproblemen oder einem 500-Serverfehler nützlich, da Sie die „Complete Multipart Upload“-Anforderung in diesem Fall wiederholen können und die gleiche Archiv-ID erhalten, ohne doppelte Archive erstellen zu müssen. Beachten Sie jedoch, dass Sie die „List Parts“-Operation nach Abschluss des mehrteiligen Uploads nicht aufrufen können, und der mehrteilige Upload nicht in der „List Multipart Uploads“-Antwort angezeigt wird. Dies ist auch dann der Fall, wenn ein idempotenter Abschluss möglich ist.

Anforderungen

Um einen mehrteiligen Upload abzuschließen, senden Sie eine HTTP-POST-Anforderung an die URI der Upload-ID, die Amazon Glacier als Antwort auf Ihre Anfrage zum Initiate Multipart Upload erstellt hat. Dies ist der gleiche URI, den Sie beim Uploads der Teile verwendet haben. Zusätzlich zu den häufig erforderlichen Headern müssen Sie das Ergebnis des SHA256 Tree-Hashs des gesamten Archivs und die Gesamtgröße des Archivs in Byte angeben.

Syntax

POST /AccountId/vaults/VaultName/multipart-uploads/uploadID
Host: glacier.Region.amazonaws.com
Date: date
Authorization: SignatureValue
x-amz-sha256-tree-hash: SHA256 tree hash of the archive
x-amz-archive-size: ArchiveSize in bytes
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.

Name Beschreibung Erforderlich
x-amz-archive-size

Die Gesamtgröße des gesamten Archivs in Byte. Dieser Wert sollte die Summe aller Größen der einzelnen Teile sein, die Sie hochgeladen haben.

Typ: Zeichenfolge

Standard: keiner

Einschränkungen: Keine

 Ja
x-amz-sha256-tree-hash​

Der SHA256 Baumhash des gesamten Archivs. Es ist der Baumhash des SHA256 Baumhashs der einzelnen Teile. Wenn der Wert, den Sie in der Anfrage angeben, nicht mit dem von Amazon Glacier berechneten SHA256 Baumhash des fertig zusammengestellten Archivs übereinstimmt, gibt Amazon Glacier einen Fehler zurück und die Anfrage schlägt fehl.

Typ: Zeichenfolge

Standard: keiner

Einschränkungen: Keine

 Ja

Anfrage-Elemente

Bei dieser Operation werden keine Anfrageelemente verwendet.

Antworten

Amazon Glacier (Amazon Glacier) erstellt einen SHA256 Baumhash des gesamten Archivs. Wenn der Wert mit dem SHA256 Tree-Hash des gesamten Archivs übereinstimmt, das Sie in der Anfrage angegeben haben, fügt Amazon Glacier das Archiv dem Tresor hinzu. Als Antwort wird der HTTP-Location-Header mit dem URL-Pfad der neu erstellten Archivressource zurückgegeben. Wenn die Archivgröße oder SHA256 die Größe, die Sie in der Anfrage gesendet haben, nicht übereinstimmt, gibt Amazon Glacier einen Fehler zurück und der Upload bleibt unvollständig. Es ist möglich, die „Complete Multipart Upload“-Operation später mit korrekten Werten zu wiederholen. Dann können Sie erfolgreich ein Archiv erstellen. Wenn ein mehrteiliger Upload nicht abgeschlossen wird, fordert Amazon Glacier irgendwann die Upload-ID zurück.

Syntax

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location
x-amz-archive-id: ArchiveId

Antwort-Header

Eine erfolgreiche Antwort umfasst zusätzlich zu den Antwort-Headern, die allen Vorgängen gemeinsam sind, die folgenden Antwort-Header. Weitere Informationen über allgemeine Antwort-Header finden Sie unter Allgemeine Antwort-Header.

Name Beschreibung
Location

Der relative URI-Pfad des neu erstellen Archivs. Diese URL enthält die Archiv-ID, die von Amazon Glacier generiert wird.

Typ: Zeichenfolge
x-amz-archive-id

Die ID des Archivs. Dieser Wert wird ebenfalls als Teil des Location-Headers angegeben.

Typ: Zeichenfolge

Antwortfelder

Dieser Vorgang gibt keinen Antworttext zurück.

Beispiel

Beispielanfrage

In diesem Beispiel wird eine HTTP POST-Anfrage an den URI gesendet, der von einer „Initiate Multipart Upload“-Anfrage zurückgegeben wurde. Die Anfrage gibt sowohl den SHA256 Tree-Hash des gesamten Archivs als auch die Gesamtgröße des Archivs an. 

POST /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
z-amz-Date: 20170210T120000Z
x-amz-sha256-tree-hash:1ffc0f54dd5fdd66b62da70d25edacd0
x-amz-archive-size:8388608
x-amz-glacier-version: 2012-06-01
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 Beispielantwort zeigt, dass Amazon Glacier erfolgreich ein Archiv aus den von Ihnen hochgeladenen Teilen erstellt hat. Die Antwort umfasst die Archiv-ID mit vollständigem Pfad. 

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId

Sie können jetzt HTTP-Anfragen an den URI der neu hinzugefügten Ressource/des Archivs senden. Sie können beispielsweise eine GET-Anfrage senden, um das Archiv abzurufen.