Beschreibung Anforderungen Antworten Beispiele Zugehörige Abschnitte

List Parts (GET uploadID)

Beschreibung

Diese mehrteilige Upload-Operation listet die Teile eines Archivs auf, die in einem spezifischen mehrteiligen Upload, der durch eine Upload-ID identifiziert wird, hochgeladen wurde. Weitere Informationen über mehrteilige Uploads finden Sie unter Hochladen von großen Archiven in Teilen (Multipart Upload).

Sie können diese Anfrage jederzeit stellen, während ein mehrteiliger Upload in Bearbeitung ist, bevor Sie den mehrteiligen Upload abschließen. S3 Glacier gibt die Teileliste sortiert nach dem Bereich zurück, den Sie bei jedem Teile-Upload angegeben haben. Wenn Sie nach Abschluss des mehrteiligen Uploads eine List Parts-Anfrage senden, gibt Amazon S3 Glacier (S3 Glacier) einen Fehler zurück.

Die List Parts-Operation unterstützt Paginierung. 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 Nullmarker ist, haben Sie zum Abrufen des nächsten Satzes von Teilen eine weitere List Parts-Anfrage gesendet, wobei der Anforderungsparametermarker auf den Markerwert gesetzt ist, den S3 Glacier als Antwort auf Ihre vorherige List Parts-Anfrage zurückgegeben hat.

Sie können die in der Antwort zurückgegebene Anzahl der Teile auch begrenzen, indem Sie in der Anfrage den Parameter limit angeben.

Anforderungen

Syntax

Um die Liste der Teile in einem mehrteiligen Upload, der in Bearbeitung ist, aufzulisten, senden Sie eine GET-Anfrage an den URI der Ressource mit der ID des mehrteiligen Uploads. Die ID des mehrteiligen Uploads wird zurückgegeben, wenn Sie einen mehrteiligen Upload initiieren (Mehrteiligen Upload initiieren (POST multipart uploads)). Sie können optional die Parameter marker und limit angeben.


GET /AccountId/vaults/VaultName/multipart-uploads/uploadID HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

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

Name Beschreibung Erforderlich

Name	Beschreibung	Erforderlich
`limit`	Die maximale Anzahl der zurückzugebenden Teile. Das Standardlimit ist 50. Die Anzahl der zurückgegebenen Teile kann kleiner sein als das festgelegte Limit, aber die Anzahl der zurückgegebenen Teile überschreitet das Limit nie. Typ: Zeichenfolge Beschränkungen: Mindestganzzahlwert `1`. Höchstganzzahlwert `50`.	Nein
`marker`	Eine zur Paginierung verwendete opake Zeichenfolge. `marker` gibt den Teil an, mit dem die Auflistung von Teilen beginnen soll. Rufen Sie den `marker`-Wert von der Antwort einer vorherigen List Parts-Antwort ab. Sie müssen den `marker` nur dann einschließen, wenn Sie die Paginierung der Ergebnisse fortsetzen, die in einer vorherigen List Parts-Anfrage gestartet wurde. Typ: Zeichenfolge Einschränkungen: Keine	Nein

limit

Die maximale Anzahl der zurückzugebenden Teile. Das Standardlimit ist 50. Die Anzahl der zurückgegebenen Teile kann kleiner sein als das festgelegte Limit, aber die Anzahl der zurückgegebenen Teile überschreitet das Limit nie.

Typ: Zeichenfolge

Beschränkungen: Mindestganzzahlwert 1. Höchstganzzahlwert 50.

Nein

marker

Eine zur Paginierung verwendete opake Zeichenfolge. marker gibt den Teil an, mit dem die Auflistung von Teilen beginnen soll. Rufen Sie den marker-Wert von der Antwort einer vorherigen List Parts-Antwort ab. Sie müssen den marker nur dann einschließen, wenn Sie die Paginierung der Ergebnisse fortsetzen, die in einer vorherigen List Parts-Anfrage gestartet wurde.

Typ: Zeichenfolge

Einschränkungen: Keine

Nein

Anforderungsheader

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.

Anforderungstext

Dieser Vorgang besitzt keinen Anforderungstext.

Antworten

Syntax


HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length

{
    "ArchiveDescription" : String,
    "CreationDate" : String,
    "Marker": String,
    "MultipartUploadId" : String,
    "PartSizeInBytes" : Number,
    "Parts" : 
    [ {
      "RangeInBytes" : String,
      "SHA256TreeHash" : String
      },
      ...
     ],
    "VaultARN" : String
}

Antwort-Header

