对象存储

  • 上传片

    最近更新时间:2017-12-22 18:04:19

    描述

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


    请求


    语法

    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 上传服务器域名。
  • 上传到华东区的域名为up.qiniu.comup-z0.qiniu.comupload.qiniu.com
  • 上传到华北区的域名为up-z1.qiniu.comupload-z1.qiniu.com
  • 后续片的上传为上一次上传响应返回的后续上传接收地址
  • 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.qiniu.com"
    expired_at ctx 过期时间。例如"expired_at":1514446175


    特殊错误

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

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