在 Amazon Glacier 中处理档案 - Amazon Glacier
归档操作维护客户端档案元数据

此页面仅适用于使用 Vaults 和 2012 年原始 REST API 的 Amazon Glacier 服务的现有客户。

如果您正在寻找档案存储解决方案，我们建议您在亚马逊 S3、S3 Glacier 即时检索、S3 Glacier 灵活检索和 S3 Glacier Deep Archive Deep Archive 中使用 Amazon Glacier 存储类。要了解有关这些存储选项的更多信息，请参阅 Amazon Glacier 存储类别。

从 2025 年 12 月 15 日起，Amazon Glacier（最初基于保管库的独立服务）将不再接受新客户，对现有客户不产生任何影响。Amazon Glacier 是一项独立的服务 APIs ，拥有自己的服务，可将数据存储在文件库中，不同于亚马逊 S3 和 Amazon S3 Glacier 存储类别。在 Amazon Glacier 中，您的现有数据将保持安全且可以无限期地访问。无需迁移。对于低成本、长期的存档存储， AWS 建议使用 Amazon S3 Glacier 存储类别，这些存储类别基于S3存储桶 APIs、完全 AWS 区域 可用性、更低的成本和 AWS 服务集成，可提供卓越的客户体验。如果您想要增强功能，可以考虑使用我们的AWS 解决方案指南迁移到 Amazon S3 Glacier 存储类别，将数据从 Amazon Glacier 文件库传输到 Amazon S3 Glacier 存储类。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在 Amazon Glacier 中处理档案

存档是您存储在文件库中的任何对象（例如，照片、视频或文档）。它是亚马逊冰川（Amazon Glacier）的基本存储单元。每个档案都有唯一的 ID 和可选的描述。当您上传档案时，Amazon Glacier 会返回一个包含档案 ID 的响应。此档案 ID 在存储档案的 AWS 区域中是唯一的。以下是示例档案 ID。

TJgHcrOSfAkV6hdPqOATYfp_0ZaxL1pIBOc02iZ0gDPMr2ig-nhwd_PafstsdIf6HSrjHnP-3p6LCJClYytFT_CBhT9CwNxbRaM5MetS3I-GqwxI3Y8QtgbJbhEQPs0mJ3KExample

存档长度 IDs 为 138 字节。在上传档案时，您可以提供可选的描述。您可以使用档案 ID（而不是档案描述）来检索档案。

重要

Amazon Glacier 提供了一个管理控制台。您可以使用该控制台创建或删除文件库。但是，与 Amazon Glacier 的所有其他交互都需要您使用 AWS Command Line Interface (CLI) 或编写代码。例如，要上传照片、视频和其他文档等数据，您必须直接使用 REST API AWS CLI 或使用 Amazon 使用或编写代码来发出请求 SDKs。有关将 Amazon Glacier 与配合使用的更多信息 AWS CLI，请访问亚马逊冰川AWS CLI 参考资料。要安装 AWS CLI，请转至AWS Command Line Interface。

主题

亚马逊 Glacier 中的存档操作

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

在 Amazon Glacier 中上传档案

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

重要

Amazon Glacier 提供了一个管理控制台。您可以使用该控制台创建或删除文件库。但是，与 Amazon Glacier 的所有其他交互都需要您使用 AWS Command Line Interface (CLI) 或编写代码。例如，要上传照片、视频和其他文档等数据，您必须直接使用 REST API AWS CLI 或使用 Amazon 使用或编写代码来发出请求 SDKs。有关将 Amazon Glacier 与配合使用的更多信息 AWS CLI，请访问亚马逊冰川AWS CLI 参考资料。要安装 AWS CLI，请转至AWS Command Line Interface。

在 Amazon Glacier 中查找档案 ID

您可以通过下载包含下载档案的文件库的文件库清单来获取档案 ID。有关下载文件库清单的更多信息，请参阅在 Amazon Glacier 中下载文件库清单。

在 Amazon Glacier 中下载档案

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

删除 Amazon Glacier 中的档案

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

更新 Amazon Glacier 中的档案

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

维护客户端档案元数据

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

注意

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

如果您维护客户端档案元数据，请注意 Amazon Glacier 会维护一份文件库清单，其中包括档案 IDs 以及您在档案上传期间提供的任何描述。有时候，您可能会下载文件库库存，以协调您为档案元数据维护的客户端数据库中存在的任何问题。但是，Amazon Glacier 大约每天都会对文件库进行库存。在您请求文件库清单时，Amazon Glacier 会返回它准备的上一份清单（时间点快照）。