このページは、Vaults と 2012 年の元の REST API を使用する Amazon Glacier サービスの既存のお客様専用です。
アーカイブストレージソリューションをお探しの場合は、Amazon Glacier Amazon S3、S3 Glacier Flexible Retrieval、S3 S3 Glacier Deep Archive の Amazon Glacier ストレージクラスを使用することをお勧めします。これらのストレージオプションの詳細については、Amazon Glacier ストレージクラス
Amazon Glacier (元のスタンドアロンボールトベースのサービス) は、2025 年 12 月 15 日以降、既存の顧客に影響を与えずに新規顧客を受け入れなくなります。Amazon Glacier は、ボールトにデータを保存する独自の APIs を備えたスタンドアロンサービスであり、Amazon S3 および Amazon S3 Glacier ストレージクラスとは異なります。既存のデータは Amazon Glacier で無期限に安全でアクセス可能です。移行は必要ありません。低コストの長期アーカイブストレージの場合、 は Amazon S3 Glacier ストレージクラス
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
アーカイブのアップロード (POST archive)
説明
このオペレーションでは、ボールトにアーカイブを追加します。正常にアップロードされると、データは永続的に保持されます。レスポンスでは、Amazon Glacier (Amazon Glacier) はレスポンスの x-amz-archive-idヘッダーにアーカイブ ID を返します。後でアーカイブにアクセスできるように、返されたアーカイブ ID を保管しておく必要があります。
アップロードするデータの SHA256 木構造ハッシュを指定する必要があります。SHA256 木構造ハッシュの計算の詳細については、「チェックサムの計算」を参照してください。
注記
SHA256 木構造ハッシュは、API を使用する場合のアーカイブのアップロード (POST アーカイブ) アクションにのみ必要です。を使用する場合は必要ありません AWS CLI。
アーカイブのアップロード時に、オプションでアーカイブの説明を最大 1,024 文字の印刷可能な ASCII 文字で指定できます。Amazon Glacier は、アーカイブを取得するか、ボールトインベントリを取得すると、アーカイブの説明を返します。Amazon Glacier は説明をいかなる方法でも解釈しません。アーカイブの説明は、一意である必要はありません。説明を使用して、アーカイブのリストを取得することや、ソートすることはできません。
オプションのアーカイブの説明を除き、Amazon Glacier はアーカイブの追加メタデータをサポートしていません。アーカイブ ID は、アーカイブに関するどのような情報も推察することができないように、意味のない文字列になっています。そのため、クライアント側でアーカイブに関するメタデータを管理することもできます。詳細については、「Amazon Glacier でのアーカイブの操作」を参照してください。
アーカイブは変更不可能です。アーカイブをアップロードした後で、アーカイブやアーカイブの説明を編集することはできません。
リクエスト
アーカイブをアップロードするには、HTTP POST メソッドを使用し、アーカイブの保存先となるボールトの archives サブリソースをリクエストの範囲として指定します。リクエストには、アーカイブのペイロードサイズ、チェックサム（SHA256 木構造ハッシュ）を含める必要があります。オプションでアーカイブの説明を含めることができます。
構文
POST /AccountId/vaults/VaultName/archives Host: glacier.Region.amazonaws.com x-amz-glacier-version: 2012-06-01 Date:DateAuthorization:SignatureValuex-amz-archive-description:Descriptionx-amz-sha256-tree-hash:SHA256 tree hashx-amz-content-sha256:SHA256 linear hashContent-Length:Length<Request body.>
注記
AccountId 値は、ボールトを所有するアカウントの AWS アカウント ID です。 AWS アカウント ID またはオプションで単一の '-' (ハイフン) を指定できます。この場合、Amazon Glacier はリクエストの署名に使用される認証情報に関連付けられた AWS アカウント ID を使用します。アカウント ID を使用する場合は、ID にハイフン ('-') を含めないでください。
リクエストパラメーター
オペレーションの実装では、リクエストパラメータを使用しません。
リクエストヘッダー
この操作では、すべての操作で共通のリクエストヘッダーに加えて、次のリクエストヘッダーを使用します。共通のリクエストヘッダーの詳細については、「一般的なリクエストヘッダー」を参照してください。
| 名前 | 説明 | 必須 |
|---|---|---|
Content-Length
|
オブジェクトのサイズ（バイト単位）。詳細については、http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13 タイプ: 数値 デフォルト: なし 制約: なし |
あり |
x-amz-archive-description
|
アップロードするアーカイブのオプションの説明。わかりやすい説明や、割り当てる何らかの識別子を自分で選択して指定できます。説明は、すべてのアーカイブで一意である必要はありません。ボールトインベントリを取得した場合 (「ジョブの開始 (ジョブの POST)」を参照)、レスポンスで返されるアーカイブごとにこの説明が含まれます。 タイプ: 文字列 デフォルト: なし 制約: 説明は 1,024 文字以下である必要があります。使用可能な文字は、制御コードを除く 7 ビット ASCII コードです。具体的には、32—126 (10 進) または 0x20—0x7E (16 進) の ASCII 値です。 |
なし |
x-amz-content-sha256
|
ペイロードの SHA256 チェックサム (線形ハッシュ)。この値は、 タイプ: 文字列 デフォルト: なし 制約: なし |
あり |
x-amz-sha256-tree-hash
|
ユーザーが計算したペイロードのチェックサム（SHA256 木構造ハッシュ）。SHA256 木構造ハッシュの計算については、「チェックサムの計算」を参照してください。Amazon Glacier がペイロードの別のチェックサムを計算すると、リクエストは拒否されます。 タイプ: 文字列 デフォルト: なし 制約: なし |
あり |
リクエスト本文
リクエストボディには、アップロードするデータを含めます。
レスポンス
これに応じて、Amazon Glacier はアーカイブを永続的に保存し、アーカイブ ID への URI パスを返します。
構文
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier Location: Location x-amz-archive-id: ArchiveId
レスポンスヘッダー
成功したレスポンスには、すべての操作に共通のレスポンスヘッダーに加えて、次のレスポンスヘッダーが含まれます。共通のレスポンスヘッダーの詳細については、「共通のレスポンスヘッダー」を参照してください。
| 名前 | 説明 |
|---|---|
Location
|
新しく追加されたアーカイブリソースの相対 URI パス。 タイプ: 文字列 |
x-amz-archive-id
|
アーカイブの ID。この値も タイプ: 文字列 |
x-amz-sha256-tree-hash |
Amazon Glacier によって計算されたアーカイブのチェックサム。 タイプ: 文字列 |
レスポンス本文
このオペレーションはレスポンス本文を返しません。
エラー
Amazon Glacier の例外とエラーメッセージについては、「」を参照してくださいエラーレスポンス。
例
リクエストの例
次の例に、アーカイブをアップロードするリクエストを示します。
POST /-/vaults/examplevault/archives HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 x-amz-content-sha256: 7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3 Content-Length: 2097152 x-amz-glacier-version: 2012-06-01 Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace <Request body (2097152 bytes).>
レスポンスの例
以下の正常なレスポンスには、Amazon Glacier がアーカイブに割り当てた ID を取得できるLocationヘッダーがあります。
HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
関連するセクション
