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 Liste der Teile zurück, sortiert nach dem Bereich, den Sie beim Hochladen jedes Teils angegeben haben. Wenn Sie eine „List Parts“-Anforderung senden, nachdem der mehrteilige Upload abgeschlossen ist, 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 marker-Wert nicht Null ist, senden Sie, um den nächsten Teilsatz abzurufen, eine weitere „List Parts“-Anforderung. Dabei muss der marker-Anforderungsparameter auf den Wert festgelegt sein, den S3 Glacier als Antwort auf Ihre vorherige „List Parts“-Anforderung 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

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 einen einzelnen Bindestrich („-“) angeben. Bei Angabe eines Bindestrichs verwendet Amazon S3 Glacier die AWS-Konto-ID, die mit den zum Signieren der Anforderung verwendeten Anmeldeinformationen verknüpft ist. Wenn Sie eine Konto-ID verwenden, darf die ID keine Bindestriche („-“) enthalten.

Anfrageparameter

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

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

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.

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 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 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 Wert des SHA256-Struktur-Hash, den S3 Glacier für den 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 über Ausnahmen und Fehlermeldungen in Amazon S3 Glacier finden Sie unter Fehlermeldungen.

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 ID des mehrteiligen Uploads 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 ID des mehrteiligen Uploads 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"
}	

Zugehörige Abschnitte

• Mehrteiligen Upload initiieren (POST multipart uploads)

• Upload Part (PUT uploadID)

• Complete Multipart Upload (POST uploadID)

• Abort Multipart Upload (DELETE uploadID)

• List Multipart Uploads (GET multipart-uploads)

• Hochladen von großen Archiven in Teilen (Multipart Upload)

• Identitäts- und Zugriffsverwaltung für Amazon S3 Glacier