如何将Part合并
描述
此操作用于合并已经上传的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 |
其他公共请求头部参见2.4.1
请求体
无
返回头部
| 名称 | 描述 |
| Location | 已经合并的文档URI 路径 |
| x-oas-archive-id | Archive ID，这个值也被置于Location中 |
其他公共返回头部参见2.4.2
返回体
示例
请求示例
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
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
根据您提供的信息，此操作涉及的是将已上传的Part合并以创建一个Archive。以下是关于此操作的详细说明：
操作描述
该操作用于将分片上传的所有Part合并成一个完整的Archive，并返回新创建的Archive ID。在上传每个Part时，用户需指定其在整个Archive中的位置范围。合并过程中系统会检查所有Part是否完整无缺，任何数据范围的缺失都将导致合并失败并返回错误。
请求特性
- 幂等性：首次成功合并后，重复执行此操作会返回相同的Archive ID，适用于网络中断或服务器错误后的重试场景，避免生成重复Archive。
- Part状态变更：一旦Part被合并，它们将不可再进行操作，并从后续的Part列表中移除。
请求参数与头部
- 请求参数：无直接携带于URL或Body的数据，操作通过HTTP头部指定必需信息。
- 请求头部：
x-oas-archive-size（必需）：表示文档总长度，单位为字节。x-oas-tree-etag（必需）：用于校验Part合并的字段，计算方法请参考相关文档。
返回信息
- 返回头部：
Location：提供已合并文档的URI路径。x-oas-archive-id：返回的Archive ID，也会置于Location中。
- 返回体：无具体内容返回，操作成功通过HTTP状态码201表明。
示例
请求示例
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
请注意，虽然这里引用了特定的API调用格式和头部信息，但实际应用时应参照阿里云OSS服务的最新文档来获取最新的签名方法、版本号及其它可能变动的细节。
参考资料： 验证字段计算方法位于未直接展示的参考资料中，请查阅相关文档获取详情。
