# マルチパートアップロードのリスト化
<a name="list-mpu"></a>

AWS CLI、REST API、AWS SDK を使用して、Amazon S3 で進行中のマルチパートアップロードのリストを取得できます。マルチパートアップロードを使用して、プログラムで 1 つのオブジェクトを Amazon S3 にアップロードできます。マルチパートアップロードでは、オブジェクトのデータの一部を一度に移動することで、オブジェクトを Amazon S3 に移動させます。マルチパートアップロードに関する一般的な情報については、「[Amazon S3 でのマルチパートアップロードを使用したオブジェクトのアップロードとコピー](mpuoverview.md)」を参照してください。

マルチパートアップロードで追加のチェックサムを含むオブジェクトをアップロードするエンドツーエンドの手順については、「[チュートリアル: マルチパートアップロードでオブジェクトをアップロードして、データ整合性を検証する](tutorial-s3-mpu-additional-checksums.md)」を参照してください。

次のセクションでは、AWS Command Line Interface、Amazon S3 REST API、および AWS SDK を使用して、進行中のマルチパートアップロードを一覧表示する方法を示します。

## 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 ]

AWS SDK for Java を使用して、バケットで進行中のすべてのマルチパートアップロードを一覧表示するには、低レベル API クラスを使用して以下を実行します。


**低レベル API のマルチパートアップロードのリスト化プロセス**  

|  |  | 
| --- |--- |
| 1 | `ListMultipartUploadsRequest` クラスのインスタンスを作成し、バケット名を指定します。 | 
| 2 | S3Client `listMultipartUploads` メソッドを実行します。このメソッドは、進行中のマルチパートアップロードに関する情報を提供する `ListMultipartUploadsResponse` クラスのインスタンスを返します。 | 

AWS SDK for Java を使用してマルチパートアップロードを一覧表示する方法の例については、「*Amazon S3 API リファレンス*」の「[List multipart uploads](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_ListMultipartUploads_section.html)」を参照してください。

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

特定のバケットですべての進行中のマルチパートアップロードを一覧表示するには、SDK for .NET の低レベルのマルチパートアップロード API の `ListMultipartUploadsRequest` クラスを使用します。`AmazonS3Client.ListMultipartUploads` メソッドは、`ListMultipartUploadsResponse` クラスのインスタンスを返し、進行中のマルチパートアップロードに関する情報を提供します。

進行中のマルチパートアップロードとは、マルチパートアップロードの開始リクエストによって開始されてから、まだ完了または中止されていないマルチパートアップロードです。Amazon S3 マルチパートアップロードの詳細については、[Amazon S3 でのマルチパートアップロードを使用したオブジェクトのアップロードとコピー](mpuoverview.md) を参照してください。

次の C\# の例では、SDK for .NET を使用してバケットで進行中のマルチパートアップロードを一覧表示する方法を示します。コード例を設定および実行する方法の詳細については、「*AWS SDK for .NET デベロッパーガイド*」の「[AWS SDK for .NET の開始方法](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-setup.html)」 を参照してください。

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

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

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

このトピックでは、バージョン 3 の AWS SDK for PHP の低レベル API クラスを使用して、バケットで進行中のすべてのマルチパートアップロードを一覧表示する方法を示します。AWS SDK for Ruby API の詳細については、[AWS SDK for Ruby - バージョン 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());
```

------