멀티파트 업로드 나열

멀티파트 업로드 나열 (Listing multipart uploads)

AWS CLI, REST API 또는 AWS SDK를 사용해 Amazon S3의 진행 중인 멀티파트 업로드 목록을 검색할 수 있어요. 멀티파트 업로드를 사용하면 단일 객체를 프로그래밍 방식으로 Amazon S3에 업로드할 수 있어요. 멀티파트 업로드는 객체 데이터의 일부를 한 번에 하나씩 이동해 Amazon S3로 객체를 옮겨요. 멀티파트 업로드에 대한 일반적인 정보는 Amazon S3에서 멀티파트 업로드를 사용한 객체 업로드 및 복사를 참고하세요.

출처: 문서

본문

추가 체크섬과 함께 멀티파트 업로드로 객체를 업로드하는 종단 간 절차는 멀티파트 업로드로 객체 업로드 및 데이터 무결성 확인 튜토리얼을 참고하세요.

다음 절은 AWS Command Line Interface, Amazon S3 REST API 및 AWS SDK로 진행 중인 멀티파트 업로드를 나열하는 방법을 보여줘요.

AWS Command Line Interface의 다음 절은 멀티파트 업로드 나열 작업을 설명해요.

  • list-parts – 특정 멀티파트 업로드에 업로드된 부분을 나열해요.
  • list-multipart-uploads – 진행 중인 멀티파트 업로드를 나열해요.

Amazon Simple Storage Service API Reference의 다음 절은 멀티파트 업로드 나열을 위한 REST API를 설명해요.

  • ListParts – 특정 멀티파트 업로드에 업로드된 부분을 나열해요.
  • ListMultipartUploads – 진행 중인 멀티파트 업로드를 나열해요.

Java | .NET | PHP

AWS SDK for Java를 사용해 버킷의 모든 진행 중인 멀티파트 업로드를 나열하려면 로우 레벨 API 클래스를 사용할 수 있어요.

로우 레벨 API 멀티파트 업로드 나열 절차

  1. ListMultipartUploadsRequest 클래스의 인스턴스를 만들고 버킷 이름을 제공해요.
  2. S3Client listMultipartUploads 메서드를 실행해요. 이 메서드는 진행 중인 멀티파트 업로드에 대한 정보를 제공하는 ListMultipartUploadsResponse 클래스의 인스턴스를 반환해요.

AWS SDK for Java로 멀티파트 업로드를 나열하는 예시는 Amazon S3 API Reference의 멀티파트 업로드 나열을 참고하세요.

특정 버킷의 모든 진행 중인 멀티파트 업로드를 나열하려면 SDK for .NET 로우 레벨 멀티파트 업로드 API의 ListMultipartUploadsRequest 클래스를 사용해요. AmazonS3Client.ListMultipartUploads 메서드는 진행 중인 멀티파트 업로드에 대한 정보를 제공하는 ListMultipartUploadsResponse 클래스의 인스턴스를 반환해요.

진행 중인 멀티파트 업로드는 멀티파트 업로드 시작 요청을 사용해 시작됐지만 아직 완료되거나 중지되지 않은 멀티파트 업로드예요. Amazon S3 멀티파트 업로드에 대한 자세한 내용은 Amazon S3에서 멀티파트 업로드를 사용한 객체 업로드 및 복사를 참고하세요.

다음 C# 예시는 SDK for .NET을 사용해 버킷의 모든 진행 중인 멀티파트 업로드를 나열하는 방법을 보여줘요. 코드 예시를 설정하고 실행하는 방법에 대한 자세한 내용은 AWS SDK for .NET 개발자 가이드의 AWS SDK for .NET 시작하기를 참고하세요.

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

ListMultipartUploadsResponse response = await AmazonS3Client.ListMultipartUploadsAsync(request);

이 주제는 AWS SDK for PHP 버전 3의 로우 레벨 API 클래스를 사용해 버킷의 모든 진행 중인 멀티파트 업로드를 나열하는 방법을 보여줘요. 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());

더 알아보기 (Learn more)