Diese Seite ist nur für Bestandskunden des S3 Glacier-Dienstes bestimmt, die Vaults und die ursprüngliche REST-API von 2012 verwenden.
Wenn Sie nach Archivspeicherlösungen suchen, empfehlen wir die Verwendung der S3 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 S3 Glacier-Speicherklassen
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 diese mehrteilige Upload-Operation auf, um Amazon S3 Glacier (S3 Glacier) zu informieren, dass alle Archivteile hochgeladen wurden und S3 Glacier das Archiv jetzt aus den hochgeladenen Teilen zusammenstellen kann.
Weitere Informationen über mehrteilige Uploads finden Sie unter Hochladen von großen Archiven in Teilen (Multipart Upload).
Nach der Zusammenstellung und Speicherung des Archivs im Tresor gibt S3 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 S3 Glacier auch den SHA256 Tree-Hash des zusammengestellten Archivs. Wenn die Werte übereinstimmen, speichert S3 Glacier das Archiv im Tresor. Andernfalls wird ein Fehler zurückgegeben und die Operation 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.
Außerdem prüft S3 Glacier auf fehlende Inhaltsbereiche. 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 prüft S3 Glacier auf fehlende Inhaltsbereiche und gibt einen Fehler zurück, wenn fehlende Inhaltsbereiche gefunden wurden. In dem Fall schlägt die „Complete Multipart Upload“-Operation 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
Senden Sie zum Abschließen eines mehrteiligen Uploads eine HTTP-POST-Anforderung an den URI der Upload-ID, die S3 Glacier als Antwort auf Ihre „Initiate Multipart Upload“-Anforderung 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/uploadIDHost: glacier.Region.amazonaws.com Date:dateAuthorization:SignatureValuex-amz-sha256-tree-hash:SHA256 tree hash of the archivex-amz-archive-size:ArchiveSize in bytesx-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 S3 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 SHA256 Tree-Hash des fertig zusammengestellten Archivs übereinstimmt, wie er von S3 Glacier berechnet wurde, gibt S3 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 S3 Glacier (S3 Glacier) erstellt einen SHA256 Baumhash des gesamten Archivs. Wenn der Wert mit dem SHA256 Baumhash des gesamten Archivs übereinstimmt, das Sie in der Anfrage angegeben haben, fügt S3 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 S3 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 S3 Glacier die Upload-ID schließlich 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 umfasst die Archiv-ID, die von S3 Glacier erstellt wird. Typ: Zeichenfolge |
x-amz-archive-id
|
Die ID des Archivs. Dieser Wert wird ebenfalls als Teil des 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 S3 Glacier aus den hochgeladenen Teilen ein Archiv 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.
Zugehörige Abschnitte
