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.
In den folgenden Abschnitten der Amazon Simple Storage Service Reference wird die REST-API für das Auflisten mehrteiliger Uploads beschrieben:
- Java
-
Die folgenden Aufgaben führen Sie durch die Verwendung von Java Low-Level-Klassen, um alle laufenden mehrteiligen Uploads für einen Bucket aufzulisten.
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 AmazonS3Client.listMultipartUploads-Methode aus. Die Methode gibt eine Instance der Klasse MultipartUploadListing zurück, die Ihnen Informationen über die laufenden mehrteiligen Uploads bereitstellt. |
Im folgenden Java-Codebeispiel werden die vorherigen Aufgaben veranschaulicht.
ListMultipartUploadsRequest allMultpartUploadsRequest =
new ListMultipartUploadsRequest(existingBucketName);
MultipartUploadListing multipartUploadListing =
s3Client.listMultipartUploads(allMultpartUploadsRequest);
- .NET
Um alle aktuell ausgeführten mehrteiligen Uploads für einen bestimmten Bucket aufzulisten, verwenden Sie die Klasse ListMultipartUploadsRequest der Low-Level-API von AWS SDK for .NET 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 AWS SDK for .NET alle laufenden mehrteiligen Uploads in einem Bucket auflisten. Informationen zum Einrichten und Ausführen der Codebeispiele finden Sie unter Getting started with the AWS SDK for .NET (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 for 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());
