对象存储BOS

    InitiateMultipartUpload

    接口描述

    InitiateMultipartUpload是MultipartUpload的第一步,此命令向BOS请求一个全局唯一的UploadId,用于表示此次MultipartUpload,在MultipartUpload后续两个步骤都需要此UploadId,请求者也可以通过UploadId来查询上传的进度或者中断这次上传操作。

    请求(Request)

    • 请求语法

      POST /<ObjectName>?uploads HTTP/1.1
      Host: <BucketName>.bj.bcebos.com
      Date: <Date>
      Authorization: <AuthorizationString>
      Content-Type: text/plain
      Content-Length: <ContentLength>
      x-bce-storage-class: <StorageClass>
    • 请求头域

      名称 类型 描述 是否必需
      x-bce-storage-class String 指定BOS的对象的存储类型,目前支持STANDARDSTANDARD_IACOLDARCHIVE 否,默认为STANDARD
      x-bce-acl String CannedACL支持的header,用户设置Object的权限,取值为private或public-read。
      x-bce-grant-read String CannedACL支持的header,用户设置Object的读权限。支持多个id,以逗号分隔
      x-bce-grant-full-control String CannedACL支持的header,用户设置Object的FULL_CONTROL权限。支持多个id,以逗号分隔
      x-bce-server-side-encryption String 服务端加密算法,当前仅支持AES256。
      Cache-Control String 下载Object的Cache设置,常见的可取值为privateno-cachemax-agemust-revalidate
      Content-Disposition String 设置浏览器是否下载,可取值为inlineattachment; filename="download.txt"
      Expires String 设置下载Object时的缓存失效时间
    • 请求参数

      名称 类型 参数位置 描述 是否必需
      uploads String Query参数 分块上传的请求

    响应(Response)

    • 响应头域

    • 响应元素

      名称 类型 描述
      bucket String Bucket名称
      key String Object名称
      uploadId String 全局唯一ID,用于标识此次MultiUpload操作

      注意事项

      1. 使用MultipartUpload上传的Object,必须在第一步InitMultipartUpload时指定Content-Type,如不指定,默认为application/octet-stream
      2. InitiateMultipartUpload获取的UploadId将用于MultiUpload的后续2步操作,也可以用此UploadId来查询整个MultiUpload的进度和中断此次MultiUpload操作。

    示例

    • 标准存储的请求示例

      POST /ObjectName?uploads
      Host: BucketName.bj.bcebos.com
      Date: Wed, 06 Apr 2016 06:34:40 GMT
      Authorization: AuthorizationString
      Content-Length: 0
    • 低频/冷存储的请求示例

      POST /ObjectName?uploads
      Host: BucketName.bj.bcebos.com
      Date: Wed, 06 Apr 2016 06:34:40 GMT
      Authorization: AuthorizationString
      Content-Length: 0
      x-bce-storage-class: STANDARD_IA
    • 响应示例

      HTTP/1.1 200 OK
      x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
      Date:  Wed, 06 Apr 2016 06:34:40 GMT
      Content-Length: 197
      Connection: keep-alive
      Server: BceBos
      
      {
          "bucket": "BucketName",
          "key":"ObjectName",
          "uploadId": "a44cc9bab11cbd156984767aad637851"
      }
    上一篇
    使用指南
    下一篇
    UploadPart