所有文档

          对象存储 BOS

          CompleteMultipartUpload

          接口描述

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

          请求(Request)

          • 请求语法

            POST /<ObjectName>?uploadId=UploadId HTTP/1.1
            Host: <BucketName>.bj.bcebos.com
            Date: <Date>
            Authorization: <AuthorizationString>
            Content-Length: <ContentLength>
            Content-Type: text/plain	
          • 请求参数

            名称 类型 参数位置 描述 是否必需
            partNumber Int Request Body参数 此part在目的Object中的序号。partNum取值范围 1-10000,一次MultiPart的PartNumber要求必须严格有序,比如有3个Part,PartNumber可以是1,3,5。
            eTag String Request Body参数 Object的HTTP协议实体标签
          • 请求头域

            名称 类型 描述 是否必需
            Content-Length Long Int 头域,JSON数据的长度
            x-bce-meta-* String 用户自定义的meta

          响应(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。

          示例

          • 请求示例

            POST /ObjectName?uploadId=UploadId HTTP/1.1
            Host: BucketName.bj.bcebos.com
            Date: Wed, 06 Apr 2016 06:34:40 GMT
            Authorization: AuthorizationString
            Content-Length: 11434
            Content-Type: text/plain
            
            {
            	"parts":[
            		{
            			"partNumber":1,
            			"eTag":"a54357aff0632cce46d942af68356b38"
            		},
            		{
            			"partNumber":2,
            			"eTag":"0c78aef83f66abc1fa1e8477f296d394"
            		},
            		{
            			"partNumber":3,
            			"eTag":"acbd18db4cc2f85cedef654fccc4a4d8"
            		}
            	]
            }
          • 响应示例

            HTTP/1.1 200 OK
            x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
            Date: Wed, 06 Apr 2016 06:34:40 GMT
            Connection: close
            Server: BceBos
            
            {
            	"location":"http://bj.bcebos.com/BucketName/ObjectName",
            	"bucket":"BucketName",
            	"key":"object",
            	"eTag":"3858f62230ac3c915f300c664312c11f"
            }
          上一篇
          UploadPartCopy
          下一篇
          AbortMultipartUpload