**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](https://aws.amazon.com/s3/storage-classes/glacier/).
Amazon Glacier (ursprünglicher eigenständiger, auf Tresor basierender Service) akzeptiert keine Neukunden mehr. 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](https://aws.amazon.com/s3/storage-classes/glacier/), die mit S3-Bucket-Basis, voller AWS-Region Verfügbarkeit APIs, geringeren Kosten und AWS Serviceintegration ein hervorragendes Kundenerlebnis bieten. Wenn Sie erweiterte Funktionen wünschen, sollten Sie eine Migration zu Amazon S3 Glacier-Speicherklassen in Betracht ziehen, indem Sie unseren [AWS Lösungsleitfaden für die Übertragung von Daten aus Amazon Glacier-Tresoren in Amazon S3 Glacier-Speicherklassen](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/) verwenden.
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 Glacier (Amazon Glacier) die Archiv-ID im `x-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 einen SHA256 Struktur-Hash der Daten angeben, die Sie hochladen. Hinweise zur Berechnung eines SHA256 Baumhashs finden Sie unter[Berechnen von Prüfsummen](checksum-calculations.md).
**Anmerkung**
Der SHA256 Baumhash ist nur für die Aktion Archiv hochladen (POST-Archiv) erforderlich, wenn die API verwendet wird. Er ist nicht erforderlich, wenn Sie den verwenden AWS CLI.
Beim Hochladen eines Archivs können Sie optional eine Archivbeschreibung mit bis zu 1 024 druckbaren ASCII-Zeichen angeben. Amazon Glacier gibt die Archivbeschreibung zurück, wenn Sie entweder das Archiv abrufen oder das Tresorinventar abrufen. Amazon 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 Amazon 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 [Arbeiten mit Archiven in Amazon Glacier](working-with-archives.md).
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 Anfrage muss die Größe der Archiv-Payload und die Prüfsumme (SHA256 Tree-Hash) enthalten und kann optional eine Beschreibung des Archivs enthalten.
### Syntax
```
1. POST /AccountId/vaults/VaultName/archives
2. Host: glacier.Region.amazonaws.com
3. x-amz-glacier-version: 2012-06-01
4. Date: Date
5. Authorization: SignatureValue
6. x-amz-archive-description: Description
7. x-amz-sha256-tree-hash: SHA256 tree hash
8. x-amz-content-sha256: SHA256 linear hash
9. Content-Length: Length
10.
11.
```
**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
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](api-common-request-headers.md).
| 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 \$1sec14 .13.](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)](api-initiate-job-post.md)), 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) der 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, der SHA256 Baumhash, der Nutzlast. Hinweise zur Berechnung des SHA256 Baumhashs finden Sie unter. [Berechnen von Prüfsummen](checksum-calculations.md) Wenn Amazon Glacier eine andere Prüfsumme der Nutzlast berechnet, lehnt Amazon die Anfrage ab. Typ: Zeichenfolge Standard: keiner Einschränkungen: Keine | Ja |
### Anforderungstext
Der Anfragetext enthält die hochzuladenden Daten.
## Antworten
Als Reaktion darauf speichert Amazon Glacier das Archiv dauerhaft und gibt einen URI-Pfad zur Archiv-ID zurück.
### Syntax
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier
5. Location: Location
6. 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](api-common-response-headers.md).
| 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 Amazon Glacier berechnete Prüfsumme des Archivs. Typ: Zeichenfolge |
### Antworttext
Dieser Vorgang gibt keinen Antworttext zurück.
### Fehler
Informationen zu Amazon Glacier-Ausnahmen und Fehlermeldungen finden Sie unter[Fehlermeldungen](api-error-responses.md).
## Beispiele
### Beispielanfrage
Das folgende Beispiel zeigt eine Anforderung zum Hochladen eines Archivs.
```
1. POST /-/vaults/examplevault/archives HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
5. x-amz-content-sha256: 7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3
6. Content-Length: 2097152
7. x-amz-glacier-version: 2012-06-01
8. 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
9.
10.
```
### Beispielantwort
Die nachfolgende erfolgreiche Antwort enthält einen `Location` Header, in dem Sie die ID abrufen können, die Amazon Glacier dem Archiv zugewiesen hat.
```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
5. Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
6. x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
```
## Zugehörige Abschnitte
+ [Arbeiten mit Archiven in Amazon Glacier](working-with-archives.md)
+ [Hochladen von großen Archiven in Teilen (Multipart Upload)](uploading-archive-mpu.md)
+ [Delete Archive (DELETE archive)](api-archive-delete.md)
+ [Identity and Access Management für Amazon Glacier](security-iam.md)