Glacier
开发人员指南 (API 版本 2012-06-01)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

在 Glacier 中处理档案

档案是您存储在文件库中的任何数据元(例如,照片、视频或文档)。它是 Glacier 中的基本存储单位。每个档案都有唯一的 ID 和可选的描述。您在上传档案时,Glacier 返回包括档案 ID 的响应。此档案 ID 在存储档案的区域是唯一的。以下是示例档案 ID。

TJgHcrOSfAkV6hdPqOATYfp_0ZaxL1pIBOc02iZ0gDPMr2ig-nhwd_PafstsdIf6HSrjHnP-3p6LCJClYytFT_CBhT9CwNxbRaM5MetS3I-GqwxI3Y8QtgbJbhEQPs0mJ3KExample

档案 ID 的长度为 138 字节。在上传档案时,您可以提供可选的描述。您可以使用档案 ID(而不是档案描述)来取回档案。

重要

Glacier 提供了一个管理控制台。您可以使用该控制台创建或删除文件库。但是,与 Glacier 的所有其他交互活动要求您使用 AWS Command Line Interface (CLI) 或编写代码。例如,要上传照片、视频和其他文档等数据,您必须使用 AWS CLI 或编写代码发起请求(可直接利用 REST API 或使用 AWS 开发工具包)。有关通过 AWS CLI 使用 Glacier 的更多详细信息,请访问 Glacier 的 AWS CLI 参考。要安装 AWS CLI,请访问 AWS Command Line Interface

Glacier 中的档案操作

Glacier 支持以下基本档案操作:上传、下载和删除。下载档案是一种异步操作。

在 Glacier 中上传档案

您可以在单一操作中上传档案,也可以分段上传它。用于分段上传档案的 API 调用称为分段上传。 有关更多信息,请参阅 在 Glacier 中上传档案

重要

Glacier 提供了一个管理控制台。您可以使用该控制台创建或删除文件库。但是,与 Glacier 的所有其他交互活动要求您使用 AWS Command Line Interface (CLI) 或编写代码。例如,要上传照片、视频和其他文档等数据,您必须使用 AWS CLI 或编写代码发起请求(可直接利用 REST API 或使用 AWS 开发工具包)。有关通过 AWS CLI 使用 Glacier 的更多详细信息,请访问 Glacier 的 AWS CLI 参考。要安装 AWS CLI,请访问 AWS Command Line Interface

在 Glacier 中下载档案

下载档案是一种异步操作。您必须先启动下载特定档案的任务。收到任务请求后,Glacier 会准备要供下载的档案。任务完成后,您可以下载您的档案数据。由于任务具有异步性,因此,您可以请求 Glacier 在任务完成时向 Amazon Simple Notification Service (Amazon SNS) 主题发送通知。您可以为每个任务请求指定 SNS 主题,或者将您的文件库配置为在特定事件发生时发送通知。有关下载档案的更多信息,请参阅“在 Glacier 中下载档案”。

在 Glacier 中删除档案

Glacier 提供了您可以用来一次删除一个档案的 API 调用。有关更多信息,请参阅 在 Glacier 中删除档案

在 Glacier 中更新档案

上传档案后,您无法更新其内容或描述。可以更新档案内容或其描述的唯一方法是:删除档案,然后上传另一个档案。请注意,在您每次上传档案时,Glacier 都会向您返回一个唯一的档案 ID。

维护客户端档案元数据

除了可选的档案描述以外,Glacier 不支持档案的任何附加元数据。在您上传档案时,Glacier 会分配一个 ID(字符的不透明序列),您无法从其推断有关档案的任何含意。您可能会在客户端维护有关档案的元数据。这些元数据可以包括档案名称以及有关档案的其他一些有意义的信息。

注意

如果您是 Amazon Simple Storage Service (Amazon S3) 客户,则会知道,将数据元上传到存储段时,可以为数据元分配一个数据元密钥,例如 MyDocument.txtSomePhoto.jpg。在 Glacier 中,您无法为您上传的档案分配键名称。

如果您要维护客户端档案元数据,请注意,Glacier 会维护文件库清单,该清单包括档案 ID 以及您在档案上传过程中提供的任何描述。有时候,您可能会下载文件库清单,以协调您为档案元数据维护的客户端数据库中存在的任何问题。但是,Glacier 大约每天都会获取文件库清单。在您请求文件库清单时,Amazon Glacier 会返回它准备的上一份清单(时间点快照)。