

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

# List Multipart Uploads (GET multipart-uploads)
<a name="api-multipart-list-uploads"></a>

## Description
<a name="api-multipart-list-uploads-description"></a>

Diese mehrteilige Upload-Operation listet mehrteilige Uploads auf, die für den angegebenen Tresor in Bearbeitung sind. Ein mehrteiliger Upload in Bearbeitung ist ein mehrteiliger Upload, der von einer [Mehrteiligen Upload initiieren (POST multipart uploads)](api-multipart-initiate-upload.md)-Anforderung initiiert, aber noch nicht abgeschlossen oder beendet wurde. Die in der List Multipart Upload-Antwort zurückgegebene Liste hat keine garantierte Reihenfolge.

Die List Multipart Uploads-Operation unterstützt Paginierung. Standardmäßig gibt diese Operation bis zu 50 mehrteilige Uploads in der Antwort zurück. Sie sollten immer das Feld `marker` im Antworttext auf eine Markierung überprüfen, bei der die Liste fortgesetzt werden soll. Wenn keine Elemente mehr vorhanden sind, ist der Wert des Felds `marker` gleich `null`. 

Wenn der nicht Null `marker` ist, haben Sie zum Abrufen des nächsten Satzes mehrteiliger Uploads eine weitere Anfrage „Mehrteilige Uploads auflisten“ gesendet, wobei der Anforderungsparameter auf den Markierungswert gesetzt wurde, den Amazon Glacier (Amazon Glacier) als Antwort auf Ihre vorherige `marker` Anfrage „Mehrteilige Uploads auflisten“ zurückgegeben hat.

Beachten Sie den Unterschied zwischen dieser Operation und der Operation [List Parts (GET uploadID)](api-multipart-list-parts.md). Die List Multipart Uploads-Operation listet alle mehrteiligen Uploads für einen Tresor auf. Die List Parts-Operation gibt Teile eines bestimmten mehrteiligen Uploads zurück, die von einer Upload-ID identifiziert werden.

Weitere Informationen über mehrteilige Uploads finden Sie unter [Hochladen von großen Archiven in Teilen (Multipart Upload)](uploading-archive-mpu.md).

## Anforderungen
<a name="api-multipart-list-uploads-requests"></a>

### Syntax
<a name="api-multipart-list-uploads-requests-syntax"></a>

Um mehrteilige Uploads aufzulisten, senden Sie eine `GET`-Anfrage an den URI der `multipart-uploads`-Unterressource des Tresors. Sie können optional die Parameter `marker` und `limit` angeben.

```
1. GET /AccountId/vaults/VaultName/multipart-uploads HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```

 

**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-multipart-list-uploads-requests-parameters"></a>


|  Name  |  Description  |  Erforderlich  | 
| --- | --- | --- | 
|  limit  |  Gibt die Höchstanzahl von Uploads an, die im Antworttext zurückgegeben werden. Falls nicht angegeben, gibt die List Uploads-Operation bis zu 50 Uploads zurück. Typ: Zeichenfolge Beschränkungen: Mindestganzzahlwert `1`. Höchstganzzahlwert `50`.  |  Nein | 
| marker  |  Eine zur Paginierung verwendete opake Zeichenfolge. `marker` gibt den Upload an, mit dem die Auflistung von Uploads beginnen soll. Rufen Sie den Wert für `marker` aus einer vorherigen List Uploads-Antwort ab. Sie müssen `marker` nur dann einschließen, wenn Sie die Paginierung der Ergebnisse fortsetzen, die in einer vorherigen List Uploads-Anfrage gestartet wurde. Typ: Zeichenfolge Einschränkungen: Keine  |  Nein  | 

### Anforderungsheader
<a name="api-multipart-list-uploads-requests-headers"></a>

Für diesen Vorgang werden ausschließlich Antwort-Header verwendet, die für die meisten Antworten gelten. Weitere Informationen über allgemeine Antwort-Header finden Sie unter [Allgemeine Antwort-Header](api-common-response-headers.md).

### Anforderungstext
<a name="api-multipart-list-uploads-requests-elements"></a>

Dieser Vorgang besitzt keinen Anforderungstext.

## Antworten
<a name="api-multipart-list-uploads-responses"></a>

