更新时间: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 表格格式:
| 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