

喜讯:国内、香港、海外云服务器租用特惠活动,2核/4G/10M仅需31元每月,点击抢购>>>
点击这里注册天翼云特邀VIP帐号,立即体验天翼云对象存储>>>
天翼云对象存储(经典版)I型API参考-Complete Multipart Upload
接口通过合并之前的上传片段来完成一次分片上传过程。
用户首先初始化分片上传过程,然后通过Upload Part接口上传所有分片。在成功将一次分片上传过程的所有相关片段上传之后,调用这个接口来结束分片上传过程。当收到这个请求的时候,OOS会以分片号升序排列的方式将所有片段依次拼接来创建一个新的对象。在这个Complete Multipart Upload请求中,用户需要提供一个片段列表。同时,必须确保这个片段列表中的所有片段必须是已经上传完成的,Complete Multipart Upload操作会将片段列表中提供的片段拼接起来。对片段列表中的每个片段,需要提供该片段上传完成时返回的ETag头的值和对应的分片号。
OOS提供了不合并片段也可以读取Object内容的功能。在没有调用Complete Multipart Upload接口合并片段时,也可以通过调用Get Object接口来获取文件内容,OOS会根据最近一次创建的uploadId,以分片号升序的方式顺序读取片段内容,返回给客户端。
请求语法
POST /ObjectName?uploadId=UploadId HTTP/1.1 Host: BucketName.oos-cn.ctyunapi.cn Date: Date Content-Length: Size Authorization: Signature
<CompleteMultipartUpload> <Part> <PartNumber>PartNumber</PartNumber> <ETag>ETag</ETag> </Part> ... </CompleteMultipartUpload> |
请求参数
名称 | 描述 | 是否必须 |
CompleteMultipartUpload | 请求的容器。 类型:容器。 子节点:1个或多个Part元素。 | 是 |
Part | 一个片段的容器。 类型:容器。 父节点:CompleteMultipartUpload。 子节点:PartNumber, Etag。 | 是 |
PartNumber | 标识片段的分片号。 类型:Integer。 父节点:Part。 | 是 |
ETag | 片段上传完成时返回的Etag内容。 类型:字符串。 父节点:Part。 | 是 |
响应结果
名称 | 描述 |
CompleteMultipartUploadResult | 包含整个响应的容器。 类型:容器 子节点:Location, Bucket, Key, ETag |
Location | 新创建对象的URI地址。 类型:URI 父节点:CompleteMultipartUploadResult |
Bucket | 分片上传对应的对象容器。 类型:字符串 父节点:CompleteMultipartUploadResult |
Key | 新创建的对象的Key。 类型:字符串 父节点:CompleteMultipartUploadResult |
ETag | ETag用来标识新创建的对象数据。 类型:字符串 父节点:CompleteMultipartUploadResult |
出错响应
HTTP状态码 | 响应代码 | 描述 |
400 Bad Request | InvalidPart | 一个或者多个指定片段无法找到,片段可能没有被上传,或者指定的ETag值跟片段的ETag值不匹配 |
400 Bad Request | InvalidPartOrder | 片段列表不以升序排列,片段列表必须根据分片号按顺序排列 |
404 Not Found | NoSuchUpload | 指定的分片上传过程不存在,上传ID可能非法,分片上传过程可能被终止或者已经完成 |
400 Bad Request | InvalidPartSize
| 如果小于5M的分片为2片或者2片以上,会终止合并分片上传。 |
请求示例
下面的分片上传请求在CompleteMultipartUpload元素中指定了三个片段。
POST /example-object?uploadId=638428231343369399 HTTP/1.1
Host: example-bucket.oos-cn.ctyunapi.cn
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 391
Authorization: AWS 7799e793ce4624ee7e5a:xQE0diMbLRepdf3YB+FIEXAMPLE=
<CompleteMultipartUpload>
推荐:TOP云智能建站优惠活动,仅880元即可搭建一个后台管理五端合一的智能网站(PC网站、手机网站、百度智能小程序、微信小程序、支付宝小程序),独享百度搜索SEO优势资源,让你的网站不仅有颜值有排面,更有排名,可以实实在在为您带来效益,请点击进入TOP云智能建站>>>,或咨询在线客服了解详情。![]()



湘公网安备43019002001857号
备案号:
客服1