对象存储

    • 对象存储 > 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。

    响应状态码

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

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