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.
Mehrteiligen Upload initiieren (POST multipart uploads)
Beschreibung
Dieser Vorgang initiiert einen mehrteiligen Upload (siehe Hochladen von großen Archiven in Teilen (Multipart Upload)). Amazon Glacier (Amazon Glacier) erstellt eine mehrteilige Upload-Ressource und gibt ihre ID in der Antwort zurück. Sie verwenden diese Upload-ID bei allen darauf folgenden mehrteiligen Upload-Vorgängen.
Wenn Sie den mehrteiligen Upload initiieren, geben Sie die Größe der einzelnen Teile in Bytes an. Die Größe der Teile muss ein Mebibyte (MiB) (1024 Kibibyte [KiB]) multipliziert mit einer Potenz von 2 sein, z. B. 1048576 (1 MiB), 2097152 (2 MiB), 4194304 (4 MiB), 8388608 (8 MiB) usw. Der kleinste zulässige Wert für die Größe ist 1 MiB, der größte 4 GiB (Gibibytes).
Mit Ausnahme des letzten Teils muss jeder Teil, den Sie mit dieser Upload-ID hochladen, dieselbe Größe aufweisen. Der letzte Teil kann dieselbe Größe haben oder kleiner sein. Beispiel: Angenommen, Sie möchten eine Datei mit 16,2 MiB hochladen. Wenn Sie einen mehrteiligen Upload mit 4 MiB großen Teilen initiieren, laden Sie vier Teile mit jeweils 4 MiB und einen Teil mit 0,2 MiB hoch.
Anmerkung
Sie müssen die Größe des Archivs nicht kennen, wenn Sie einen mehrteiligen Upload starten, da Sie bei Amazon Glacier nicht die Gesamtgröße des Archivs angeben müssen.
Nachdem Sie den mehrteiligen Upload abgeschlossen haben, entfernt Amazon Glacier die mehrteilige Upload-Ressource, auf die die ID verweist. Amazon Glacier entfernt auch die mehrteilige Upload-Ressource, wenn Sie den mehrteiligen Upload abbrechen, oder sie kann entfernt werden, wenn für einen Zeitraum von 24 Stunden keine Aktivität stattfindet. Die ID ist unter Umständen nach 24 Stunden noch vorhanden. Dieses Verhalten kann jedoch von Anwendungen nicht vorausgesetzt werden.
Anforderungen
Senden Sie zum Initiieren eines mehrteiligen Uploads eine HTTP-POST-Anforderung an den URI der multipart-uploads-Unterressource des Tresors, in dem Sie das Archiv speichern möchten. Die Anforderung muss die Größe der Teile enthalten und kann optional auch eine Beschreibung des Archivs beinhalten.
Syntax
POST /AccountId/vaults/VaultName/multipart-uploads Host: glacier.us-west-2.amazonaws.com Date:DateAuthorization:SignatureValuex-amz-glacier-version: 2012-06-01 x-amz-archive-description:ArchiveDescriptionx-amz-part-size:PartSize
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-part-size
|
Die Größe jedes Teils mit Ausnahme des letzten Teils, in Bytes. Der letzte Teil kann kleiner als die anderen Teile sein. Typ: Zeichenfolge Standard: keiner Einschränkungen: Die Größe der Teile muss ein Mebibyte (MiB) (1024 KiB) multipliziert mit einer Potenz von 2 sein, z. B. 1048576 (1 MiB), 2097152 (2 MiB), 4194304 (4 MiB), 8388608 (8 MiB) usw. Der kleinste zulässige Wert für die Größe ist 1 MiB, der größte 4 GiB (4096 MiB). |
Ja |
x-amz-archive-description
|
Die Beschreibung des Archivs, das Sie in Teilen hochladen. Es kann sich dabei um eine Beschreibung in Textform oder eine eindeutige Kennzeichnung Ihrer Wahl handeln. Wenn Sie eine Inventarliste eines Tresors abrufen (siehe Initiate Job (POST jobs)), enthält die Antwort diese Beschreibung für jedes zurückgegebene Archiv. Führende Leerzeichen in Archivbeschreibungen werden entfernt. Typ: Zeichenfolge Standard: keiner Einschränkungen: Die Beschreibung darf höchstens 1 024 Bytes umfassen. Zulässig sind 7-Bit-ASCII-Zeichen ohne Steuercodes, also die ASCII-Dezimalwerte 32 bis 126 bzw. die ASCII-Hexadezimalwerte 0x20 bis 0x7E. |
Nein |
Anforderungstext
Dieser Vorgang besitzt keinen Anforderungstext.
Antworten
In der Antwort erstellt Amazon Glacier eine mehrteilige Upload-Ressource, die durch eine ID identifiziert wird, und gibt den relativen URI-Pfad der mehrteiligen Upload-ID zurück.
Syntax
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date Location: Location x-amz-multipart-upload-id: multiPartUploadId
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 der mehrteiligen Upload-ID, die Amazon Glacier erstellt hat. Über den URI-Pfad können Sie Ihre Anforderungen zum Hochladen von Teilen genau ausrichten und den mehrteiligen Upload abschließen. Typ: Zeichenfolge |
x-amz-multipart-upload-id
|
Die ID des mehrteiligen Uploads. Dieser Wert wird ebenfalls als Teil des Typ: Zeichenfolge |
Antworttext
Dieser Vorgang gibt keinen Antworttext zurück.
Fehler
Informationen zu Amazon Glacier-Ausnahmen und Fehlermeldungen finden Sie unterFehlermeldungen.
Beispiel
Beispielanfrage
Im folgenden Beispiel wird ein mehrteiliger Upload durch Senden einer HTTP-POST-Anforderung an den URI der multipart-uploads-Unterressource eines Tresors mit der Bezeichnung examplevault initiiert. Die Anforderung schließt Header ein, die die Größe der Teile auf 4 MiB (4 194 304 Bytes) festlegen und die optionale Archivbeschreibung enthalten.
POST /-/vaults/examplevault/multipart-uploads Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-archive-description: MyArchive-101 x-amz-part-size: 4194304 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
Amazon Glacier erstellt eine mehrteilige Upload-Ressource und fügt sie der multipart-uploads Unterressource des Tresors hinzu. Der Location-Antwort-Header schließt den relativen URI-Pfad zur ID für den mehrteiligen Upload ein.
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/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE x-amz-multipart-upload-id: OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
Weitere Informationen über das Hochladen einzelner Teile finden Sie unter Upload Part (PUT uploadID).
Zugehörige Abschnitte
