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.

Sie müssen den berechneten SHA256-Struktur-Hash des gesamten hochgeladenen Archivs in die Anfrage einschließen. Weitere Informationen über die Berechnung eines SHA256-Struktur-Hash finden Sie unter Berechnen von Prüfsummen. Auf der Serverseite konstruiert S3 Glacier ebenfalls den SHA256-Struktur-Hash des gesamten 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 üblichen erforderlichen Headern müssen Sie das Ergebnis des SHA256-Struktur-Hashs des gesamten Archivs und die Gesamtgröße des Archivs in Byte einschließen.

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 einen einzelnen Bindestrich („-“) angeben. Bei Angabe eines Bindestrichs verwendet Amazon S3 Glacier die AWS-Konto-ID, die mit den zum Signieren der Anforderung verwendeten Anmeldeinformationen verknüpft ist. Wenn Sie eine Konto-ID verwenden, darf die ID keine Bindestriche („-“) enthalten.

Anfrageparameter

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-Struktur-Hash des gesamten Archivs. Dies ist der Struktur-Hash des SHA256-Struktur-Hashs der einzelnen Teile. Wenn der Wert, den Sie in der Anforderung angeben, nicht mit dem SHA256-Struktur-Hash des endgültig zusammengestellten Archivs übereinstimmt, wie er von S3 Glacier berechnet wurde, gibt S3 Glacier einen Fehler zurück und die Anforderung 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-Struktur-Hash des gesamten Archivs. Wenn der Wert mit dem SHA256-Struktur-Hash des gesamten von Ihnen in der Anforderung angegebenen Archivs übereinstimmt, 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 in der Anforderung gesendete Archivgröße oder der SHA256 nicht übereinstimmt, gibt S3 Glacier einen Fehler zurück und der Upload bleibt in einem nicht abgeschlossenen Status. 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 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. In der Anfrage werden der SHA256-Struktur-Hash des gesamten Archivs und die Gesamtgröße des Archivs angegeben.

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

• Mehrteiligen Upload initiieren (POST multipart uploads)

• Upload Part (PUT uploadID)

• Abort Multipart Upload (DELETE uploadID)

• List Multipart Uploads (GET multipart-uploads)

• List Parts (GET uploadID)

• Hochladen von großen Archiven in Teilen (Multipart Upload)

• Delete Archive (DELETE archive)

• Identitäts- und Zugriffsverwaltung für Amazon S3 Glacier