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

# 列出分段上傳
<a name="list-mpu"></a>

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

如需搭配額外檢查總和使用分段上傳來上傳物件的端對端程序，請參閱[教學課程：透過分段上傳來上傳物件並驗證其資料完整性](tutorial-s3-mpu-additional-checksums.md)。

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

## 使用 列出分段上傳 AWS CLI
<a name="list-mpu-cli"></a>

中的下列各節 AWS Command Line Interface 說明列出分段上傳的操作。
+ [list-parts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/list-parts.html) – 列出特定分段上傳的已上傳部分。
+ [list-multipart-uploads](https://docs.aws.amazon.com/cli/latest/reference/s3api/list-multipart-uploads.html) – 列表進行中的分段上傳。

## 使用 AWS SDK 列出分段上傳 （低階 API)
<a name="list-aws-sdk"></a>

------
#### [ Java ]

若要使用適用於 Java 的 AWS SDK 列出儲存貯體上的所有進行中分段上傳，您可以使用低階 API 類別來：


**低階 API 分段上傳列出程序**  

|  |  | 
| --- |--- |
| 1 | 建立 `ListMultipartUploadsRequest` 類別的執行個體，並提供儲存貯體名稱。 | 
| 2 | 執行 S3Client `listMultipartUploads` 方法。此方法會傳回 `ListMultipartUploadsResponse` 類別的執行個體，提供您進行中分段上傳的相關資訊。 | 

如需如何使用適用於 Java 的 AWS SDK 列出分段上傳的範例，請參閱《*Amazon S3 API 參考*》中的[列出分段上傳](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_ListMultipartUploads_section.html)。

------
#### [ .NET ]

若要列出特定儲存貯體上所有進行中的分段上傳，請使用 適用於 .NET 的 SDK 低階分段上傳 API 的 `ListMultipartUploadsRequest` 類別。`AmazonS3Client.ListMultipartUploads` 方法會傳回 `ListMultipartUploadsResponse` 類別的執行個體，提供進行中分段上傳的相關資訊。

進行中的分段上傳是已使用起始分段上傳請求啟動，但尚未完成或停止的分段上傳。如需 Amazon S3 分段上傳的詳細資訊，請參閱 [在 Amazon S3 中使用分段上傳來上傳和複製物件](mpuoverview.md)。

下列 C\# 範例示範如何使用 適用於 .NET 的 SDK 列出儲存貯體上所有進行中的分段上傳。如需有關設定和執行程式碼範例的資訊，請參閱《[適用於 .NET 的 AWS SDK 開發人員指南》中的適用於 .NET 的 SDK 入門](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-setup.html)。 *AWS *

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

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

------
#### [ PHP ]

本主題說明如何使用 第 3 版的低階 API 類別 適用於 PHP 的 AWS SDK ，列出儲存貯體上所有進行中的分段上傳。如需適用於 Ruby 的 AWS SDK API 的詳細資訊，請前往[AWS 適用於 Ruby 的 SDK - 第 2 版](https://docs.aws.amazon.com/sdkforruby/api/index.html)。

下列 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());
```

------