描述
此操作用于合并已经上传的Part,并返回新创建的Archive ID。上传Part时,用户指定范围值,用于标识每个Part在整个Archive的位置;合并Part时会检查是否有任何缺失的数据范围;如果数据范围缺失,则会返回错误,操作失败。合并请求需要用户指定校验字段,计算方法参见2.5.2。
Part合并是一种幂等的操作。第一次成功完成合并后,如果您在短时间内再次调用该操作,则会成功返回相同的Archive ID。这在您遇到连接中断或收到500服务器错误时很有用,在这种情况下,您可以重复您的Part合并请求并获取相同的Archive ID,而避免创建重复的Archive。但是,请注意,在合并Part以后,您不能再对之前的Part进行操作,并且Part将不会出现在后续获取到的Part列表中,即使可能幂等完成也是如此。
请求参数
无
请求头部
名称 | 是否必须 | 描述 |
x-oas-archive-size | 是 | 文档的长度,以字节为单位 |
x-oas-tree-etag | 是 | Part合并校验字段,计算方法参见2.5.2 |
名称 | 描述 |
Location | 已经合并的文档URI 路径 |
x-oas-archive-id | Archive ID,这个值也被置于Location中 |
POST /vaults/[VaultId]/multipart-uploads/[UploadId] HTTP/1.1
Host: cn-hangzhou.oas.aliyuncs.com
Date: Tue, 25 Mar 2014 12:00:00 GMT
x-oas-archive-size: 201327235
x-oas-tree-etag: AF8B6ED0A292020016639954C558629F-67108864
x-oas-version: 2014-01-01
Authorization: [SignatureValue]
HTTP/1.1 201 Created
x-oas-request-id: [RequestId]
Date: Tue, 25 Mar 2014 12:00:00 GMT
Location: /vaults/[VaultId]/archives/[ArchiveId]
x-oas-archive-id: ArchiveId
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。