**このページは、ボールトと 2012 年リリース当時の REST API を使用する、Amazon Glacier サービスの既存のお客様のみを対象としています。**
アーカイブストレージソリューションをお探しの場合は、Amazon S3 の Amazon Glacier ストレージクラス (S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval、S3 Glacier Deep Archive) を使用することをお勧めします。これらのストレージオプションの詳細については、「[Amazon Glacier ストレージクラス](https://aws.amazon.com/s3/storage-classes/glacier/)」を参照してください。
Amazon Glacier (元のスタンドアロンボールトベースのサービス) は、新規顧客を受け入れなくなりました。Amazon Glacier は、ボールトにデータを保存する独自の API を備えたスタンドアロンサービスであり、Amazon S3 および Amazon S3 Glacier ストレージクラスとは異なります。既存のデータは Amazon Glacier で無期限に安全性が確保され、引き続きアクセス可能です。移行は必要ありません。低コストの長期アーカイブストレージの場合、 は [Amazon S3 Glacier ストレージクラス](https://aws.amazon.com/s3/storage-classes/glacier/) AWS を推奨します。これにより、S3 バケットベースの APIs、低コスト、 AWS サービス統合で優れたカスタマーエクスペリエンスを実現できます。 AWS リージョン 拡張機能が必要な場合は、[Amazon Glacier ボールトから Amazon S3 Glacier ストレージクラスにデータを転送するためのAWS ソリューションガイダンス](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)を使用して、Amazon S3 Glacier ストレージクラスへの移行を検討してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ボールトロックの取得 (ロックポリシーの GET)
## 説明
このオペレーションでは、指定したボールトの `lock-policy` サブリソースの以下の属性を取得します。
+ ボールトに設定されているボールトロックポリシー。
+ ボールトロックの状態。`InProgess` または `Locked`。
+ ロック ID の有効期限。ロック ID は、ボールトロック処理を完了するために使用します。
+ ボールトロックが開始されて `InProgress` 状態になった時刻。
ボールトロックは、`InProgress`を要求することによって [ボールトロックの開始 (ロックポリシーの POST)](api-InitiateVaultLock.md) 状態になります。ボールトロックは、`Locked`を要求することによって [ボールトロックの完了 (ロック ID の POST)](api-CompleteVaultLock.md) 状態になります。ボールトロック処理は、[ボールトロックの中止 (ロックポリシーの DELETE)](api-AbortVaultLock.md)を要求することによって中止できます。ボールトロック処理の詳細については、「[Amazon Glacier ボールトロック](vault-lock.md)」を参照してください。
ボールトにボールトロックポリシーが設定されていない場合は、`404 Not found` エラーが返されます。ボールトロックポリシーの詳細については、「[ボールトロックポリシー](vault-lock-policy.md)」を参照してください。
## リクエスト
現在のボールトロックポリシーとその他の属性を取得するには、次の構文の例に示すように、ボールトの `GET` サブリソースの URI に HTTP `lock-policy` リクエストを送信します。
### 構文
```
1. GET /AccountId/vaults/vaultName/lock-policy HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```
**注記**
`AccountId` 値は、ボールトを所有するアカウントの AWS アカウント ID です。 AWS アカウント ID またはオプションで単一の '`-`' (ハイフン) を指定できます。この場合、Amazon Glacier はリクエストの署名に使用される認証情報に関連付けられた AWS アカウント ID を使用します。アカウント ID を使用する場合は、ID にハイフン ('-') を含めないでください。
### リクエストパラメーター
このオペレーションはリクエストパラメータを使用しません。
### リクエストヘッダー
このオペレーションは、すべてのオペレーションに共通のリクエストヘッダーのみを使用します。共通のリクエストヘッダーの詳細については、「[一般的なリクエストヘッダー](api-common-request-headers.md)」を参照してください。
### リクエスト本文
この操作にリクエストボディはありません。
## レスポンス
これに対して、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"
}
```
### レスポンスヘッダー
この操作はほとんどのレスポンスに共通のレスポンスヘッダーのみを使用します。共通のレスポンスヘッダーの詳細については、「[共通のレスポンスヘッダー](api-common-response-headers.md)」を参照してください。
### レスポンス本文
レスポンス本文には次の JSON フィールドが含まれています。
**Policy**
JSON 文字列としてのボールトロックポリシー（エスケープ文字として "\$1" を使用）。
タイプ: 文字列
**状態**
ボールトロックの状態。
型: 文字列
有効な値:`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 の例外とエラーメッセージについては、「[エラーレスポンス](api-error-responses.md)」を参照してください。
## 例
次の例は、ボールトロックポリシーの取得方法を示しています。
### リクエストの例
この例では、ボールトの `GET` サブリソースの URI に `lock-policy` リクエストを送信します。
```
1. GET /-/vaults/examplevault/lock-policy HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. 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)](api-InitiateVaultLock.md)」のリクエストの例に示すようにエスケープ文字として "\$1" を使用します。ただし、次の例では読みやすくするため、エスケープ文字を使用せずに、返される JSON 文字列を示します。
```
1. HTTP/1.1 200 OK
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:00:00 GMT
4. Content-Type: application/json
5. Content-Length: length
6.
7. {
8. "Policy": "
9. {
10. "Version": "2012-10-17",
11. "Statement": [
12. {
13. "Sid": "Define-vault-lock",
14. "Principal": {
15. "AWS": "arn:aws:iam::999999999999:root"
16. },
17. "Effect": "Deny",
18. "Action": "glacier:DeleteArchive",
19. "Resource": [
20. "arn:aws:glacier:us-west-2:999999999999:vaults/examplevault"
21. ],
22. "Condition": {
23. "NumericLessThanEquals": {
24. "glacier:ArchiveAgeInDays": "365"
25. }
26. }
27. }
28. ]
29. }
30. ",
31. "State": "InProgress",
32. "ExpirationDate": "exampledate",
33. "CreationDate": "exampledate"
34. }
```
## 関連するセクション
+ [ボールトロックの中止 (ロックポリシーの DELETE)](api-AbortVaultLock.md)
+ [ボールトロックの完了 (ロック ID の POST)](api-CompleteVaultLock.md)
+ [ボールトロックの開始 (ロックポリシーの POST)](api-InitiateVaultLock.md)
## 以下の資料も参照してください。
言語固有の Amazon SDK のいずれかでこの API を使用する方法の詳細については、次を参照してください。
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/get-vault-lock.html)