开发者指南

API 文档

SDK 文档

分块上传

最近更新时间:2020-07-20 09:53:38

简介

分块上传可以实现将整个对象切分为多个分块,然后再将这些分块上传到 COS。上传时,这些分块将会按连续的序号编号,您可以独立上传或者按照任意顺序上传各个分块,最终 COS 将会根据分块编号顺序重新组合出该对象。任意分块传输失败,都可以重新传输当前分块,不会影响其他分块和内容完整性。一般在弱网络环境中,单个对象大于20MB可优先考虑分块上传,在大带宽环境中可将超过100MB的对象进行分块上传。

分块上传最多支持将较大的对象切分为10000个分块,切分的分块大小范围一般为1MB - 5GB,最后一个分块可以小于1MB。

说明:

简单上传的方式只支持最大5GB的文件上传,而通过分块上传的方式可上传大于5GB的文件。

适用场景

分块上传适合于在弱网络或高带宽环境下上传较大的对象。

分块上传优势如下:

  • 在弱网络环境中,使用较小的分块可以将网络失败导致的中断影响降低,实现对象续传。
  • 在高带宽环境中,并发上传对象分块能充分利用网络带宽,乱序上传并不影响最终组合对象。
  • 使用分块上传,您可以随时暂停和恢复单个大对象的上传。除非发起终止操作,所有未完成的对象将可随时继续上传。
  • 分块上传也适用于在未知对象总大小的情况下上传对象,您可以先发起上传,再组合对象以获得完整大小。

使用方法

使用 REST API

您可以直接使用 REST API 发起分块上传请求,详情请参见以下 API 文档:

使用 SDK

您可以直接调用 SDK 的分块操作方法,详情请参见下列各语言 SDK 文档: