对象存储

  • 对象存储 > API 文档 > Object 接口 > 分片上传 v2 版 > 初始化任务

    初始化任务

    最近更新时间:2020-12-11 16:09:48

    描述

    使用 Multipart Upload 方式上传数据前,必须先调用 API 来获取一个全局唯一的 UploadId ,后续的块数据通过 uploadPart API 上传,整个文件完成 completeMultipartUpload API ,已经上传块的删除 abortMultipartUpload API 都依赖该 UploadId 。


    请求



    语法

    POST /buckets/<BucketName>/objects/<EncodedObjectName>/uploads HTTP/1.1
    Host: <UpHost>
    Authorization: UpToken <UploadToken>
    

    使用说明:

    • 初始化 Multipart Upload 请求,并不会影响已存在的同名 Object 。
    • 同一个 Object 可以同时拥有不同的 UploadId 。


    请求参数

    参数名称 必填 说明
    BucketName 空间名称
    EncodedObjectName 资源名,EncodedObjectName 需要经过 Base64 编码,如果表示不设置可以使用特殊字符 ~ 。具体可以参照:URL 安全的 Base64 编码


    请求头

    头部名称 必填 说明
    Host 上传服务器域名。
  • 上传到华东区的域名为 up.qiniup.comup-z0.qiniup.comupload.qiniup.com
  • 上传到华北区的域名为 up-z1.qiniup.comupload-z1.qiniup.com
  • 上传到华南区的域名为 up-z2.qiniup.comupload-z2.qiniup.com
  • 上传到北美区的域名为 up-na0.qiniup.comupload-na0.qiniup.com
  • 上传到东南亚区的域名为 up-as0.qiniup.comupload-as0.qiniup.com
  • Authorization 该参数应严格按照上传凭证格式进行填充,否则会返回 401 错误码。一个合法的 Authorization 值应类似于 Authorization: UpToken QNJi_bYJlmO5LeY08FfoNj9w_r...


    请求元素

    该请求操作的请求体为空。


    响应


    响应头

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


    响应元素

    名称 类型 说明
    uploadId string 初始化文件生成的 id
    expireAt int64 UploadId 的过期时间 Unix 时间戳,过期之后 UploadId 不可用,固定 7 天有效期


    特殊错误

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


    示例



    请求示例

    POST /buckets/myBucket/objects/myObject/uploads HTTP/1.1
    Host: up.qiniup.com
    User-Agent: Go-http-client/1.1
    Authorization: UpToken j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:nP7NSSyGo4x3W_nJ8T9X1gJrgpk=
    


    响应示例

    HTTP/1.1 200 OK
    Content-Length: 2
    Connection: keep-alive
    Content-Type: application/json
    Date: Wed, 18 Dec 2019 17:02:11 GMT
    Server: nginx
    X-Reqid: SFkAAAC8BDebTtsU
    
    {
         "uploadId": "5df9ea14834c512b2270234e",
         "expireAt": 1576659776
    }
    
    以上内容是否对您有帮助?
  • Qvm free helper
    Close