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 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 Glacier (Amazon Glacier) lehnt Ihre Anfrage zum Hochladen von Ersatzteilen ab, wenn eine der folgenden Bedingungen zutrifft:
-
SHA256 Baum-Hash stimmt nicht überein — Um sicherzustellen, dass die Teildaten bei der Übertragung nicht beschädigt werden, berechnen Sie einen SHA256 Baumhash des Teils und nehmen ihn in Ihre Anfrage auf. Nach Erhalt der Bauteildaten berechnet Amazon Glacier auch einen SHA256 Baumhash. Wenn die beiden Hash-Werte einander nicht entsprechen, schlägt die Operation fehl. Informationen zur Berechnung eines SHA256 Baumhashs finden Sie unterBerechnen von Prüfsummen.
-
SHA256 Linearer Hash stimmt nicht überein — Für die Autorisierung ist dies erforderlich. Sie berechnen einen SHA256 linearen Hash der gesamten hochgeladenen Nutzlast und nehmen ihn in Ihre Anfrage auf. Hinweise zur Berechnung eines SHA256 linearen Hashs finden Sie unterBerechnen 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. Amazon Glacier verwendet die Upload-ID, um Teil-Uploads einem bestimmten mehrteiligen Upload zuzuordnen. Die Anfrage muss einen SHA256 Baumhash der Teildaten (x-amz-SHA256-tree-hashHeader), einen SHA256 linearen Hash der gesamten Nutzlast (x-amz-content-sha256Header), den Bytebereich (Content-RangeHeader) und die Länge des Teils in Byte (Content-LengthHeader) enthalten.
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 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 |
|---|---|---|
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. Amazon 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) der hochgeladenen 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 hochgeladenen Daten an. Hinweise zur Berechnung eines SHA256 Baumhashs finden Sie unterBerechnen von Prüfsummen. Typ: Zeichenfolge Standard: keiner Einschränkungen: Keine |
Ja |
Anforderungstext
Der Anfragetext enthält die hochzuladenden Daten.
Antworten
Nach einem erfolgreichen Teil-Upload gibt Amazon Glacier eine 204 No Content 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 Baumhash, den Amazon 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 das nächste Teil hochzuladen, ist das Verfahren dasselbe. Sie müssen jedoch einen neuen SHA256 Tree-Hash für das Teil berechnen, das Sie hochladen, und außerdem einen neuen Bytebereich angeben, um anzugeben, wo das Teil in der Endmontage platziert werden soll. 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. Amazon Glacier verwendet die Bereichsspezifikation für jedes Teil, um die Reihenfolge zu bestimmen, in der sie zusammengebaut werden.
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
