分段上传大型档案(分段上传) - Amazon S3 Glacier
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

分段上传大型档案(分段上传)

分段上传流程

如中所述在 Amazon S3 Glacier 中上传档案,我们鼓励 Amazon S3 Glacier (S3 Glacier) 客户使用分段上传来上传大于 100MB 的档案。

  1. 开始分段上传

    当您发送请求以开始分段上传时,S3 Glacier 返回分段上传 ID,它是分段上传的唯一标识符。后续的任何分段上传操作均需要此 ID。S3 Glacier 完成任务后,此 ID 至少在 24 小时内都不会过期。

    在您启动分段上传的请求中,请指定段大小(以字节数为单位)。除了最后一段以外,您上传的每一段都必须为此大小。

    注意

    使用分段上传时,您不需要知道整个档案大小。这意味着,在开始上传档案时,您可以在不知道档案大小的情况下使用分段上传。您只需在启动分段上传时决定段大小即可。

    此外,在启动分段上传请求中,您还可以提供可选的档案描述。

  2. 上传段

    对于每个段上传请求,您必须包括您在步骤 1 中获取的分段上传 ID。在请求中,您还必须指定标识段在最终档案中的位置的内容范围(以字节为单位)。S3 Glacier 稍后使用内容范围信息按正确顺序汇编归档文件。由于您提供了上传的每一段的内容范围,因此,它会确定段在最终档案汇编中的位置,进而,您可以任何顺序上传段。此外,您还可以并行上传段。如果您使用与之前上传的段相同的内容范围上传新段,则之前上传的段会被覆盖。

  3. 完成(或停止)分段上传

    上传所有档案段后,您可以使用完成操作。同样,您必须在请求中指定上传 ID。S3 Glacier 会根据您提供的内容范围以升序顺序将各个段连接起来,从而创建档案。S3 Glacier 对完成分段上传请求的响应包括新创建档案的档案 ID。如果您在 “启动分段上传” 请求中提供了可选的档案描述,则 S3 Glacier 会将它与拼组的档案相关联。成功完成分段上传后,您无法引用该分段上传 ID。这意味着,您无法访问与该分段上传 ID 相关联的段。

    如果您停止分段上传,则您无法使用该分段上传 ID 上传其他任何段。与停止的分段上传相关联的任何段所占用的所有存储都会被释放。如果有任何分段上传正在进行,则即使在停止后,它们仍然可能会成功或失败。

附加分段上传操作

Amazon S3 Glacier (S3 Glacier) 提供了以下附加分段上传 API 调用。

  • 列出分段-使用此操作,您可以列出特定分段上传的段。它会返回有关您为分段上传上传的段的信息。对于每个 “列出段” 请求,S3 Glacier 最多会返回 1000 段的信息。如果有更多段要为分段上传列出,则结果会分页,并且响应中会返回一个指示要从其所在位置继续列表的标记。您需要发送附加请求来取回后续的段。请注意,返回的段列表不包括未完成上传的段。

  • 列出分段上传-使用此操作,您可以获取正在进行的分段上传的列表。正在进行的分段上传是已开始但还未完成或停止的上传。对于每个列出分段上传请求,S3 Glacier 最多会返回 1000 个分段上传。如果有更多分段上传要列出,则结果会分页,并且响应中会返回一个指示要从其所在位置继续列表的标记。您需要发送附加请求来取回剩余的分段上传。

快讯

下表提供了分段上传的核心规范。

Item 规范
最大档案大小 10 000 x 4 GB
每次上传的分段的最大数量 10000
分段大小

1MB 到 4GB,最后一段可以 < 1MB。您可以指定大小值(以字节为单位)。

段大小必须为 1 兆字节 (1024KB) 乘以 2 的幂。例如,1048576 (1MB)、2097152 (2MB)、4194304 (4MB)、8388608 (8MB)。

列出分段请求返回的分段的最大数量 1000
在列出分段上传请求中返回的分段的最大数量 1000