Upload Archive (POST archive) - Amazon S3 Glacier

Wenn Sie mit dem Archivierungsspeicher in Amazon Simple Storage Service (Amazon S3) noch nicht vertraut sind, empfehlen wir Ihnen, sich zunächst über die S3-Glacier-Speicherklassen in Amazon S3 (S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval und S3 Glacier Deep Archive) zu informieren. Weitere Informationen finden Sie unter S3-Glacier-Speicherklassen und Speicherklassen für die Archivierung von Objekten im Amazon S3-Benutzerhandbuch.

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 Archive (POST archive)

Beschreibung

Mit dieser Operation wird ein Archiv einem Tresor hinzugefügt. Erfolgreich hochgeladene Daten werden dauerhaft gespeichert. Die von Amazon S3 Glacier (S3 Glacier) zurückgegebene Antwort enthält die Archiv-ID im x-amz-archive-id-Header. Sie sollten die zurückgegeben Archiv-ID speichern, damit Sie später auf das Archiv zugreifen können.

Sie müssen den SHA256-Struktur-Hash der hochgeladenen Daten angeben. Weitere Informationen über die Berechnung eines SHA256-Struktur-Hash finden Sie unter Berechnen von Prüfsummen.

Anmerkung

Der SHA256-Struktur-Hash ist für die Aktion „Upload Archive“ (POST archive) nur erforderlich, wenn die API verwendet wird. Er ist nicht erforderlich, wenn Sie die AWS CLI verwenden.

Beim Hochladen eines Archivs können Sie optional eine Archivbeschreibung mit bis zu 1 024 druckbaren ASCII-Zeichen angeben. S3 Glacier gibt die Archivbeschreibung zurück, wenn Sie das Archiv oder den Tresorbestand abrufen. S3 Glacier interpretiert die Beschreibung nicht. Eine Archivbeschreibung muss nicht eindeutig sein. Die Beschreibung bietet keine Möglichkeit, die Archivliste abzurufen oder zu sortieren.

Mit Ausnahme der optionalen Archivbeschreibung unterstützt S3 Glacier keine weiteren Metadaten für Archive. Die Archiv-ID ist eine opake Sequenz von Zeichen, die keine Rückschlüsse auf das Archiv erlaubt. Es bietet sich darum an, clientseitig Metadaten für die Archive zu erstellen. Weitere Informationen finden Sie unter Arbeiten mit Archiven in Amazon S3 Glacier.

Archive sind unveränderlich. Nachdem ein Archiv hochgeladen wurde, kann weder das Archiv noch seine Beschreibung bearbeitet werden.

Anforderungen

Verwenden Sie zum Hochladen eines Archivs die HTTP-POST-Methode und richten Sie Anforderung auf die archives-Unterressource des Tresors aus, in dem Sie das Archiv speichern möchten. Die Anforderung muss die Größe der Archivnutzlast und die Prüfsumme (SHA256-Struktur-Hash) enthalten und kann optional auch eine Beschreibung des Archivs beinhalten.

Syntax

POST /AccountId/vaults/VaultName/archives Host: glacier.Region.amazonaws.com x-amz-glacier-version: 2012-06-01 Date: Date Authorization: SignatureValue x-amz-archive-description: Description x-amz-sha256-tree-hash: SHA256 tree hash x-amz-content-sha256: SHA256 linear hash Content-Length: Length <Request body.>

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

Bei dieser Implementierung der Operation werden keine Anforderungsparameter verwendet.

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

Die Größe des Objekts in Bytes. Weitere Informationen finden Sie unter http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13.

Typ: Zahl

Standard: keiner

Einschränkungen: Keine

Ja
x-amz-archive-description

Die optionale Beschreibung des Archivs, das Sie hochladen. Es kann sich dabei um eine Beschreibung in Textform oder eine Kennzeichnung Ihrer Wahl handeln. Die Beschreibung muss sich nicht eindeutig von den Beschreibungen für andere Archive unterscheiden. Wenn Sie die Inventarliste eines Tresors abrufen (siehe Initiate Job (POST jobs)), enthält die Antwort diese Beschreibung für jedes zurückgegebene Archiv.

Typ: Zeichenfolge

Standard: keiner

Einschränkungen: Die Beschreibung darf höchstens 1 024 Zeichen 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
x-amz-content-sha256

Die SHA256-Prüfsumme (ein linearer Hash) für die Nutzlast. Dieser Wert stimmt nicht mit dem im x-amz-sha256-tree-hash-Header angegebenen Wert überein.

Typ: Zeichenfolge

Standard: keiner

Einschränkungen: Keine

Ja
x-amz-sha256-tree-hash

Die vom Benutzer berechnete Prüfsumme (SHA256-Struktur-Hash) für die Nutzlast. Weitere Informationen über die Berechnung des SHA256-Struktur-Hash finden Sie unter Berechnen von Prüfsummen. Wenn S3 Glacier eine andere Prüfsumme für die Nutzlast berechnet, wird die Anforderung abgelehnt.

Typ: Zeichenfolge

Standard: keiner

Einschränkungen: Keine

Ja

Anforderungstext

Der Anfragetext enthält die hochzuladenden Daten.

Antworten

Als Antwort speichert S3 Glacier das Archiv dauerhaft und gibt einen URI-Pfad zur Archiv-ID zurück.

Syntax

HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier Location: Location x-amz-archive-id: ArchiveId

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 neu hinzugefügten Archivressource.

Typ: Zeichenfolge

x-amz-archive-id

Die ID des Archivs. Dieser Wert wird ebenfalls als Teil des Location-Headers angegeben.

Typ: Zeichenfolge

x-amz-sha256-tree-hash

Die von S3 Glacier berechnete Prüfsumme für das Archiv.

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.

Beispiele

Beispielanfrage

Das folgende Beispiel zeigt eine Anforderung zum Hochladen eines Archivs.

POST /-/vaults/examplevault/archives HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 x-amz-content-sha256: 7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3 Content-Length: 2097152 x-amz-glacier-version: 2012-06-01 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 <Request body (2097152 bytes).>

Beispielantwort

Die unten gezeigte Antwort enthält einen Location-Header, dem Sie die ID entnehmen können, die S3 Glacier dem Archiv zugewiesen hat.

HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId

Zugehörige Abschnitte