**此页面仅适用于使用文件库和 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 是一项独立的服务 APIs ，拥有自己的服务，可将数据存储在文件库中，不同于亚马逊 S3 和 Amazon S3 Glacier 存储类别。在 Amazon Glacier 中，您现有的数据将确保安全，并且可以无限期地访问。无需进行迁移。对于低成本、长期的存档存储， AWS 建议[使用 Amazon S3 Glacier 存储类别，这些存储类别](https://aws.amazon.com/s3/storage-classes/glacier/)基于S3存储桶 APIs、完全 AWS 区域 可用性、更低的成本和 AWS 服务集成，可提供卓越的客户体验。如果您希望加强功能，可以考虑使用我们的 [AWS 将数据从 Amazon Glacier 文件库传输到 Amazon S3 Glacier 存储类别的解决方案指南](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)，迁移到 Amazon S3 Glacier 存储类别。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 获取文件库锁定（GET lock-policy）
## 说明
此操作会从指定文件库上设置的 `lock-policy` 子资源中检索以下属性：
+ 在文件库上设置的文件库锁定策略。
+ 文件库锁定的状态（`InProgess` 或 `Locked`）。
+ 当锁定 ID 到期时。锁定 ID 用于完成文件库锁定过程。
+ 当文件库锁定启动并进入 `InProgress` 状态时。
通过调用`InProgress`，可将文件库锁定置于 [启动文件库锁定（POST lock-policy）](api-InitiateVaultLock.md) 状态。通过调用`Locked`，可将文件库锁定置于 [完成文件库锁定（POST lockId）](api-CompleteVaultLock.md) 状态。您可通过调用[中止文件库锁定（DELETE lock-policy）](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（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”作为转义符）。
类型：字符串
**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 异常和错误消息的信息，请参阅[错误响应](api-error-responses.md)。
## 示例
以下示例演示如何获取文件库锁定策略。
### 请求示例
在此示例中，`GET` 请求会发送到文件库的 `lock-policy` 子资源的 URI。
```
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 字符串使用“\$1”作为转义符，如[启动文件库锁定（POST lock-policy）](api-InitiateVaultLock.md)请求示例中所示。但为了便于阅读，以下示例显示了不带转义符的返回的 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 lock-policy）](api-AbortVaultLock.md)
+ [完成文件库锁定（POST lockId）](api-CompleteVaultLock.md)
+ [启动文件库锁定（POST lock-policy）](api-InitiateVaultLock.md)
## 另请参阅
有关在特定语言的 Amazon 中使用此 API 的更多信息 SDKs，请参阅以下内容：
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/get-vault-lock.html)