对象存储

  • 对象存储 > 使用指南 > 开发指南 > 上传资源

    上传资源

    最近更新时间: 2021-02-24 17:41:27


    注意:

    • 上传文件的名称中,不支持\0字符。
    • 若文件名中存在\0字符,则会返回 400 Bad Request 和 error message “key must not contain null byte”。
    • 上传文件名 utf-8 编码字符,长度不超过 750 字节 。
    • 若有特殊需求,请联系技术支持。

    表单上传

    表单上传是指在一个单一的 HTTP POST 请求中完成一个文件的上传,比较适合简单的应用场景和尺寸较小的文件。

    表单上传的使用细节请参考表单上传

    分片上传

    分片上传是将一个文件分为多个小数据块,每个小数据块以一个独立的 HTTP 请求分别上传。所有小数据块都上传完成后,再发送一个请求给服务端将这些小数据块组织成一个逻辑资源,以完成上传过程。

    相比表单上传,分片上传的优势:

    • 适合尺寸较大的文件传输,通过分片来避免单个 HTTP 数据量过大而导致连接超时的现象。
    • 在网络条件较差的环境下,较小尺寸的文件可以有较高的上传成功率,从而避免无休止的失败重试。
    • 支持断点续传。

    然而,相比表单上传,分片上传需要多次 HTTP 请求才能完成上传过程,会有额外的成本开销。另外也增加了代码的复杂度,因此选择是否使用分片上传时应谨慎评估使用的必要性。

    分片上传的使用细节请参考分片上传 v1 版分片上传 v2 版,两种分片上传不同见详情。

    上传后续动作

    在上传时开发者可以指定上传完成后服务端的后续动作,例如回调通知(callback)、自定义响应内容、303重定向等。可设置的后续动作与表单上传中完全一致。

    这里需要明确的是,虽然后续动作在生成上传凭证时已经指定,但这些后续动作只在服务端处理完创建文件(mkfile)请求后才会发生,而且也只有mkfile请求的内容可以包含变量

    在线示例

    在线断点继上传示例

    以上内容是否对您有帮助?
  • Qvm free helper
    Close