186
云计算
负载均衡
产品简介
产品价格
快速入门
用户指南
实践操作
常见问题
购买指南
云服务器
产品简介
计费规则
购买指导
控制台使用指南
常见问题
云数据库
产品简介
计费规则
购买指导
快速入门
连接实例
控制台使用指南
对象存储
产品简介
控制台使用指南
程序员百科
Python
天翼云对象存储(经典版)I型API参考-Complete Multipart Upload

产品推荐:

1、安全稳定的云服务器租用,2核/2G/5M仅37元,点击抢购>>>

2、高防物理服务器20核/16G/50M/500G防御仅350元,点击抢购>>>

3、百度智能建站(五合一网站)仅880元/年,点击抢购>>> 模板建站(PC+手机站)仅480元/年,点击抢购>>>

4、阿里云服务器2核2G3M仅99元/年、2核4G5M仅199元/年,新老同享,点击抢购>>> 

5、腾讯云服务器2核2G4M仅99元/年、新老同享,点击抢购>>>   



点击这里注册天翼云特邀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>
 <Part>
   <PartNumber>1</PartNumber>
   <ETag>"a54357aff0632cce46d942af68356b38"</ETag>
 </Part>
 <Part>
   <PartNumber>2</PartNumber>
   <ETag>"0c78aef83f66abc1fa1e8477f296d394"</ETag>
 </Part>
 <Part>
   <PartNumber>3</PartNumber>
   <ETag>"acbd18db4cc2f85cedef654fccc4a4d8"</ETag>
 </Part>
</CompleteMultipartUpload>

响应示例

 下面的响应中表示一个对象被拼接成功。

HTTP/1.1 200 OK
x-amz-request-id: 656c76696e6727732072657175657374
Date: Mon, 1 Nov 2010 20:34:56 GMT
Server: CTYUN
 
<?xml version="1.0" encoding="UTF-8"?>
<CompleteMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Location>http://example-bucket.oos-cn.ctyunapi.cn/example-Object</Location>
  <Bucket>example-Bucket</Bucket>
  <Key>example-Object</Key>
</CompleteMultipartUploadResult>


这条帮助是否解决了您的问题? 已解决 未解决

提交成功!非常感谢您的反馈,我们会继续努力做到更好! 很抱歉未能解决您的疑问。我们已收到您的反馈意见,同时会及时作出反馈处理!