接口描述

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的对象的存储类型，目前支持STANDARD、STANDARD_IA、COLD和ARCHIVE，默认为STANDARD；如果是多AZ类型bucket，MAZ_STANDARD_IA代表多AZ低频存储，不指定时默认是MAZ_STANDARD多AZ标准存储类型，不能是其它取值。	否
  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和SM4加密。	否
  Cache-Control	String	下载Object的Cache设置，常见的可取值为private、no-cache、max-age、must-revalidate	否
  Content-Disposition	String	设置浏览器是否下载，可取值为inline、attachment; filename="download.txt"	否
  Expires	String	设置下载Object时的缓存失效时间	否
  x-bce-copy-source	String	设置三步上传的源，bucket/object	否

• 请求参数

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

响应（Response）

• 响应头域

  无

• 响应元素

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

  注意事项

  1. 使用MultipartUpload上传的Object，如不指定Content-Type，BOS会自动识别设置合适的Content-Type，若无法识别则默认为application/octet-stream。
  2. InitiateMultipartUpload获取的UploadId将用于MultiUpload的后续2步操作，也可以用此UploadId来查询整个MultiUpload的进度和中断此次MultiUpload操作。
  3. 获取的UploadId 将用于后续的UploadPartCopy,且copy的源是超过5G的append object，则在init的时候需要设置x-bce-copy-source。copy的源是append object，只能针对超过5G的，如果不足5G不支持。

示例

• 标准存储的请求示例

  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"
  }