Auflisten von mehrteiligen Uploads - Amazon Simple Storage Service

Auflisten von mehrteiligen Uploads

Sie können die AWS CLI, REST-API oder AWS-SDKs verwenden, um eine Liste der laufenden mehrteiligen Uploads in Amazon S3 abzurufen. Sie können den Multipart-Upload verwenden, um ein einzelnes Objekt programmgesteuert auf Amazon S3 hochzuladen. Bei mehrteiligen Uploads werden Objekte in Amazon S3 verschoben, indem jeweils ein Teil der Daten eines Objekts verschoben wird. Weitere allgemeine Informationen über mehrteilige Uploads finden Sie unter Hochladen und Kopieren von Objekten mit mehrteiligen Uploads in Amazon S3.

Ein umfassendes Verfahren zum Hochladen eines Objekts mit mehrteiligem Upload mit einer zusätzlichen Prüfsumme finden Sie unter Tutorial: Ein Objekt durch mehrteiligen Upload hochladen und seine Datenintegrität überprüfen.

Der folgende Abschnitt zeigt, wie Sie laufende mehrteilige Uploads mit der AWS Command Line Interface, der Amazon-S3-REST-API und AWS-SDKs auflisten.

Die folgenden Abschnitte in der AWS Command Line Interface beschreiben die REST-API für mehrteilige Uploads.

  • list-parts – listet die hochgeladenen Teile für einen bestimmten mehrteiligen Upload auf.

  • list-multipart-uploads – listet laufende mehrteilige Uploads auf.

In den folgenden Abschnitten der Amazon Simple Storage Service Reference wird die REST-API für das Auflisten mehrteiliger Uploads beschrieben:

  • ListParts – listet die hochgeladenen Teile für einen bestimmten mehrteiligen Upload auf.

  • ListMultipartUploads – listet laufende mehrteilige Uploads.

Java

Um alle laufenden mehrteiligen Uploads für einen Bucket aufzulisten, die das AWS SDK für Java verwenden Sie die Low-Level-API-Klassen für:

Auflistungsprozess von mehrteiligen Uploads mithilfe der Low-Level-API

1

Erstellen Sie eine Instance der ListMultipartUploadsRequest-Klasse und stellen Sie den Bucket-Namen bereit.

2

Führen Sie die S3Client-listMultipartUploads-Methode aus. Die Methode gibt eine Instance der Klasse ListMultipartUploadsResponse zurück, die Ihnen Informationen über die laufenden mehrteiligen Uploads bereitstellt.

Beispiele für das Auflisten mehrteiliger Uploads mit dem AWS SDK für Java finden Sie unter Mehrteilige Uploads auflisten in der Amazon S3 API-Referenz.

.NET

Um alle aktuell ausgeführten mehrteiligen Uploads für einen bestimmten Bucket aufzulisten, verwenden Sie die Klasse SDK für .NET der Low-Level-API von ListMultipartUploadsRequest für mehrteilige Uploads. Die Methode AmazonS3Client.ListMultipartUploads gibt eine Instance der Klasse ListMultipartUploadsResponse zurück, die Informationen über die laufenden mehrteiligen Uploads bereitstellt.

Ein laufender mehrteiliger Upload ist ein mehrteiliger Upload, der von der Anfrage für das Initiieren mehrteiliger Uploads initiiert, aber weder abgeschlossen noch abgebrochen wurde. Weitere Informationen über mehrteilige Amazon-S3-Uploads finden Sie unter Hochladen und Kopieren von Objekten mit mehrteiligen Uploads in Amazon S3.

Das folgende C#-Beispiel veranschaulicht, wie Sie mit SDK für .NET alle laufenden mehrteiligen Uploads in einem Bucket auflisten. Informationen zum Einrichten und Ausführen der Codebeispiele finden Sie unter Erste Schritte mit dem AWS SDK für .NET im Entwicklerbuch für AWS SDK für .NET. 

ListMultipartUploadsRequest request = new ListMultipartUploadsRequest
{
	 BucketName = bucketName // Bucket receiving the uploads.
};

ListMultipartUploadsResponse response = await AmazonS3Client.ListMultipartUploadsAsync(request);
PHP

Dieses Thema veranschaulicht, wie Sie die Low-Level-API-Klassen aus Version 3 von AWS SDK für PHP verwenden, um alle laufenden mehrteiligen Uploads für einen Bucket aufzulisten. Weitere Informationen zur AWS-SDK für Ruby API finden Sie unter AWS-SDK für Ruby – Version 2.

Das folgende PHP-Beispiel zeigt eine Auflistung aller in einem Bucket laufenden mehrteiligen Uploads.

 require 'vendor/autoload.php';

use Aws\S3\S3Client;

$bucket = '*** Your Bucket Name ***';

$s3 = new S3Client([
    'version' => 'latest',
    'region'  => 'us-east-1'
]);

// Retrieve a list of the current multipart uploads.
$result = $s3->listMultipartUploads([
    'Bucket' => $bucket
]);

// Write the list of uploads to the page.
print_r($result->toArray());