Diese Seite richtet sich nur an Bestandskunden des S3 Glacier-Dienstes, die Vaults und das Original 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.
Upload Part (PUT uploadID)
Beschreibung
Diese mehrteilige Upload-Operation lädt einen Teil eines Archivs hoch. Sie können Teile eines Archivs in beliebiger Reihenfolge hochladen, weil Sie in Ihrer Upload Part-Anfrage den Bytebereich in dem zusammengesetzten Archiv angeben, der in diesem Teil hochgeladen wird. Sie können diese Teile auch parallel hochladen. Sie können bis zu 10 000 Teile für einen mehrteiligen Upload hochladen.
Weitere Informationen über mehrteilige Uploads finden Sie unter Hochladen von großen Archiven in Teilen (Multipart Upload).
Amazon S3 Glacier (S3 Glacier) lehnt Ihre Anforderung zum Hochladen eines Teils ab, wenn eine der folgenden Bedingungen zutrifft:
-
Der SHA256-Struktur-Hash stimmt nicht überein: Um sicherzustellen, dass die Teiledaten bei der Übertragung nicht beschädigt werden, berechnen Sie einen SHA256-Struktur-Hash des Teils und schließen Sie ihn in die Anforderung ein. Beim Empfang der Teiledaten berechnet S3 Glacier ebenfalls einen SHA256-Struktur-Hash. Wenn die beiden Hash-Werte einander nicht entsprechen, schlägt die Operation fehl. Weitere Informationen über die Berechnung eines SHA256-Struktur-Hash finden Sie unter Berechnen von Prüfsummen.
-
Linearer SHA256-Hash stimmt nicht überein: Für die Autorisierung müssen Sie einen linearen SHA256-Hash der gesamten hochgeladenen Nutzlast berechnen und ihn in Ihre Anforderung einschließen. Weitere Informationen über die Berechnung eines linearen SHA256-Hash finden Sie unter Berechnen von Prüfsummen.
-
Größe der Teile stimmt nicht überein: Die Größe jedes Teils mit Ausnahme des letzten muss der Größe entsprechen, die in der entsprechenden Mehrteiligen Upload initiieren (POST multipart uploads)-Anforderung angegeben ist. Die Größe des letzten Teils muss dieselbe Größe wie die angegebene Größe haben oder kleiner sein.
Anmerkung
Wenn Sie einen Teil hochladen, dessen Größe kleiner ist als die Teilegröße, die Sie in Ihrer anfänglichen Anfrage zum mehrteiligen Upload angegeben haben, und dieser Teil nicht der letzte Teil ist, dann wird die Anfrage zum Hochladen des Teils erfolgreich sein. Die folgende Complete Multipart Upload-Anfrage jedoch wird fehlschlagen.
-
Bereich stimmt nicht überein: Der Bytebereichswert in der Anforderung stimmt nicht mit der in der entsprechenden Initialisierungsanforderung angegebenen Teilgröße überein. Wenn Sie beispielsweise eine Teilgröße von 4 194 304 Byte (4 MB) angeben, sind 0 bis 4 194 303 Byte (4 MB-1) und 4 194 304 (4 MB) bis 8 388 607 (8 MB-1) gültige Teilbereiche. Wenn Sie jedoch einen Bereichswert von 2 MB bis 6 MB einrichten, stimmt der Bereich nicht mit der Teilegröße überein und der Upload schlägt fehl.
Dieser Vorgang ist idempotent. Wenn Sie denselben Teil mehrere Male hochladen, überschreiben die Daten in der jüngeren Anfrage die vorher hochgeladenen Daten.
Anforderungen
Die HTTP-PUT-Anforderung wird an den URI der Upload-ID gesendet, die von der „Initiate Multipart Upload“-Anforderung zurückgegeben wurde. S3 Glacier verwendet die Upload-ID, um Teil-Uploads einem bestimmten mehrteiligen Upload zuzuordnen. Die Anfrage muss einen SHA256-Struktur-Hash der Teiledaten enthalten (x-amz-SHA256-tree-hash-Header), einen linearen SHA256-Hash der gesamten Nutzlast (x-amz-content-sha256-Header), den Bytebereich (Content-Range-Header) und die Länge des Teils in Bytes (Content-Length-Header).
Syntax
PUT /AccountId/vaults/VaultName/multipart-uploads/uploadIDHTTP/1.1 Host: glacier.Region.amazonaws.com Date:DateAuthorization:SignatureValueContent-Range:ContentRangeContent-Length:PayloadSizeContent-Type: application/octet-stream x-amz-sha256-tree-hash:Checksum of the partx-amz-content-sha256:Checksum of the entire payloadx-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 |
|---|---|---|
Content-Length
|
Identifiziert die Länge des Teils in Bytes. Typ: Zeichenfolge Standard: keiner Einschränkungen: Keine |
Nein |
Content-Range
|
Identifiziert den Bytebereich im zusammengestellten Archiv, der in diesem Teil hochgeladen wird. S3 Glacier verwendet diese Informationen, um das Archiv in der richtigen Reihenfolge zusammenzustellen. Das Format dieses Headers folgt RFC 2616 Typ: Zeichenfolge Standard: keiner Einschränkungen: Der Bereich darf nicht größer sein als die Teilegröße, die Sie bei der Initiierung des mehrteiligen Uploads angegeben haben. |
Ja |
x-amz-content-sha256
|
Die SHA256-Prüfsumme (ein linearer Hash) für die hochgeladene Nutzlast. Dieser Wert stimmt nicht mit dem im Typ: Zeichenfolge Standard: keiner Einschränkungen: Keine |
Ja |
x-amz-sha256-tree-hash
|
Gibt einen SHA256-Struktur-Hash der Daten an, die hochgeladen werden. Weitere Informationen über die Berechnung eines SHA256-Struktur-Hash finden Sie unter Berechnen von Prüfsummen. Typ: Zeichenfolge Standard: keiner Einschränkungen: Keine |
Ja |
Anforderungstext
Der Anfragetext enthält die hochzuladenden Daten.
Antworten
Bei erfolgreichem Teile-Upload gibt S3 Glacier 204 No Content als Antwort zurück.
Syntax
HTTP/1.1 204 No Content x-amzn-RequestId: x-amzn-RequestId Date: Date x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier
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 |
|---|---|
x-amz-sha256-tree-hash
|
Der SHA256-Struktur-Hash, den S3 Glacier für den hochgeladenen Teil berechnet hat. Typ: Zeichenfolge |
Antworttext
Dieser Vorgang gibt keinen Antworttext zurück.
Beispiel
Mit der folgenden Anfrage wird ein Teil von 4 MB hochgeladen. Die Anfrage stellt den Bytebereich so ein, dass dies der erste Teil im Archiv ist.
Beispielanfrage
Das Beispiel sendet eine HTTP-PUT-Anfrage zum Hochladen eines Teils von 4 MB. Die Anfrage wird an den URI der Upload-ID gesendet, die von der Initiate Multipart Upload-Anfrage zurückgegeben wurde. Der Content-Range-Header identifiziert den Teil als den ersten 4‑MB-Datenteil des Archivs.
PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1 Host: glacier.us-west-2.amazonaws.com Date: Wed, 10 Feb 2017 12:00:00 GMT Content-Range:bytes 0-4194303/* x-amz-sha256-tree-hash:c06f7cd4baacb087002a99a5f48bf953 x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628 Content-Length: 4194304 Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace
Um den nächsten Teil hochzuladen, ist die Vorgehensweise gleich. Sie müssen jedoch einen neuen SHA256-Struktur-Hash für den hochzuladenden Teil berechnen und auch einen neuen Bytebereich angeben, um anzuzeigen, an welche Stelle im fertigen Archiv der Teil gehört. Die folgende Anfrage lädt einen anderen Teil mit derselben Upload-ID hoch. Die Anfrage gibt die nächsten 4 MB des Archivs nach der vorherigen Anfrage und eine Teilegröße von 4 MB an.
PUT /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1 Host: glacier.us-west-2.amazonaws.com Date: Wed, 10 Feb 2017 12:00:00 GMT Content-Range:bytes 4194304-8388607/* Content-Length: 4194304 x-amz-sha256-tree-hash:f10e02544d651e2c3ce90a4307427493 x-amz-content-sha256:726e392cb4d09924dbad1cc0ba3b00c3643d03d14cb4b823e2f041cff612a628 x-amz-glacier-version: 2012-06-01 Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20120525/us-west-2/glacier/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version, Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace
Die Teile können in beliebiger Reihenfolge hochgeladen werden. S3 Glacier verwendet die Bereichsangabe für jeden Teil, um die Reihenfolge zu bestimmen, in der sie zusammengesetzt werden sollen.
Beispielantwort
HTTP/1.1 204 No Content x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q x-amz-sha256-tree-hash: c06f7cd4baacb087002a99a5f48bf953 Date: Wed, 10 Feb 2017 12:00:00 GMT
Zugehörige Abschnitte
