ボールトロックの取得 (ロックポリシーの GET) - 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)

説明

このオペレーションでは、指定したボールトの lock-policy サブリソースの以下の属性を取得します。

  • ボールトに設定されているボールトロックポリシー。

  • ボールトロックの状態。InProgess または Locked。

  • ロック ID の有効期限。ロック ID は、ボールトロック処理を完了するために使用します。

  • ボールトロックが開始されて InProgress 状態になった時刻。

ボールトロックは、InProgressを要求することによって ボールトロックの開始 (ロックポリシーの POST) 状態になります。ボールトロックは、Lockedを要求することによって ボールトロックの完了 (ロック ID の POST) 状態になります。ボールトロック処理は、ボールトロックの中止 (ロックポリシーの DELETE)を要求することによって中止できます。ボールトロック処理の詳細については、「Amazon Glacier ボールトロック」を参照してください。

ボールトにボールトロックポリシーが設定されていない場合は、404 Not found エラーが返されます。ボールトロックポリシーの詳細については、「ボールトロックポリシー」を参照してください。

リクエスト

現在のボールトロックポリシーとその他の属性を取得するには、次の構文の例に示すように、ボールトの GET サブリソースの URI に HTTP lock-policy リクエストを送信します。

構文

GET /AccountId/vaults/vaultName/lock-policy 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 にハイフン ('-') を含めないでください。

リクエストパラメータ

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

リクエストヘッダー

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

リクエスト本文

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

レスポンス

これに対して、Amazon Glacier はレスポンス本文で JSON 形式のボールトアクセスポリシーを返します。

構文

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
				
{
  "Policy": "string",
  "State": "string",
  "ExpirationDate": "string",
  "CreationDate":"string"
}

レスポンスヘッダー

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

レスポンス本文

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

ポリシー:

JSON 文字列としてのボールトロックポリシー（エスケープ文字として "\" を使用）。

タイプ: 文字列

State

ボールトロックの状態。

型: 文字列

有効な値:InProgress |Locked

ExpirationDate

ロック ID の有効期限の日時（UTC）。この値は、ボールトロックが null 状態の場合は Locked になります。

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

CreationDate

ボールトロックが InProgress 状態になった日時 (UTC)。

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

エラー

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

例

次の例は、ボールトロックポリシーの取得方法を示しています。

リクエストの例

この例では、ボールトの GET サブリソースの URI に lock-policy リクエストを送信します。

GET /-/vaults/examplevault/lock-policy 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

レスポンスの例

リクエストが成功した場合、Amazon Glacier はレスポンス本文で JSON 文字列としてボールトアクセスポリシーを返します。返される JSON 文字列では、「ボールトロックの開始 (ロックポリシーの POST)」のリクエストの例に示すようにエスケープ文字として "\" を使用します。ただし、次の例では読みやすくするため、エスケープ文字を使用せずに、返される JSON 文字列を示します。

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

{
  "Policy": "
    {
      "Version": "2012-10-17",		 	 	 
      "Statement": [
        {
          "Sid": "Define-vault-lock",
          "Principal": {
            "AWS": "arn:aws:iam::999999999999:root"
          },
          "Effect": "Deny",
          "Action": "glacier:DeleteArchive",
          "Resource": [
            "arn:aws:glacier:us-west-2:999999999999:vaults/examplevault"
          ],
          "Condition": {
            "NumericLessThanEquals": {
              "glacier:ArchiveAgeInDays": "365"
            }
          }
        }
      ]
    }
  ",
  "State": "InProgress",
  "ExpirationDate": "exampledate",
  "CreationDate": "exampledate"  
}

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

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