![]()
描述
本接口用于为后续分片上传创建一个新的块，同时上传第一片数据。
![]()
请求
POST /mkblk/<blockSize> HTTP/1.1
Host: <UpHost>
Content-Type: application/octet-stream
Content-Length: <firstChunkSize>
Authorization: UpToken <UploadToken>
<firstChunkBinary>
| 参数名称 | 必填 | 类型 | 说明 |
|---|
| blockSize | 是 | int64 | 块大小，每块均为 4MB，最后一块大小不超过 4MB。 |
| 头部名称 | 必填 | 说明 |
|---|
| Host | 是 | 上传服务器域名。
上传到华东区的域名为up.qiniup.com、up-z0.qiniup.com和upload.qiniup.com
上传到华北区的域名为up-z1.qiniup.com和upload-z1.qiniup.com
后续片的上传为上一次上传响应返回的后续上传接收地址 |
| Content-Type | 是 | 固定为application/octet-stream。 |
| Content-Length | 是 | 第一个片的内容长度，单位为字节。 |
| Authorization | 是 | 该参数应严格按照上传凭证格式进行填充，否则会返回 401 错误码。一个合法的 Authorization 值应类似于Authorization: UpToken QNJi_bYJlmO5LeY08FfoNj9w_r…。 |
| 参数名称 | 必填 | 说明 |
|---|
| firstChunkBinary | 是 | 第一个片的二进制内容 |
![]()
响应
该请求操作的实现使用了所有操作的公共响应头。
| 名称 | 说明 |
|---|
| ctx | 本次上传成功后的块级上传控制信息，用于后续上传片(bput)及创建文件(mkfile)。本字段是只能被服务器解读使用的不透明字段，上传端不应修改其内容。每次返回的 ctx 都只对应紧随其后的下一个上传数据片，上传非对应数据片会返回 701 状态码。例如”ctx”:”U1nAe4qJVwz4dYNslBCNNg…E5SEJJQQ==”。 |
| checksum | 上传块 sha1，使用URL安全的Base64编码，客户可通过此字段对上传块的完整性进行校验。例如”checksum”:”wQ-csvpBHkZrhihcytio7HXizco=”。 |
| crc32 | 上传块 crc32，客户可通过此字段对上传块的完整性进行校验。例如”crc32”:659036110。 |
| offset | 下一个上传块在切割块中的偏移。例如”offset”:4194304。 |
| host | 后续上传接收地址。例如”host”:”http://upload.qiniup.com"。 |
| expired_at | ctx 过期时间。例如”expired_at”:1514446175。 |