Antworttext

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 Zeichenkettendarstellung im ISO 8601-Datumsformat, zum Beispiel2013-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 Parts-Anfrage erhalten Sie mehr Aufträge in der Liste. Wenn keine anderen Teile vorhanden sind, ist dieser Wert null.

Typ: Zeichenfolge

MultipartUploadId

Die ID des Uploads, zu dem die Teile gehören.

Typ: Zeichenfolge

PartSizeInBytes

Die Größe des Teils in Bytes. Dies ist derselbe Wert wie der, den Sie in der Initiate Multipart Upload-Anfrage angegeben haben.

Typ: Zahl

Komponenten

Eine Liste der Teilegrößen des mehrteiligen Uploads. Jedes Objekt im Array enthält ein RangeBytes und sha256-tree-hash Name-Wert-Paar.

Typ: Array

RangeInBytes

Der Byte-Bereich eines Teils, einschließlich des oberen Werts des Bereichs.

Typ: Zeichenfolge

SHA256TreeHash

Der SHA256-Baum-Hashwert, den S3 Glacier für das Teil berechnet hat. Dieses Feld hat niemals den Wert null.

Typ: Zeichenfolge

VaultARN

Der ARN (Amazon-Ressourcenname) des Tresors, für den der mehrteilige Upload initiiert wurde.

Typ: Zeichenfolge

Fehler

Weitere Informationen Amazon S3 Ausnahmen und Fehlermeldungen finden Sie unterFehlermeldungen.

Beispiele

Beispiel: Auflisten von Teilen eines mehrteiligen Uploads

Im folgenden Beispiel werden alle Teile eines Uploads aufgelistet. In dem Beispiel wird eine HTTP-GET-Anfrage an den URI der spezifischen ID des mehrteiligen Uploads gesendet, der in Bearbeitung ist, und es werden bis zu 1 000 Teile zurückgegeben.

Beispielanfrage


GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
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

In der Antwort gibt S3 Glacier eine Liste der hochgeladenen Teile zurück, die der angegebenen mehrteiligen Upload-ID zugeordnet sind. In diesem Beispiel gibt es nur zwei Teile. Der Wert des zurückgegebenen Marker-Felds ist null. Dadurch wird angezeigt, dass keine Teile des mehrteiligen Uploads mehr vorhanden sind.


HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: 412
      
{
    "ArchiveDescription" : "archive description",
    "CreationDate" : "2012-03-20T17:03:43.221Z",
    "Marker": null,
    "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
    "PartSizeInBytes" : 4194304,
    "Parts" : 
    [ {
      "RangeInBytes" : "0-4194303",
      "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
      },
      {
      "RangeInBytes" : "4194304-8388607",
      "SHA256TreeHash" : "0195875365afda349fc21c84c099987164"
      }],
    "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
}

Beispiel: Auflisten von Teilen eines mehrteiligen Uploads (Angeben der Parameter Markierung und Limitanfrage)

Das folgende Beispiel zeigt, wie Sie Paginierung verwenden können, um eine begrenzte Anzahl von Ergebnissen zu erhalten. In dem Beispiel wird eine HTTP-GET-Anfrage an den URI der spezifischen ID eines mehrteiligen Uploads gesendet, der in Bearbeitung ist, um ein Teil zurückzugeben. Ein Start-marker-Parameter gibt an, bei welchem Teil die Teileliste startet. Sie können den marker-Wert von der Antwort einer vorherigen Anfrage für eine Teileliste abrufen. Darüber hinaus ist der limit-Parameter in diesem Beispiel auf 1 eingestellt und es wird ein Teil zurückgegeben. Beachten Sie, dass das Marker-Feld nicht null ist, was bedeutet, das noch mindestens ein Teil abzurufen ist.

Beispielanfrage


GET /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE?marker=1001&limit=1 HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
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

In der Antwort gibt S3 Glacier eine Liste der hochgeladenen Teile zurück, die der angegebenen mehrteiligen Upload-ID in Bearbeitung zugeordnet sind.


HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: text/json
Content-Length: 412
      
{
    "ArchiveDescription" : "archive description 1",
    "CreationDate" : "2012-03-20T17:03:43.221Z",
    "Marker": "MfgsKHVjbQ6EldVl72bn3_n5h2TaGZQUO-Qb3B9j3TITf7WajQ",
    "MultipartUploadId" : "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
    "PartSizeInBytes" : 4194304,
    "Parts" : 
    [ {
      "RangeInBytes" : "4194304-8388607",
      "SHA256TreeHash" : "01d34dabf7be316472c93b1ef80721f5d4"
      }],
    "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
}

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Initiieren eines mehrteiligen Uploads

List Multipart Uploads