对象存储

  • 创建块

    最近更新时间:2018-11-21 18:49:02

    描述

    本接口用于为后续分片上传创建一个新的块,同时上传第一片数据。


    请求



    语法

    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.comup-z0.qiniup.comupload.qiniup.com
  • 上传到华北区的域名为up-z1.qiniup.comupload-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


    特殊错误

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


    示例


    请求示例

    POST /mkblk/4194304 HTTP/1.1
    User-Agent: curl/7.30.0
    Host: upload.qiniup.com
    Accept: */*
    Authorization: UpToken QNJi_bYJlmO5LeY08FfoNj9w_r...(过长已省略)
    
    <firstChunkBinary>
    


    响应示例

    HTTP/1.1 200 OK
    Server: nginx
    Date: Thu, 21 Dec 2017 07:29:35 GMT
    Content-Type: application/json
    Connection: keep-alive
    Cache-Control: no-store
    Content-Length: 340
    X-Log: qtbl.get;RS
    X-Reqid: swEAAMipp-5bIjMT
    
    {
      ctx: "U1nAe4qJVwz4dYNslBCNNgE...PMXE5SEJJQQ==", 
      checksum: "wQ-csvpBHkZrhihcytio7HXizco=", 
      crc32: 659036110, 
      offset: 4194304, 
      host: "http://upload.qiniup.com", 
      expired_at: 1514446175
    }
    
    以上内容是否对您有帮助?
  • Icon free helper
    Close