complete-multipart-upload

注意事项

• 调用 complete-multipart-upload 操作时，用户需提供所有有效的分片列表（含 PartNumber 和 ETag），PartNumber 范围为 1~10000，按升序排列且可不连续；OSS 会验证每个分片的有效性，确保除最后一个分片外的每个分片大小不小于 100 KB，验证通过后将这些分片组合成一个完整的对象。

• 由于OSS处理CompleteMultipartUpload请求时会持续一定的时间。在这段时间内，如果客户端与OSS之间连接中断，OSS仍会继续该请求。

• 同一个Object可以同时拥有不同的UploadId，当Complete一个UploadId后，此UploadId将失效，但该Object的其他UploadId不受影响。

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限，需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。

命令格式

ossutil api complete-multipart-upload --bucket value --key value --upload-id value --complete-multipart-upload value [flags]

--complete-multipart-upload

--complete-multipart-upload配置选项既支持XML语法也支持JSON语法，当选项值包含file://前缀时，表示从文件中读取配置。

• XML语法：

  <CompleteMultipartUpload>
    <Part>
      <PartNumber>integer</PartNumber>
      <ETag>string</ETag>
    </Part>
    ...
  </CompleteMultipartUpload>

• JSON语法：

  {
    "Part": [
      {
        "PartNumber": integer,
        "ETag": "string"
      },
      ...
    ]
  }

使用示例

以下示例展示了如何为存储空间examplebucket中上传ID为123的exampleobject完成分片上传。

• 使用XML配置文件，complete-multipart-upload.xml内容如下：

  <?xml version="1.0" encoding="UTF-8"?>
  <CompleteMultipartUpload>
    <Part>
      <PartNumber>1</PartNumber>
      <ETag>"C884BAB4F7A89D38A194568C7DE****"</ETag>
    </Part>
    <Part>
      <PartNumber>2</PartNumber>
      <ETag>"C884BAB4F7A89D38A194568C7DEA****"</ETag>
    </Part>
  </CompleteMultipartUpload>

命令示例如下：

ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-multipart-upload file://complete-multipart-upload.xml

• 使用JSON配置文件，complete-multipart-upload.json 内容如下：

  {
    "Part": [
      {
        "PartNumber": "1",
        "ETag": "\"C884BAB4F7A89D38A194568C7DE****\""
      },
      {
        "PartNumber": "2",
        "ETag": "\"C884BAB4F7A89D38A194568C7DEA****\""
      }
    ]
  }

  命令示例如下：

  ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-multipart-upload file://complete-multipart-upload.json

• 使用JSON配置参数，命令示例如下：

  ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-multipart-upload file://complete-multipart-upload.json

以下示例展示了如何列举存储空间examplebucket的当前UploadId为123已上传的所有Part。

ossutil api complete-multipart-upload --bucket examplebucket --key exampleobject --upload-id 123 --complete-all yes