ボールトの説明 (GET 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 ストレージクラスへの移行を検討してください。

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

ボールトの説明 (GET vault)

説明

このオペレーションでは、ボールトの Amazon リソースネーム (ARN)、ボールトが作成された日、ボールト内に含まれているアーカイブの数、ボールト内のすべてのアーカイブの合計サイズなど、ボールトに関する情報が返されます。アーカイブの数と合計サイズは、Amazon Glacier が最後に生成されたボールトインベントリの時点のデータになります (「Amazon Glacier でボールトを使用する」を参照してください)。Amazon Glacier は、ほぼ毎日ボールトインベントリを生成します。つまり、ボールトのアーカイブを追加または削除し、すぐにボールトの説明リクエストを送信すると、レスポンスに変更が反映されない場合があります。

リクエスト

ボールトに関する情報を取得するには、特定のボールトリソースの URI に GET リクエストを送信します。

構文

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

注記

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

リクエストパラメータ

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

リクエストヘッダー

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

リクエスト本文

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

レスポンス

構文

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length

{
  "CreationDate" : String,
  "LastInventoryDate" : String,
  "NumberOfArchives" : Number,
  "SizeInBytes" : Number,
  "VaultARN" : String,
  "VaultName" : String
}

レスポンスヘッダー

この操作はほとんどのレスポンスに共通のレスポンスヘッダーのみを使用します。共通のレスポンスヘッダーの詳細については、「共通のレスポンスヘッダー」を参照してください。

レスポンス本文

レスポンス本文には次の JSON フィールドが含まれています。

CreationDate

ボールトが作成された日付（UTC）。

タイプ: ISO 8601 の日付形式の文字列表現。たとえば2013-03-20T17:03:43.221Z。

LastInventoryDate

Amazon Glacier が最後にボールトインベントリを完了した日付 (UTC)。ボールトのインベントリの開始の詳細については、「ジョブの開始 (ジョブの POST)」を参照してください。

タイプ: ISO 8601 の日付形式の文字列表現。たとえば2013-03-20T17:03:43.221Z。

NumberOfArchives

最後にボールトインベントリが生成された時点のボールトのアーカイブ数。ボールトを作成したばかりのときなど、ボールトでインベントリが実行されていない場合、このフィールドには null が返されます。

タイプ: 数値

SizeInBytes

最後にインベントリを生成した日付における、アーカイブごとのオーバーヘッドを含む、ボールトのアーカイブの合計サイズ (バイト単位)。ボールトを作成したばかりのときなど、ボールトでインベントリが実行されていない場合、このフィールドには null が返されます。

タイプ: 数値

VaultARN

ボールトの Amazon リソースネーム (ARN)。

タイプ: 文字列

VaultName

作成時に指定されたボールト名。ボールト名は、ボールトの ARN にも含まれます。

タイプ: 文字列

エラー

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

例

リクエストの例

以下の例は、examplevault というボールトに関する情報を取得する方法を示しています。

GET /-/vaults/examplevault HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
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

レスポンスの例

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Content-Type: application/json
Content-Length: 260

{
  "CreationDate" : "2012-02-20T17:01:45.198Z",
  "LastInventoryDate" : "2012-03-20T17:03:43.221Z",
  "NumberOfArchives" : 192,
  "SizeInBytes" : 78088912,
  "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
  "VaultName" : "examplevault"
}

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

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