股票代码: 836286    股票简称: 易云股份
官方微信

扫一扫关注易云捷讯官方微信

备案 |       管理控制台
API 手册
 

合并分片

当段都上传完成,就可以执行合并操作,让各段在服务端合并成一个完整可用Object。合并的Object的Etag生成公式:MD5(M1M2...Mn)-N,Mn为第n段的MD5,N为总的段数。

合并操作若没有使用所有的段,那么合成的Object将会少了一些内容,没有使用的段将会被自动删除。

请求消息

请求格式

POST ?uploadId=uploadID HTTP/1.1

Host: {BucketName}.eos.eayun.com

Date: {Date}

Content-Length: length

Authorization: AWS {access-key}:{hash-of-header-and-secret}

 

<CompleteMultipartUpload>

<Part>

<PartNumber>partNum1</PartNumber>

<ETag>etag1</ETag>

</Part>

...

</CompleteMultipartUpload>

请求消息头

参考公共请求消息头

请求参数

参数名字

描述

是否必选

uploadId

多段上传任务ID

请求消息元素

元素名字

描述

是否必选

CompleteMultipartUpload

part列举的标签

Part

每个段的信息的标签

PartNumber

该段的段号

ETag

该任务的Etag

响应消息

响应格式

HTTP/1.1 status_code

Date: {Date}

Connection: state


<?xml version="1.0" encoding="UTF-8"?>

<CompleteMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

<Location>Bucket.eos.eayun.com</Location>

<Bucket>BucketName</Bucket>

<Key>ObjectName</Key>

<ETag>ETag</ETag>

</CompleteMultipartUploadResult>

响应消息头

请参考公共响应消息头

响应消息元素

元素名字

描述

ListMultipartUploadResult

part列举的标签

Bucket

Object所属的Bucket

Key

Object的名字

UploadId

多段上传任务ID

Initiator

该任务的所属者

Owner

同Initiator

ID

该任务的所属者的ID

DisplayName

该任务的所属者的名字

PartNumberMarker

part的起始段号

NextPartNumberMarker

此次列出操作的最后一个段号,当未列完的时候,可以作为下一次请求中的PartNumberMarker

IsTruncated

表示是否被截断

true表示本次没有返回全部结果

false表示本次已经返回了全部结果

Part

每个段的信息的标签

PartNumber

该段的段号

LastModified

该段的上传时间

ETag

该任务的Etag

Size

该任务的size

错误响应消息

请参考错误响应描述

另外:

• Bucket不存在时,返回404 Not Found,错误码为NoSuchBucket。

• 当多段上传任务不存在时,返回404 Not Found,错误码为NoSuchUpload。

• 当段大小超过5G,则返回错误400 Bad Request。

• 当段序号超过范围[1,10000],则返回错误400 Bad Request。

示例:

合并任务ID为2/WDkVkmtfKYOICFXuvKv_BcC2q4Ps1MX的上传的段,需要提供合并段的信息;最终响应返回合并成功的Object的信息。

请求实例

POST /part?uploadId=2/WDkVkmtfKYOICFXuvKv_BcC2q4Ps1MX HTTP/1.1

Host: testbucket.eos.eayun.com

User-Agent: curl/7.43.0

Accept: */*

Authorization: AWS G7HGAZI01NOYBNWQ4EJD:cDD9p9uQxPQbkX/MgIsPcjC2Boo=

Date: Fri, 20 Nov 2015 06:37:34 +0000

Content-Type: application/octet-stream

Content-Length: 228

 

<CompleteMultipartUpload>

<Part>

<PartNumber>1</PartNumber>

<ETag>56730d3091a764d5f8b38feeef0bfcef</ETag>

</Part>

<Part>

<PartNumber>2</PartNumber>

<ETag>56730d3091a764d5f8b38feeef0bfcef</ETag>

</Part>

</CompleteMultipartUpload>


响应实例

HTTP/1.1 200

Date: Fri, 20 Nov 2015 06:37:56 GMT

Server: Apache/2.4.6 (CentOS) OpenSSL/1.0.1e-fips

Connection: close

Transfer-Encoding: chunked

Content-Type: application/xml

Set-Cookie: RADOSGWLB=ceph3; path=/

 

<?xml version="1.0" encoding="UTF-8"?>

<CompleteMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">

<Location>testbucket.eos.eayun.com</Location>

<Bucket>testbucket</Bucket>

<Key>part</Key>

<ETag>b3f4f3f0c47a71afa5c38fc85f7136c9-2</ETag>

</CompleteMultipartUploadResult>


© 2011-2017 易云捷讯科技(北京)股份有限公司, 版权所有 | © 2011-2017 Eayun,Inc. All rights reserved.

京公网安备 11010802022475号 | 京ICP备 11028869号

业务咨询:400-606-6396