このページは、ボールトと 2012 年リリース当時の REST API を使用する、Amazon Glacier サービスの既存のお客様のみを対象としています。

アーカイブストレージソリューションをお探しの場合は、Amazon S3 の Amazon Glacier ストレージクラス (S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval、S3 Glacier Deep Archive) を使用することをお勧めします。これらのストレージオプションの詳細については、「Amazon Glacier ストレージクラス」を参照してください。

Amazon Glacier (元のスタンドアロンボールトベースのサービス) は、新規顧客を受け入れなくなりました。Amazon Glacier は、ボールトにデータを保存する独自の API を備えたスタンドアロンサービスであり、Amazon S3 および Amazon S3 Glacier ストレージクラスとは異なります。既存のデータは Amazon Glacier で無期限に安全性が確保され、引き続きアクセス可能です。移行は必要ありません。低コストの長期アーカイブストレージの場合、 は Amazon S3 Glacier ストレージクラス AWS を推奨します。これにより、S3 バケットベースの APIs、低コスト、 AWS サービス統合で優れたカスタマーエクスペリエンスを実現できます。 AWS リージョン 拡張機能が必要な場合は、Amazon Glacier ボールトから Amazon S3 Glacier ストレージクラスにデータを転送するためのAWS ソリューションガイダンスを使用して、Amazon S3 Glacier ストレージクラスへの移行を検討してください。

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

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

説明

この操作では、マルチパートアップロードを開始します (パート単位での大きなアーカイブのアップロード (マルチパートアップロード)を参照してください。)。Amazon 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 つアップロードされます。

マルチパートアップロードが完了すると、Amazon Glacier は ID によって参照されるマルチパートアップロードリソースを削除します。マルチパートアップロードがキャンセルされた場合も、Amazon 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

リクエストパラメータ

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

リクエストヘッダー

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

リクエスト本文

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

レスポンス

レスポンスでは、Amazon 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

レスポンスヘッダー

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

レスポンス本文

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

エラー

Amazon 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

レスポンスの例

Amazon 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)」を参照してください。

関連するセクション