对象存储 > API 文档 > Object 接口 > 分片上传 v1 版 > 上传片

上传片

最近更新时间: 2024-06-04 19:05:28

描述

上传指定块的一片数据，具体数据量可根据现场环境调整。同一块的每片数据必须串行上传。

请求

请求语法

POST /bput/<ctx>/<nextChunkOffset> HTTP/1.1
Host:           <UpHost>
Content-Type:   application/octet-stream
Content-Length: <nextChunkSize>
Authorization:  UpToken <UploadToken>

<nextChunkBinary>

使用说明：

可以复用创建块时使用的上传凭证。
上传凭证将被重新验证，若已过期，可以使用重新生成的凭证。

请求参数

参数名称	必填	类型	说明
ctx	是	string	前一次上传返回的块级上传控制信息。
nextChunkOffset	是	int64	当前片在整个块中的起始偏移。

请求头

头部名称	必填	说明
Host	是	上传域名。七牛对象存储支持的区域和对应区域上传域名列表见存储区域列表后续片的上传为上一次上传响应返回的后续上传接收地址
Content-Type	是	固定为`application/octet-stream`。
Content-Length	是	当前片的内容长度，单位为字节。
Authorization	是	该参数应严格按照上传凭证格式进行填充，否则会返回 401 错误码。一个合法的 Authorization 值应类似于`Authorization: UpToken QNJi_bYJlmO5LeY08FfoNj9w_r...`。

请求内容

参数名称	必填	说明
nextChunkBinary	是	当前片的二进制内容

响应

响应头

该请求操作的实现使用了所有操作的公共响应头。有关详细信息，请查阅公共响应头。

响应内容

名称	说明
ctx	本次上传成功后的块级上传控制信息，用于后续上传片(bput)及创建文件(mkfile)。本字段是只能被七牛服务器解读使用的不透明字段，上传端不应修改其内容。每次返回的 ctx 都只对应紧随其后的下一个上传数据片，上传非对应数据片会返回 701 状态码。例如`"ctx":"U1nAe4qJVwz4dYNslBCNNg...E5SEJJQQ=="`。
checksum	上传块校验码。例如`"checksum":"wQ-csvpBHkZrhihcytio7HXizco="`。
crc32	上传块 crc32，客户可通过此字段对上传块的完整性进行校验。例如`"crc32":659036110`。
offset	下一个上传片在上传块中的偏移。例如`"offset":4194304`。
host	后续上传接收地址。例如`"host":"http://upload.qiniup.com"`。
expired_at	ctx 过期时间，ctx 过期后会删除未完成创建文件的块数据。例如`"expired_at":1514446175`。

响应状态码

该操作的实现不会返回特殊错误。有关错误和错误代码列表的一般信息，请查阅错误响应。

以上内容是否对您有帮助？