全部产品
Search
文档中心

对象存储 OSS:有关Multipart命令

更新时间:Aug 31, 2023

本文主要介绍与碎片(part)相关的命令。

重要

osscmd于2019年7月31日下线,阿里云不再继续维护更新。osscmd操作命令已整合到ossutil中,推荐您使用ossutil

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

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