此页面仅适用于使用 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 中，您的现有数据将保持安全且可以无限期地访问。无需迁移。对于低成本、长期的存档存储， Amazon 建议使用 Amazon S3 Glacier 存储类别，这些存储类别
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
分段上传大型档案（分段上传）
主题
分段上传流程
如中所述在 Amazon Glacier 中上传档案，我们鼓励亚马逊 Glacier（Amazon Glacier）客户使用分段上传来上传大于 100 兆字节 (MiB) 的档案。
-
开始分段上传
当您发送启动分段上传的请求时，Amazon Glacier 会返回一个分段上传 ID，这是您的分段上传的唯一标识符。后续的任何分段上传操作均需要此 ID。此身份证在 Amazon Glacier 完成任务后至少 24 小时内不会过期。
在您启动分段上传的请求中，请指定段大小（以字节数为单位）。除了最后一段以外，您上传的每一段都必须为此大小。
注意
使用分段上传时，您不需要知道整个档案大小。这意味着，在开始上传档案时，您可以在不知道档案大小的情况下使用分段上传。您只需在启动分段上传时决定段大小即可。
此外，在启动分段上传请求中，您还可以提供可选的档案描述。
-
上传段
对于每个段上传请求，您必须包括您在步骤 1 中获取的分段上传 ID。此外，在请求中，您还必须指定标识段在最终档案中的位置的内容范围（以字节为单位）。Amazon Glacier 稍后使用内容范围信息按正确的顺序组装档案。由于您提供了上传的每一段的内容范围，因此，它会确定段在最终档案汇编中的位置，进而，您可以任何顺序上传段。此外，您还可以并行上传段。如果您使用与之前上传的段相同的内容范围上传新段，则之前上传的段会被覆盖。
-
完成（或停止）分段上传
上传所有档案段后，您可以使用完成操作。此外，您还必须在请求中指定上传 ID。Amazon Glacier 会根据您提供的内容范围按升序连接各个部分，从而创建档案。Amazon Glacier 对完成分段上传请求的响应包括新创建的档案的档案 ID。如果您在启动分段上传请求中提供了可选的档案描述，Amazon Glacier 会将其与组装好的档案关联起来。成功完成分段上传后，您无法引用该分段上传 ID。这意味着，您无法访问与该分段上传 ID 相关联的段。
如果停止分段上传，则您无法使用该分段上传 ID 上传其他任何段。与停止的分段上传相关联的任何段所占用的所有存储都会被释放。如果有任何分段上传正在进行，则即使在您停止后，它们仍然可能会成功或失败。
附加分段上传操作
Amazon Glacier（亚马逊 Glacier）提供了以下额外的分段上传 API 调用。
-
列出段—利用此操作，您可以列出特定分段上传的段。它会返回有关您为分段上传上传的段的信息。对于每个列出部件请求，Amazon Glacier 会返回最多 1,000 个零件的信息。如果有更多段要为分段上传列出，则结果会分页，并且响应中会返回一个指示要从其所在位置继续列表的标记。您需要发送附加请求来检索后续的段。请注意，返回的段列表不包括未完成上传的段。
-
列出分段上传—利用此操作，您可以获取正在进行的分段上传的列表。正在进行的分段上传是已开始但还未完成或停止的上传。对于每个列出分段上传请求，Amazon Glacier 最多会返回 1000 个分段上传。如果有更多分段上传要列出，则结果会分页，并且响应中会返回一个指示要从其所在位置继续列表的标记。您需要发送附加请求来检索剩余的分段上传。
快讯
下表提供了分段上传的核心规范。
| Item | 规格 |
|---|---|
| 最大档案大小 | 10,000 x 4 吉字节 (GiB) |
| 每次上传的分段的最大数量 | 10000 |
| 分段大小 | 1 MiB 到 4 GiB，最后一个分段可以小于 1 MiB。您可以指定大小值（以字节为单位）。 分段大小必须为兆字节 （1024 KiB）乘以 2 的幂，例如， |
| 列出分段请求返回的分段的最大数量 | 1000 |
| 在列出分段上传请求中返回的分段的最大数量 | 1000 |