列出分段上傳 - Amazon Simple Storage Service

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

列出分段上傳

您可以使用 AWS CLI、REST API 或 AWS SDKs，擷取 Amazon S3 中正在進行的分段上傳清單。您可以使用分段上傳，以程式設計方式將單一物件上傳到 Amazon S3。分段上傳會一次移動一部分物件資料，將物件移至 Amazon S3。如需更多分段上傳的一般資訊，請參閱在 Amazon S3 中使用分段上傳來上傳和複製物件。

如需搭配額外檢查總和使用分段上傳來上傳物件的端對端程序，請參閱教學課程：透過分段上傳來上傳物件並驗證其資料完整性。

下一節說明如何使用 AWS Command Line Interface、Amazon S3 REST API 和 AWS SDKs 列出進行中分段上傳。

中的下列各節 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 分段上傳的詳細資訊，請參閱 在 Amazon S3 中使用分段上傳來上傳和複製物件。

下列 C# 範例示範如何使用 AWS SDK for .NET 列出儲存貯體上所有進行中分段上傳。如需有關設定和執行程式碼範例的資訊，請參閱《適用於 .NET 的 AWS SDK 開發人員指南》中的適用於 .NET 的 SDK 入門。 AWS 

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

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

本主題說明如何使用 第 3 版的低階 API 類別 AWS SDK for PHP ，列出儲存貯體上所有進行中分段上傳。如需適用於 Ruby 的 AWS SDK API 的詳細資訊，請前往AWS 適用於 Ruby 的 SDK - 第 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());