接口描述

当请求者用UploadPart将所有的Part都上传完成后，需要用此CompleteMultipartUpload命令完成整个MultipartUpload操作。此命令需要请求提供有效的Part列表，包含part的PartNumber和eTag。BOS收到此命令后会检查数据，然后把所有的Part组合成一个Object。

请求（Request）

• 请求语法

  Plain Text 复制

  1POST /<ObjectName>?uploadId=UploadId HTTP/1.1
  2Host: <BucketName>.bj.bcebos.com
  3Date: <Date>
  4Authorization: <AuthorizationString>
  5Content-Length: <ContentLength>
  6Content-Type: text/plain	

• 请求头域

  名称	类型	描述	是否必需
  Content-Length	Long Int	头域，JSON数据的长度	是
  x-bce-meta-*	String	用户自定义的meta	否
  x-bce-object-expires	String	设置对象的过期时间，过期后，BOS 将⾃动删除对象。单位为天，⽀持设置为正整数，表示对象将在指定时间过期，从对象的 Last-Modified时间开始计算。例如设置 x-bce-object-expires 参数的值为 3 ，对象的Last-Modified 时间为 2024-09-26 12:00，则该对象将于 2024-09-29 12:00 点过期。在这个时间后， Object 将会被删除。说明:对象过期时间优先级⾼于⽣命周期的删除规则，例如设置对象过期时间为 5 天，⽣命周期规则指定该对象 3 天后删除，最终将按照对象过期时间执⾏，即对象将于 5 天后被删除。	否

• 请求主体

  名称	类型	描述	是否必需
  parts	-	json body根节点	是
  partNumber	Int	此part在目的Object中的序号。partNum取值范围 1-10000，一次MultiPart的PartNumber要求必须严格有序，比如有3个Part，PartNumber可以是1，3，5。	是
  eTag	String	Object的HTTP协议实体标签	是

响应（Response）

• 响应头域

  无特殊头域

• 响应元素

  名称	类型	描述
  bucket	String	此Object所属的Bucket
  eTag	String	Object的HTTP协议实体标签
  key	String	Object名称
  location	String	此Object的url

  注意事项

  1. CompleteMultipartUpload的请求Body最大为1MB。
  2. 一次MultiPart的PartNumber可以是不连续的，比如1, 3, 5。

示例

• 请求示例

  Plain Text 复制

  1POST /ObjectName?uploadId=UploadId HTTP/1.1
  2Host: BucketName.bj.bcebos.com
  3Date: Wed, 06 Apr 2016 06:34:40 GMT
  4Authorization: AuthorizationString
  5Content-Length: 11434
  6Content-Type: text/plain
  7
  8{
  9	"parts":[
  10		{
  11			"partNumber":1,
  12			"eTag":"a54357aff0632cce46d942af68356b38"
  13		},
  14		{
  15			"partNumber":2,
  16			"eTag":"0c78aef83f66abc1fa1e8477f296d394"
  17		},
  18		{
  19			"partNumber":3,
  20			"eTag":"acbd18db4cc2f85cedef654fccc4a4d8"
  21		}
  22	]
  23}

• 响应示例

  Plain Text 复制

  1HTTP/1.1 200 OK
  2x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
  3Date: Wed, 06 Apr 2016 06:34:40 GMT
  4Connection: close
  5Server: BceBos
  6
  7{
  8	"location":"http://bj.bcebos.com/BucketName/ObjectName",
  9	"bucket":"BucketName",
  10	"key":"object",
  11	"eTag":"3858f62230ac3c915f300c664312c11f"
  12}