

 **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.

# Mehrteiligen Upload initiieren (POST multipart uploads)
<a name="api-multipart-initiate-upload"></a>

## Description
<a name="api-multipart-initiate-upload-description"></a>

Dieser Vorgang initiiert einen mehrteiligen Upload (siehe [Hochladen von großen Archiven in Teilen (Multipart Upload)](uploading-archive-mpu.md)). Amazon Glacier (Amazon 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 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**  
Sie müssen die Größe des Archivs nicht kennen, wenn Sie einen mehrteiligen Upload starten, da Sie bei Amazon Glacier nicht die Gesamtgröße des Archivs angeben müssen.

Nachdem Sie den mehrteiligen Upload abgeschlossen haben, entfernt Amazon Glacier die mehrteilige Upload-Ressource, auf die die ID verweist. Amazon Glacier entfernt auch die mehrteilige Upload-Ressource, wenn Sie den mehrteiligen Upload abbrechen, oder 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
<a name="api-multipart-initiate-upload-requests"></a>

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
<a name="api-multipart-initiate-upload-requests-syntax"></a>

```
1. POST /AccountId/vaults/VaultName/multipart-uploads 
2. Host: glacier.us-west-2.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
6. x-amz-archive-description: ArchiveDescription
7. x-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 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
<a name="api-archive-post-requests-parameters1"></a>

Dieser Vorgang verwendet keine Anforderungsparameter.

### Anforderungsheader
<a name="api-archive-post-requests-headers1"></a>

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  |  Description  |  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 [Initiate Job (POST jobs)](api-initiate-job-post.md)), 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
<a name="api-multipart-initiate-upload-requests-elements"></a>

Dieser Vorgang besitzt keinen Anforderungstext.

## Antworten
<a name="api-multipart-initiate-upload-responses"></a>

In der Antwort erstellt Amazon Glacier eine mehrteilige Upload-Ressource, die durch eine ID identifiziert wird, und gibt den relativen URI-Pfad der mehrteiligen Upload-ID zurück. 

### Syntax
<a name="api-multipart-initiate-upload-response-syntax"></a>

```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: x-amzn-RequestId
3. Date: Date
4. Location: Location
5. x-amz-multipart-upload-id: multiPartUploadId
```

### Antwort-Header
<a name="api-archive-post-responses-headers2"></a>

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  |  Description  | 
| --- | --- | 
|  Location  |  Der relative URI-Pfad der mehrteiligen Upload-ID, die Amazon 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 `Location`-Headers angegeben.  Typ: Zeichenfolge  | 

### Antworttext
<a name="api-archive-post-responses-elements1"></a>

Dieser Vorgang gibt keinen Antworttext zurück.

### Fehler
<a name="api-archive-post-responses-errors1"></a>

Informationen zu Amazon Glacier-Ausnahmen und Fehlermeldungen finden Sie unter[Fehlermeldungen](api-error-responses.md).

## Beispiel
<a name="initiate-mpu-api-example"></a>

### Beispielanforderung
<a name="api-multipart-initiate-upload-example-request"></a>

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.

```
1. POST /-/vaults/examplevault/multipart-uploads 
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-archive-description: MyArchive-101
5. x-amz-part-size: 4194304
6. x-amz-glacier-version: 2012-06-01
7. 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
<a name="api-multipart-initiate-upload-example-response"></a>

Amazon Glacier erstellt eine mehrteilige Upload-Ressource 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. 

```
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. Location: /111122223333/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
5. x-amz-multipart-upload-id: OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
```

Weitere Informationen über das Hochladen einzelner Teile finden Sie unter [Upload Part (PUT uploadID)](api-upload-part.md).

## Zugehörige Abschnitte
<a name="related-sections-initiate-mpu"></a>

 
+ [Upload Part (PUT uploadID)](api-upload-part.md)
+ [Complete Multipart Upload (POST uploadID)](api-multipart-complete-upload.md)
+ [Abort Multipart Upload (DELETE uploadID)](api-multipart-abort-upload.md)
+ [List Multipart Uploads (GET multipart-uploads)](api-multipart-list-uploads.md)
+ [List Parts (GET uploadID)](api-multipart-list-parts.md)
+ [Delete Archive (DELETE archive)](api-archive-delete.md)
+ [Hochladen von großen Archiven in Teilen (Multipart Upload)](uploading-archive-mpu.md)
+ [Identity and Access Management für Amazon Glacier](security-iam.md)