有奖捉虫:云通信与企业服务文档专题,速来> HOT
简单上传指用户使用 PUT Object 接口上传对象。简单上传方式适用于在单个请求中,上传不超过 5GB 的单个对象。
如需上传大于 5GB 的单个对象,可使用以下方式:
使用控制台上传:控制台可支持上传最大512GB 的单个对象,详情请参见 上传对象 控制台指南文档。
使用 API/SDK 的分块上传:可支持上传最大48.82TB(即50000GB)的单个对象,请参见 分块上传
使用 COSCMD 工具支持上传最大 40TB 的单个对象,详情请参见 COSCMD 工具
说明
在发起上传请求时,如需上传到指定的文件夹或路径,可通过 / 实现,例如将 picture.png 上传到 doc 文件夹,则对象键设置为 doc/picture.png。

适用场景

简单上传方式适用于上传不超过 5GB 对象的场景。
在高宽带或弱网络环境中,若您要上传的对象较大,例如超过100MB(即便小于5GB),我们建议您优先使用 分块上传 的方式。因为分块上传可以并行传输多个分块。在高宽带环境中,可以有效利用资源;在弱网络环境中,单一分块上传失败不会影响其他已上传的分块,通过简单的重试即可重传失败分块,从而提高整体的上传成功率。有关移动端在弱网络环境的上传,可参见 弱网分块续传实践

使用方法

使用 REST API

您可以直接使用 REST API 发起简单上传对象请求,详情请参见 PUT Object API 文档。

使用 SDK

您可以直接调用 SDK 的简单上传对象方法,详情请参见下列各语言 SDK 文档: