ボールトの作成 (PUT vault) - Amazon Glacier
説明リクエストレスポンス例関連するセクション以下の資料も参照してください。

このページは、ボールトと 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 ストレージクラスへの移行を検討してください。

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

ボールトの作成 (PUT vault)

説明

このオペレーションでは、指定した名前の新しいボールトを作成します。  ボールト名は AWS アカウント の AWS リージョン内で一意である必要があります。アカウントにつき最大 1,000 個のボールトを作成できます。ボールトの追加作成の詳細については、Amazon Glacier の製品詳細ページを参照してください。

ボールトの名前を指定する際は、以下のガイドラインに従う必要があります。

  • 名前は 1～255 文字の長さです。

  • 使用できる文字は、a-z、A-Z、0-9、'_' (アンダースコア)、'-' (ハイフン)、'.' (ピリオド) です。

このオペレーションはべき等です。同じリクエストを何度も送信できますが、指定したボールトが最初に Amazon Glacier によって作成された後は、リクエストがあってもそれ以上項目への影響はありません。

リクエスト

構文

ボールトを作成するには、作成するボールトの URI に HTTP PUT リクエストを送信します。

PUT /AccountId/vaults/VaultName HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01

注記

-AccountIdvalueAWS アカウントID。この値はリクエストの署名に使用した認証情報に関連する AWS アカウント ID と一致する必要があります。AWS アカウント ID、または Amazon Glacier がリクエストの署名に使用した認証情報に関連する AWS アカウント ID を使用している場合はオプションで '-' (ハイフン) のどちらかを指定できます。お客様のアカウント ID を指定する場合は、ハイフン(`-`)を含めないでください。

リクエストパラメータ

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

リクエストヘッダー

このオペレーションは、すべてのオペレーションに共通のリクエストヘッダーのみを使用します。共通のリクエストヘッダーの詳細については、「一般的なリクエストヘッダー」を参照してください。

リクエスト本文

このオペレーションのリクエストボディを空（0 バイト）にする必要があります。

レスポンス

構文

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location

レスポンスヘッダー

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

名前 説明

Location

作成されたボールトの相対 URI パス。

タイプ: 文字列

レスポンス本文

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

エラー

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

例

リクエストの例

次の例では、HTTP PUT リクエストを送信して、examplevault というボールトを作成します。

PUT /-/vaults/examplevault HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Content-Length: 0
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 によりボールトが作成され、Location ヘッダーにボールトの相対 URI パスが返されます。リクエストでアカウント ID を指定したか、ハイフン ("Location") を指定したかに関係なく、- ヘッダーにはアカウント ID が常に表示されます。

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Location: /111122223333/vaults/examplevault

以下の資料も参照してください。

言語固有の Amazon SDK のいずれかでこの API を使用する方法の詳細については、次を参照してください。