### Syntax
<a name="api-multipart-list-uploads-responses-syntax"></a>

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: x-amzn-RequestId
 3. Date: Date
 4. Content-Type: application/json
 5. Content-Length: Length
 6. 
 7. {
 8.   "Marker": String,
 9.   "UploadsList" : [ 
10.     {
11.       "ArchiveDescription": String,
12.       "CreationDate": String,
13.       "MultipartUploadId": String,
14.       "PartSizeInBytes": Number,
15.       "VaultARN": String
16.     }, 
17.    ...
18.   ]
19. }
```

### Antwort-Header
<a name="api-multipart-list-uploads-responses-headers"></a>

Für diesen Vorgang werden ausschließlich Antwort-Header verwendet, die für die meisten Antworten gelten. Weitere Informationen über allgemeine Antwort-Header finden Sie unter [Allgemeine Antwort-Header](api-common-response-headers.md).

### Antworttext
<a name="api-multipart-list-uploads-responses-elements"></a>

Der Antworttext enthält die folgenden JSON-Felder.

**ArchiveDescription**  
Die Beschreibung des Archivs, die in der Initiate Multipart Upload-Anfrage angegeben wurde. Der Wert dieses Felds ist `null`, wenn in der Initiate Multipart Upload-Operation keine Archivbeschreibung angegeben wurde.  
*Typ:* Zeichenfolge

**CreationDate**  
Die UTC-Zeit, zu der der mehrteilige Upload initiiert wurde.  
*Typ:* Zeichenfolge. Eine Zeichenfolgendarstellung im ISO 8601-Datumsformat, zum Beispiel `2013-03-20T17:03:43.221Z`.

**Marker**  
Eine opake Zeichenfolge, die angibt, wo die Paginierung der Ergebnisse fortgesetzt werden soll. Mithilfe des `marker` in einer anderen List Multipart Uploads-Anfrage erhalten Sie mehr Uploads in der Liste. Wenn keine anderen Uploads vorhanden sind, ist dieser Wert `null`.  
*Typ:* Zeichenfolge

**PartSizeInBytes**  
Die in der Anfrage [Mehrteiligen Upload initiieren (POST multipart uploads)](api-multipart-initiate-upload.md) angegebene Teilgröße. Dies ist die Größe aller Teile im Upload außer dem letzten Teil, der kleiner sein kann als diese Größe.  
*Typ*: Zahl

**MultipartUploadId**  
Die ID des mehrteiligen Uploads.  
*Typ:* Zeichenfolge

**UploadsList**  
Eine Liste von Metadaten über mehrteilige Upload-Objekte. Jedes Element in der Liste enthält einen Satz von Namen-Wert-Paaren für den entsprechenden Upload, einschließlich `ArchiveDescription`, `CreationDate`, `MultipartUploadId`, `PartSizeInBytes` und `VaultARN`.  
*Typ*: Array

**VaultARN**  
Der ARN (Amazon-Ressourcenname) des Tresors, der das Archiv enthält.  
*Typ:* Zeichenfolge

### Fehler
<a name="api-multipart-list-uploads-responses-errors"></a>

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

## Beispiele
<a name="api-multipart-list-uploads-examples"></a>

### Beispiel: Auflisten aller mehrteiligen Uploads
<a name="api-multipart-list-uploads-examples-one"></a>

Das folgende Beispiel listet alle mehrteiligen Uploads auf, die für den Tresor in Bearbeitung sind. Das Beispiel zeigt eine HTTP-`GET`-Anfrage an den URI der `multipart-uploads`-Unterressource eines bestimmten Tresors. Weil die Parameter `marker` und `limit` in der Anfrage nicht angegeben sind, werden bis zu 1 000 mehrteilige Uploads in Bearbeitung zurückgegeben.

#### Beispielanforderung
<a name="api-multipart-list-uploads-example-request"></a>

```
1. GET /-/vaults/examplevault/multipart-uploads HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. 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-list-uploads-example-response"></a>

In der Antwort gibt Amazon Glacier eine Liste aller laufenden mehrteiligen Uploads für den angegebenen Tresor zurück. Das Feld `marker` hat den Wert `null`, wodurch angezeigt wird, dass keine weiteren aufzulistenden Uploads vorhanden sind. 

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:00:00 GMT
 4. Content-Type: application/json
 5. Content-Length: 1054
 6.       
 7. {
 8.   "Marker": null, 
 9.   "UploadsList": [ 
10.     {
11.       "ArchiveDescription": "archive 1",
12.       "CreationDate": "2012-03-19T23:20:59.130Z",
13.       "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev",
14.       "PartSizeInBytes": 4194304,
15.       "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
16.     }, 
17.     {
18.       "ArchiveDescription": "archive 2",
19.       "CreationDate": "2012-04-01T15:00:00.000Z",
20.       "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
21.       "PartSizeInBytes": 4194304,
22.       "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
23.     },
24.     {
25.       "ArchiveDescription": "archive 3",
26.       "CreationDate": "2012-03-20T17:03:43.221Z",
27.       "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
28.       "PartSizeInBytes": 4194304,
29.       "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
30.     } 
31.   ]
32. }
```

### Beispiel: Teilweise Liste mehrteiliger Uploads
<a name="api-multipart-list-uploads-examples-two"></a>

Das folgende Beispiel zeigt, wie Sie Paginierung verwenden können, um eine begrenzte Anzahl von Ergebnissen zu erhalten. Das Beispiel zeigt eine HTTP-`GET`-Anfrage an den URI der `multipart-uploads`-Unterressource für einen bestimmten Tresor. In diesem Beispiel ist der Parameter `limit` auf 1 festgelegt, was bedeutet, dass nur ein Upload in der Liste zurückgegeben wird, und der Parameter `marker` zeigt die ID des mehrteiligen Uploads an, mit dem die zurückgegebene Liste beginnt.

#### Beispielanforderung
<a name="api-multipart-list-uploads-example-request-two"></a>

```
1. GET /-/vaults/examplevault/multipart-uploads?limit=1&marker=xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. 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-list-uploads-example-response-two"></a>

In der Antwort gibt Amazon Glacier (Amazon Glacier) eine Liste mit nicht mehr als zwei laufenden mehrteiligen Uploads für den angegebenen Tresor zurück, wobei bei der angegebenen Markierung begonnen wird und zwei Ergebnisse zurückgegeben werden. 

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:00:00 GMT
 4. Content-Type: application/json
 5. Content-Length: 470
 6. 
 7. {
 8.   "Marker": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
 9.   "UploadsList" : [ 
10.     {
11.       "ArchiveDescription": "archive 2",
12.       "CreationDate": "2012-04-01T15:00:00.000Z",
13.       "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
14.       "PartSizeInBytes": 4194304,
15.       "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
16.     }
17.   ]
18. }
```

## Zugehörige Abschnitte
<a name="related-sections-multipart-list-uploads"></a>

 
+ [Mehrteiligen Upload initiieren (POST multipart uploads)](api-multipart-initiate-upload.md)
+ [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 Parts (GET uploadID)](api-multipart-list-parts.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)