マルチパートアップロードの開始 (POST multipart-uploads) - Amazon S3 Glacier
説明リクエストレスポンス例 関連するセクション

このページは、Vaults と 2012 RESTAPI年のオリジナルを使用する S3 Glacier サービスの既存のお客様専用です。

アーカイブストレージソリューションをお探しの場合は、Amazon S3、S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval、S3 Glacier Deep Archive の S3 Glacier ストレージクラスを使用することをお勧めします。これらのストレージオプションの詳細については、Amazon S3 ユーザーガイドの「S3 Glacier ストレージクラス」およびS3 Glacier ストレージクラスを使用した長期データストレージ」を参照してください。 Amazon S3 これらのストレージクラスは Amazon S3 を使用しAPI、すべてのリージョンで利用可能で、Amazon S3 コンソール内で管理できます。Storage Cost Analysis、Storage Lens、高度なオプションの暗号化機能などの機能を提供します。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

マルチパートアップロードの開始 (POST multipart-uploads)

説明

この操作では、マルチパートアップロードを開始します (パート単位での大きなアーカイブのアップロード (マルチパートアップロード)を参照してください。)。Amazon S3 Glacier (S3 Glacier) により、マルチパートアップロードリソースが作成され、レスポンスでその ID が返されます。後続のマルチパートアップロードオペレーションでは、このアップロード ID を使用します。

マルチパートアップロードを開始する際に、パートサイズをバイト単位で指定します。パートサイズは、メビバイト (MiB) (1024 キビバイト [KiB]) に 2 の累乗を乗じた値であることが必要です。例えば、1048576 (1 MiB)、2097152 (2 MiB)、4194304 (4 MiB)、8388608 (8 MiB) などです。許容される最小のパートサイズは 1 MiB で、最大は 4 ギビバイト (GiB) です。

このアップロード ID を使用してアップロードするパートは、最後のパートを除き、すべて同じサイズになります。最後のパートは、同じサイズ以下になります。たとえば、16.2 MiB のファイルをアップロードするとします。4 MiB のパートサイズでマルチパートアップロードを開始した場合、各 4 MiB のパートが 4 つと 0.2 MiB のパートが 1 つアップロードされます。

注記

S3 Glacier ではアーカイブ全体のサイズを指定する必要がないため、マルチパートアップロードを開始する際にアーカイブのサイズを把握している必要はありません。

マルチパートアップロードが完了すると、S3 Glacier は ID によって参照されるマルチパートアップロードリソースを削除します。マルチパートアップロードをキャンセルした場合も、S3 Glacier により、マルチパートアップロードリソースが削除されます。24 時間アクティビティがない場合も削除されることがあります。ID は 24 時間後も引き続き使用できる場合がありますが、アプリケーションでこの動作を想定しないでください。

リクエスト

マルチパートアップロードを開始するには、アーカイブの保存先となるボールトの POST サブリソースの URI に HTTP multipart-uploads リクエストを送信します。リクエストにはパートサイズを含める必要があります。また、オプションでアーカイブの説明を含めることができます。

構文

POST /AccountId/vaults/VaultName/multipart-uploads 
Host: glacier.us-west-2.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01
x-amz-archive-description: ArchiveDescription
x-amz-part-size: PartSize

注記

-AccountIdvalueAWS アカウントボールトを所有するアカウントの ID。AWS アカウント ID、または Amazon S3 Glacier がリクエストの署名に使用した認証情報に関連する AWS アカウント ID を使用している場合はオプションで`-`「-」のどちらかを指定できます。アカウント ID を使用する場合は、ID にハイフン ('-') を含めないでください。

リクエストパラメータ

このオペレーションではリクエストパラメータを使用しません。

リクエストヘッダー

この操作では、すべての操作で共通のリクエストヘッダーに加えて、次のリクエストヘッダーを使用します。共通のリクエストヘッダーの詳細については、「一般的なリクエストヘッダー」を参照してください。

名前 説明 必須
x-amz-part-size

最後を除く各パートのサイズ (バイト単位)。最後のパートはこのパートサイズより小さくなる場合があります。

型: 文字列

デフォルト: なし

制約: パートサイズは、メビバイト (1024 KiB) に 2 の累乗を乗じた値であることが必要です。例えば、1048576 (1 MiB)、2097152 (2 MiB)、4194304 (4 MiB)、8388608 (8 MiB) などです。許容される最小のパートサイズは 1 MiB で、最大は 4 GiB (4096 MiB) です。

 Yes
x-amz-archive-description

パート単位でアップロードするアーカイブの説明。わかりやすい説明や、割り当てる何らかの一意の識別子を自分で選択して指定できます。ボールトインベントリを取得した場合 (「ジョブの開始 (POST ジョブ）」を参照)、レスポンスに返されるアーカイブごとにこの説明がインベントリに含まれます。アーカイブの説明の先頭の空白は削除されます。

型: 文字列

デフォルト: なし

制約事項: 説明は 1024 バイト以下である必要があります。使用可能な文字は、制御コードを除く 7 ビット ASCII コードです。具体的には、32～126 (10 進) または 0x20～0x7E (16 進) の ASCII 値です。

 No

リクエスト本文

この操作にリクエストボディはありません。

レスポンス

レスポンスでは、S3 Glacier により、ID によって識別されたマルチパートアップロードリソースが作成され、マルチパートアップロード ID の相対 URI パスが返されます。

構文

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location
x-amz-multipart-upload-id: multiPartUploadId

レスポンスヘッダー

成功したレスポンスには、すべての操作に共通のレスポンスヘッダーに加えて、次のレスポンスヘッダーが含まれます。共通のレスポンスヘッダーの詳細については、「共通のレスポンスヘッダー」を参照してください。

名前 説明
Location

S3 Glacier によって作成されたマルチパートアップロード ID の相対 URI パス。この URI パス を使用して、パートをアップロードするリクエストの範囲を指定し、マルチパートアップロードを完了します。

型: 文字列
x-amz-multipart-upload-id

マルチパートアップロードの ID。この値も Location ヘッダーの一部として含まれます。

型: 文字列

レスポンス本文

このオペレーションでは、レスポンス本文は返しません。

エラー

Amazon S3 Glacier の例外とエラーメッセージについては、「エラーレスポンス」を参照してください。

例

リクエストの例

次の例では、POST というボールトの multipart-uploads サブリソースの URI に HTTP examplevault リクエストを送信して、マルチパートアップロードを開始します。リクエストには、4 MiB（4194304 バイト）のパートサイズとオプションのアーカイブの説明を指定するヘッダーが含まれています。

POST /-/vaults/examplevault/multipart-uploads 
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-archive-description: MyArchive-101
x-amz-part-size: 4194304
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

レスポンスの例

S3 Glacier により、マルチパートアップロードリソースが作成され、ボールトの multipart-uploads サブリソースにそのリソースが追加されます。Location レスポンスヘッダーには、マルチパートアップロード ID の相対 URI パスが含まれています。

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Location: /111122223333/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
x-amz-multipart-upload-id: OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE

個々のパートのアップロードについては、「パートのアップロード (PUT uploadID)」を参照してください。