# 멀티파트 업로드 나열
<a name="list-mpu"></a>

AWS CLI, REST API 또는 AWS SDK를 사용하여 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 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) - 진행 중인 멀티파트 업로드를 나열합니다.

# REST API를 사용한 멀티파트 업로드 나열
<a name="list-mpu-rest"></a>

*Amazon Simple Storage Service API 참조*의 다음 섹션에서는 멀티파트 업로드 나열을 위한 REST API에 대해 설명합니다.
+ [ListParts](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html) - 특정 멀티파트 업로드의 업로드된 부분을 나열합니다.
+ [ListMultipartUploads](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.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\$1 예제는 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 ]

이 주제에서는 AWS SDK for PHP 버전 3의 하위 수준 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());
```

------