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. Als Antwort gibt Amazon S3 Glacier (S3 Glacier) die Archiv-ID imx-amz-archive-id Header der Antwort zurück. 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-Baum-Hash ist nur für die Aktion Archiv hochladen (POST-Archiv) erforderlich, wenn die API verwendet wird. Es ist nicht erforderlich, wenn Sie den verwendenAWS CLI.
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 entweder das Archiv oder das Tresorinventar abrufen. S3 Glacier interpretiert die Beschreibung in keiner Weise. 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 zusätzlichen Metadaten für die 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 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:DateAuthorization:SignatureValuex-amz-archive-description:Descriptionx-amz-sha256-tree-hash:SHA256 tree hashx-amz-content-sha256:SHA256 linear hashContent-Length:Length<Request body.>
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
Bei dieser Implementierung der Operation werden keine Anforderungsparameter verwendet.
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 |
|---|---|---|
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. Die zulässigen Zeichen sind 7-Bit-ASCII ohne Steuercodes, insbesondere ASCII-Werte 32—126 dezimal oder 0x20—0x7E hexadezimal. |
Nein |
x-amz-content-sha256
|
Die SHA256-Prüfsumme (ein linearer Hash) für die Nutzlast. Dieser Wert stimmt nicht mit dem im 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 der Payload berechnet, lehnt es die Anfrage ab. Typ: Zeichenfolge Standard: keiner Einschränkungen: Keine |
Ja |
Anforderungstext
Der Anfragetext enthält die hochzuladenden Daten.
Antworten
Als Reaktion darauf speichert S3 Glacier das Archiv dauerhaft und gibt einen URI-Pfad an die 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 Antwortheadern, die allen Vorgängen gemeinsam sind, die folgenden Antwortheader. Weitere Informationen zu den allgemeinen Antwort-Headern finden Sie unterAllgemeine 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 Typ: Zeichenfolge |
x-amz-sha256-tree-hash |
Die von S3 Glacier berechnete Prüfsumme des Archivs. Typ: Zeichenfolge |
Antworttext
Bei diesem Vorgang wird kein Antworttext zurückgegeben.
Fehler
Weitere Informationen zu den Ausnahmen und Fehlermeldungen von Amazon S3 finden Sie unterFehlermeldungen.
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 erfolgreiche Antwort unten enthält eineLocation Kopfzeile, in der Sie die ID abrufen 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
