对象存储 OSS：有关Multipart命令

init

命令说明：

init oss://bucket/object

初始化生成一个Upload ID。这个Upload ID可以配合后面的multiupload命令来使用。

使用示例：

python osscmd init oss://mybucket/myobject

listpart

命令说明：

listpart oss://bucket/object --upload_id=xxx

显示指定object的Upload ID下已经上传的Parts。相关概念见OSS API文档。必须要指定Upload ID。

使用示例：

python osscmd listpart oss://mybucket/myobject --upload_id=
          75835E389EA648C0B93571B6A46023F3

listparts

命令说明：

listparts oss://bucket

显示bucket中未完成的multipart Upload ID和object。一般在删除bucket提示bucket非空的情况下，可以用这个命令查看是否有multipart相关的内容。

使用示例：

python osscmd listparts oss://mybucket

getallpartsize

命令说明：

getallpartsize oss://bucket

显示bucket中还存在的Upload ID下已经上传的Parts的总大小。

使用示例：

python osscmd getallpartsize oss://mybucket

cancel

命令说明：

cancel oss://bucket/object --upload_id=xxx

终止Upload ID对应的Multipart Upload事件。

使用示例：

python osscmd cancel oss://mybucket/myobject --upload_id=
          D9D278DB6F8845E9AFE797DD235DC576

multiupload(multi_upload,mp)

命令说明：

multiupload(multi_upload,mp) localfile oss://bucket/object --check_md5=false
        --thread_num=10

将本地文件以multipart的方式上传到OSS。

使用示例：

• python osscmd multiupload /tmp/localfile.txt oss://mybucket/object

• python osscmd multiup_load /tmp/localfile.txt oss://mybucket/object

• python osscmd mp /tmp/localfile.txt oss://mybucket/object

命令说明：

multiupload(multi_upload,mp) localfile oss://bucket/object --upload_id=xxx --thread_num=10
        --max_part_num=1000 --check_md5=false

将本地文件以multipart的方式上传到OSS。本地文件划分的块数由max_part_num来指定。这个命令在实现的时候，会先去判断Upload ID对应的Parts的ETag是否和本地文件的MD5值是否相等，相等则跳过上传。所以在使用之前生成一个Upload ID，作为参数传进来。即使上传没有成功，重复执行相同的multiupload命令可以达到一个断点续传的效果。--check_md5=false表示上传文件时，不会做携带Content-MD5请求头校验。true则会做校验。

使用示例：

• python osscmd multiupload /tmp/localfile.txt oss://mybucket/object --upload_id=
            D9D278DB6F8845E9AFE797DD235DC576

• python osscmd multiup_load /tmp/localfile.txt oss://mybucket/object
          --thread_num=5

• python osscmd mp /tmp/localfile.txt oss://mybucket/object --max_part_num=100

copylargefile

命令说明：

copylargefile oss://source_bucket/source_object oss://target_bucket/target_object
        --part_size=10*1024*1024 --upload_id=xxx

对于超过1G的大文件进行复制时，采用multipart的方式将object复制到指定位置（源bucket必须与目标bucket处于同一region）。其中upload_id为可选参数，当需要对某一次multipart copy事件进行续传的时候，可以传入该事件的upload_id。part_size用来设定分块大小，分块最小需要大于100KB，最多支持10000块分块。如果part_size设定值导致与OSS限制冲突，程序会帮你自动调节分块大小。

使用示例：

python osscmd copylargefile oss://source_bucket/source_object
          oss://target_bucket/target_object --part_size=10*1024*1024

uploadpartfromfile (upff)

命令说明：

uploadpartfromfile (upff) localfile oss://bucket/object --upload_id=xxx
        --part_number=xxx

主要用于测试，不推荐使用。

uploadpartfromstring(upfs)

命令说明：

uploadpartfromstring(upfs) oss://bucket/object --upload_id=xxx --part_number=xxx
        --data=xxx

主要用于测试，不推荐使用。