列出分段上傳 - Amazon Simple Storage Service

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

列出分段上傳

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

如需使用額外檢查總和上傳具有分段上傳的物件的 a end-to-end 程序，請參閱 教學課程：透過分段上傳上傳物件，並驗證其資料完整性。

下一節說明如何使用 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 分段上傳的詳細資訊，請參閱 使用分段上傳來上傳和複製物件。

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

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

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

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