全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
对象存储 OSS

有关Multipart命令

更新时间:2017-06-07 13:26:11

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

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

本文导读目录