**此页面仅适用于使用文件库和 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 存储类别。本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 购买预配置容量（POST provisioned-capacity）此操作为 AWS 账户购买预置容量单位。预配置容量单位将持续一个月，以购买日期和时间作为开始日期。此单位过期的日期为开始日期的整整一个月之后（精确到秒）。如果开始日期为一个月的第 31 天，过期日期为下个月的最后一天。例如，如果开始日期为 8 月 31 日，则过期日期为 9 月 30 日。如果开始日期为 1 月 31 日，则过期日期为 2 月 28 日。预配置容量帮助确保在您需要时，可以使用针对加速检索的检索容量。每个容量单位可确保每五分钟至少可以执行三次快速检索，并提供高达 150 MB/s 的检索吞吐量。有关预配置容量的更多信息，请参阅[档案检索选项](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options)。 **注意** 每个配置的容量单位限制为两个单位。 AWS 账户 ## 请求要购买的预配置容量单位，请向预配置容量 URI AWS 账户发送 HTTP `POST` 请求。 ### 语法 ``` 1. POST /AccountId/provisioned-capacity HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. Content-Length: Length 6. x-amz-glacier-version: 2012-06-01 ``` **注意** 其`AccountId`值是 AWS 账户 ID。此值必须与用于签署请求的凭据关联的 AWS 账户 ID 相匹配。您可以指定一个 AWS 账户 ID，也可以选择指定一个 '`-`'（连字符），在这种情况下，Amazon Glacier 使用与用于签署请求的凭证关联的 AWS 账户 ID。如果您指定账户 ID，请勿在 ID 中包含任何连字符（-）。 ### 请求参数 #### 请求标头此操作仅使用所有操作通用的请求标头。有关通用请求标头的信息，请参阅[通用请求标头](api-common-request-headers.md)。 #### 请求正文此操作没有请求正文。 ## 响应如果操作请求成功，则该服务会返回 HTTP `201 Created` 响应。 ### 语法 ``` HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date x-amz-capacity-id: CapacityId ``` ### 响应标头除了所有操作通用的响应标头外，成功的响应中还包括以下响应标头。有关通用响应标头的更多信息，请参阅[通用响应标头](api-common-response-headers.md)。 | Name | 说明 | | --- | --- | | `x-amz-capacity-id` | 用于确定预配置容量单位的 ID。类型：字符串 | ### 响应正文此操作不返回响应正文。 ### 错误除了所有 Amazon Glacier 操作中常见的可能错误外，此操作还包括以下一个或多个错误。有关 Amazon Glacier 错误的信息以及错误代码列表，请参阅[错误响应](api-error-responses.md)。 | 代码 | 说明 | HTTP 状态代码 | 类型 | | --- | --- | --- | --- | | LimitExceededException | 如果指定请求将超出账户的预配置容量单位限制，则返回此代码。 | 400 Bad Request | 客户端 | ## 示例以下示例为账户购买预配置容量。 ### 请求示例以下示例发送 HTTP POST 请求以购买预配置容量单位。 ``` 1. POST /123456789012/provisioned-capacity HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 5. Content-Length: length 6. x-amz-glacier-version: 2012-06-01 ``` ### 响应示例如果请求成功，Amazon Glacier（Amazon Glacier）将返回 `HTTP 201 Created` 响应，如以下示例中所示。 ``` 1. HTTP/1.1 201 Created 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:02:00 GMT 4. x-amz-capacity-id: zSaq7NzHFQDANTfQkDen4V7z ``` ## 相关部分 + [列出预配置容量（GET provisioned-capacity）](api-ListProvisionedCapacity.md)