列出分段上传 - Amazon Simple Storage Service

列出分段上传

您可以使用 AWS SDK（低级别 API）在 Amazon S3 中检索正在进行的分段上传的列表。

Java

以下任务将引导您使用低级别 Java 类来列出存储桶上所有正在进行的分段上传。

1

创建 ListMultipartUploadsRequest 类的实例并提供存储桶名称。

2

运行 AmazonS3Client.listMultipartUploads 方法。该方法将返回 MultipartUploadListing 类的实例，以向您提供有关正在进行的分段上传的信息。

以下 Java 代码示例演示了上述任务。

ListMultipartUploadsRequest allMultpartUploadsRequest = 
     new ListMultipartUploadsRequest(existingBucketName);
MultipartUploadListing multipartUploadListing = 
     s3Client.listMultipartUploads(allMultpartUploadsRequest);
.NET

要列出特定存储桶上所有正在进行的分段上传，请使用 AWS SDK for .NET 低级别分段上传 API 的 ListMultipartUploadsRequest 类。AmazonS3Client.ListMultipartUploads 方法将返回 ListMultipartUploadsResponse 类（提供有关正在进行的分段上传的信息）的实例。

正在进行的分段上传是使用启动分段上传请求启动但尚未完成或停止的分段上传。有关 Amazon S3 分段上传的更多信息，请参阅 使用分段上传来上传和复制对象。

以下 C# 示例演示如何使用 AWS SDK for .NET 列出存储桶上所有正在进行的分段上传。有关设置和运行代码示例的信息，请参阅《适用于 .NET 的 AWS SDK 开发人员指南》中的适用于 .NET 的 AWS SDK 入门。

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

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

本主题说明如何使用版本 3 的 AWS SDK for PHP 中的低级别 API 类列出存储桶上所有正在进行的分段上传。有关适用于 Ruby 的 AWS 开发工具包 API 的更多信息，请转到适用于 Ruby 的 AWS 开发工具包 – 版本 2。

以下 PHP 示例演示如何列出存储桶上所有正在进行的分段上传。

 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());

Amazon Simple Storage Service API 参考的下面几节描述了列出分段上传的 REST API：

AWS Command Line Interface 中的以下各部分介绍了适用于列出分段上传的操作。