简单上传

最后更新时间:2021-07-12 15:47:47

    简单上传指用户使用 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 文档: