パート単位での大きなアーカイブのアップロード (マルチパートアップロード)

トピック

• マルチパートアップロードのプロセス
• 基本情報
• AWS CLI を使用して大きなアーカイブをアップロードする
• Amazon SDK for Java を使用してパート単位で大きなアーカイブをアップロードする
• AWS SDK for .NET を使用して大きなアーカイブをアップロードする
• REST API を使用してパート単位で大きなアーカイブをアップロードする

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

「Amazon S3 Glacier へのアーカイブのアップロード」で説明しているように、Amazon S3 Glacier (S3 Glacier) をご利用のお客様には、100 メビバイト (MiB) を超えるサイズのアーカイブをアップロードする際にはマルチパートアップロードを使用することをお勧めします。

1. Initiate Multipart Upload

   マルチパートアップロードを開始するリクエストを送信すると、マルチパートアップロード ID が S3 Glacier から返されます。アップロード ID はマルチパートアップロードの一意の識別子です。後続のマルチパートアップロードオペレーションには、この ID が必要です。この ID は、S3 Glacier がジョブを完了してから少なくとも 24 時間は有効です。

   マルチパートアップロードの開始リクエストで、パートサイズをバイト数で指定します。アップロードするパートは、最後のパートを除き、すべてこのサイズになります。

   注記

   マルチパートアップロードを使用する際にアーカイブ全体のサイズを把握している必要はありません。つまり、アーカイブのアップロードを開始するときにアーカイブのサイズがわからない場合でも、マルチパートアップロードを使用できます。パートサイズを決定する必要があるのは、マルチパートアップロードの開始時のみです。

   マルチパートアップロードの開始リクエストでは、オプションでアーカイブの説明を指定することもできます。

2. パートのアップロード

   パートのアップロードの各リクエストに、ステップ 1 で取得したマルチパートアップロード ID を含める必要があります。リクエストには、最終的なアーカイブ内でのパートの位置を特定するコンテンツ範囲をバイト単位で指定する必要もあります。S3 Glacier は後でコンテンツ範囲情報を使用して、アーカイブを適切な順序で組み立てます。アップロードする各パートのコンテンツ範囲を指定するため、≷ は最終的にアセンブルされたアーカイブ内でのパートの位置を特定できます。そのため、任意の順序でパートをアップロードできます。このほか、複数のパートを並行してアップロードすることもできます。以前にアップロードしたパートと同じコンテンツ範囲を使って新しいパートをアップロードした場合、以前のパートは上書きされます。

3. マルチパートアップロードの完了 (または中止)

   アーカイブのパートをすべてアップロードしたら、完了オペレーションを使用します。ここでも、リクエストでアップロード ID を指定する必要があります。S3 Glacier は、指定したコンテンツ範囲に基づいて昇順に連結されたアーカイブを作成します。マルチパートアップロードの完了リクエストに対する S3 Glacier レスポンスには、新しく作成されたアーカイブのアーカイブ ID が含まれます。マルチパートアップロードの開始リクエストでオプションのアーカイブの説明を指定した場合は、S3 Glacier により、アセンブルされたアーカイブにそのアーカイブの説明が関連付けられます。マルチパートアップロードが正常に完了すると、マルチパートアップロード ID を参照できなくなります。つまり、マルチパートアップロード ID に関連付けられているパートにアクセスできなくなります。

   マルチパートアップロードを中止すると、そのマルチパートアップロード ID を使用してパートをアップロードできなくなります。中止されたマルチパートアップロードに関連付けられているパートによって消費されているストレージはすべて解放されます。パートのアップロードが進行しているときにマルチパートアップロードを停止した場合は、停止後もそのパートのアップロードは成功または失敗する可能性があります。

その他のマルチパートアップロードオペレーション

Amazon S3 Glacier (S3 Glacier) には、次のマルチパートアップロード API コールが追加で用意されています。

• パートのリスト - このオペレーションを使用すると、特定のマルチパートアップロードのパートのリストを表示できます。マルチパートアップロードでアップロードしたパートに関する情報が返されます。パートのリストのリクエストごとに、S3 Glacier により最大 1,000 個のパートの情報が返されます。表示するマルチパートアップロードのパートがさらにある場合、結果がページ分割され、レスポンスにはリストの続きを表示するためのマーカーが返されます。後続のパートを取得するには、追加のリクエストを送信する必要があります。返されるパートのリストには、アップロードが完了していないパートは含まれていないことにご留意ください。

• マルチパートアップロードのリスト - このオペレーションを使用すると、進行中のマルチパートアップロードのリストを取得できます。進行中のマルチパートアップロードとは、開始されているものの、まだ完了または停止されていないアップロードを意味します。マルチパートアップロードのリストのリクエストごとに、S3 Glacier は最大 1,000 個のマルチパートアップロードが返します。表示するマルチパートアップロードがさらにある場合、結果がページ分割され、レスポンスにはリストの続きを表示するためのマーカーが返されます。残りのマルチパートアップロードを取得するには、追加のリクエストを送信する必要があります。

基本情報

次の表は、マルチパートアップロードの主な仕様をまとめたものです。

項目	仕様
アーカイブの最大サイズ	10,000 x 4 ギビバイト (GiB)
アップロードあたりの最大パート数	10,000
パートサイズ	1 MiB～4 GiB、最後の部分は 1 MiB 未満にすることができます。サイズの値をバイト単位で指定します。 パートサイズは、メビバイト (1024 キビバイト [KiB]) に 2 の累乗を掛けた値でなければなりません。たとえば、1048576 (1 MiB)、2097152 (2 MiB)、4194304 (4 MiB)、8388608 (8 MiB) です。
パートのリストリクエストで返されるパートの最大数	1,000
マルチパートアップロードのリストリクエストで返されるマルチパートアップロードの最大数	1,000