Mehrteiligen Upload initiieren (POST multipart uploads) - Amazon S3 Glacier

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 (sieheHochladen von großen Archiven in Teilen (Multipart Upload)). Amazon S3 Glacier (S3 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 Teilgröße muss ein Mebibyte (MiB) (1024 Kibibytes [KiB]) multipliziert mit einer Potenz von 2 sein, zum Beispiel 1048576 (1 MiB), 2097152 (2 MiB), 4194304 (4 MiB), 8388608 (8 MiB) usw. Die minimal zulässige Bauteilgröße beträgt 1 MiB und die maximal zulässige Bauteilgröße 4 Gibibytes (GiB).

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. Angenommen, Sie möchten zum Beispiel eine 16,2-MiB-Datei hochladen. Wenn Sie den mehrteiligen Upload mit einer Teilgröße von 4 MiB 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 in S3 Glacier nicht die gesamte Archivgröße angeben müssen.

Nachdem Sie den mehrteiligen Upload abgeschlossen haben, entfernt S3 Glacier die mehrteilige Upload-Ressource, auf die in der ID verwiesen wird. S3 Glacier entfernt auch die Multipart-Upload-Ressource, wenn Sie den mehrteiligen Upload abbrechen. Sie kann auch entfernt werden, wenn über 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: Date Authorization: SignatureValue x-amz-glacier-version: 2012-06-01 x-amz-archive-description: ArchiveDescription x-amz-part-size: PartSize

Anmerkung

DerAccountId Wert ist dieAWS-Konto ID des Kontos, dem der Tresor gehört. Sie können entweder eineAWS-Konto ID oder optional ein einzelnes '-' (Bindestrich) angeben. In diesem Fall verwendet Amazon S3 Glacier dieAWS-Konto ID, die den Anmeldeinformationen zugeordnet ist, mit denen die Anfrage signiert wurde. Wenn Sie eine Konto-ID verwenden, fügen Sie keine Bindestriche ('-') in die ID ein.

Anfrageparameter

Dieser Vorgang verwendet keine Anforderungsparameter.

Anforderungsheader

Dieser Vorgang verwendet zusätzlich zu den Anforderungsheadern, die allen Vorgängen gemeinsam sind, die folgenden Anforderungsheader. Weitere Informationen zu den allgemeinen Anforderungsheadern finden Sie unterHä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 Teilgröße muss ein Mebibyte (1024 KiB) multipliziert mit einer Potenz von 2 sein, zum Beispiel 1048576 (1 MiB), 2097152 (2 MiB), 4194304 (4 MiB), 8388608 (8 MiB) usw. Die zulässige Mindestteilgröße beträgt 1 MiB und die Höchstgröße 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 S3 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 Antwortheadern, die allen Vorgängen gemeinsam sind, die folgenden Antwortheader. Weitere Informationen zu allgemeinen Antwort-Headern finden Sie unterAllgemeine Antwort-Header.

Name Beschreibung
Location

Der relative URI-Pfad der von S3 Glacier erstellten mehrteiligen Upload-ID. Ü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 Location-Headers angegeben.

Typ: Zeichenfolge

Antworttext

Bei diesem Vorgang wird kein Antworttext zurückgegeben.

Fehler

Informationen zu Amazon S3 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 Anfrage enthält Header zur Angabe der Teilgröße von 4 MiB (4194304 Byte) und die optionale Archivbeschreibung.

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 mehrteilige Upload-Ressource und fügt sie dermultipart-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).