マルチパートアップロードのリスト化 - Amazon Simple Storage Service

マルチパートアップロードのリスト化

AWS CLI、REST API、AWS SDK を使用して、Amazon S3 で進行中のマルチパートアップロードのリストを取得できます。マルチパートアップロードを使用して、プログラムで 1 つのオブジェクトを 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 リファレンスの以下のセクションでは、マルチパートアップロードをリスト化するための REST API について説明します。

  • ListParts － 特定のマルチパートアップロードでアップロードされた部分を一覧表示します。

  • ListMultipartUploads － 進行中のマルチパートアップロードを一覧表示します。

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 マルチパートアップロードの詳細については、Amazon S3 でのマルチパートアップロードを使用したオブジェクトのアップロードとコピー を参照してください。

次の C# の例では、AWS 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);
PHP

このトピックでは、バージョン 3 の AWS SDK for PHP の低レベル 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());