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.
Mehrteiligen Upload initiieren (POST multipart uploads)
Beschreibung
Dieser Vorgang initiiert einen mehrteiligen Upload (siehe Hochladen von großen Archiven in Teilen (Multipart Upload)). Amazon S3 Glacier (S3 Glacier) erstellt eine Ressource für den mehrteiligen Upload 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
Es ist dabei nicht notwendig, dass Ihnen die Gesamtgröße des Archivs bekannt ist, wenn Sie den mehrteiligen Upload starten. S3 Glacier erfordert keine Angabe der Gesamtgröße des Archivs.
Nachdem Sie den mehrteiligen Upload abgeschlossen haben, entfernt S3 Glacier die Ressource für den mehrteiligen Upload, auf die die ID verweist. S3 Glacier entfernt die Ressource für den mehrteiligen Upload auch, wenn Sie den mehrteiligen Upload abbrechen. 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 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-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 Job initiieren (POSTJobs)), 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
Als Antwort erstellt S3 Glacier eine Ressource für den mehrteiligen Upload, die durch eine ID gekennzeichnet ist, und gibt den relativen URI-Pfad für die ID des mehrteiligen Uploads 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 für die ID des mehrteiligen Uploads, die S3 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
Weitere Informationen über Ausnahmen und Fehlermeldungen in Amazon S3 Glacier finden Sie unter Fehlermeldungen.
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
S3 Glacier erstellt eine Ressource für den mehrteiligen Upload 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
