下载文件

更新时间:2025-08-18 15:32:05

该接口提供从对象存储平台下载指定资源文件的能力,支持标准HTTP文件下载协议,满足各类资源分发场景需求。

请求描述

基础请求格式
文件下载使用标准的HTTP GET规范。详细信息请参见RFC2616标准

 http://< domain>/< key>?< param1>=< value1>&< param2>=< value2>...

分片下载请求格式
在下载过程中,可以使用标准HTTP Range请求头支持分段下载和断点续传。

 Range: bytes=< first-byte>-< last-byte>

下面是将你提供的内容改写为易于阅读的 Markdown 表格格式:

  • 假设文件的字节长度为1000,不同的range会有不同的响应方式
Range 范围 响应内容说明 响应状态码
Range: bytes=0-888 响应 0-888 共 889 字节的内容 206
Range: bytes=666-888 响应 666-888 共 223 字节的内容 206
Range: bytes=-888 响应最后 888 字节的内容 206
Range: bytes=-1888 (结束字节超出文件大小) 响应完整文件,共 1000 字节的内容 206
Range: bytes=666- 响应从第 666 字节开始到文件结尾,共 334 字节 206
Range: bytes=1-1888 (结束字节超出文件大小) 响应从第 1 字节开始到文件结尾的内容 206
Range: bytes=1666-1888 (开始字节超出文件大小) 416 Requested range not satisfiable
Range: bytes=888-666 (开始字节大于结束字节) 416 Requested range not satisfiable
Range: bytes=-a888- (range格式不合法) 416 Requested range not satisfiable

响应描述

标准下载响应
下载请求的响应应符合HTTP GET请求规范。详细信息请参见RFC2616标准

追加上传对象特殊头
对于追加上传的对象,在响应中会添加以下两个头:

x-wcs-object-type: Appendable
x-next-append-position: <Content-Length int64>

上述两个头用于标识对象的类型和下一个追加的位置。

示例

 curl -v -o 1.png http://downloadDomain/1.png
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!