列出分段上传 - Amazon Simple Storage Service

列出分段上传

可以使用 AWS CLI、REST API 或 AWS SDK 检索 Amazon S3 中正在进行的分段上传的列表。您可以使用分段上传以编程方式将单个对象上传到 Amazon S3。分段上传通过一次移动对象数据的一部分，将对象移动到 Amazon S3 中。有关分段上传的更多一般信息，请参阅使用分段上传来上传和复制对象。

有关使用分段上传以及额外的校验和来上传对象的端到端过程，请参阅教程：通过分段上传来上传对象并验证其数据完整性。

下一节介绍如何使用 AWS Command Line Interface、Amazon S3 REST API 和 AWS SDK 列出正在进行的分段上传。

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

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

Java

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

低级别 API 分段上传列表过程

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