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

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

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

分段上传流程

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

  1. 开始分段上传

    当您发送请求以开始分段上传时,S3 Glacier 将返回分段上传 ID,此 ID 是分段上传的唯一标识符。后续的任何分段上传操作均需要此 ID。此 ID 在 S3 Glacier 完成任务后的至少 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 最多返回 1,000 个分段上传。如果有更多分段上传要列出,则结果会分页,并且响应中会返回一个指示要从其所在位置继续列表的标记。您需要发送附加请求来取回剩余的分段上传。

快讯

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

Item 规范
最大档案大小 10,000 x 4 吉比字节 (GiB)
每次上传的分段的最大数量 10000
分段大小

1 MiB 到 4 GiB,最后一部分可以小于 1 MiB。您可以指定大小值(以字节为单位)。

分段大小必须是兆字节(1024 kibytes [KiB])乘以 2 的幂数。例如,1048576(1 MiB)、2097152 (2 MiB)、4194304 (4 MiB)、8388608 (8 MiB)。

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