上传对象

功能说明

上传单个或多个本地文件或文件夹至OBS指定路径。待上传的文件可以是任何类型：文本文件、图片、视频等等。

上传本地文件或文件夹时，请确保本地文件或文件夹在上传过程不发生变化，否则可能产生上传失败或者数据不一致的问题。

约束与限制

obsutil对上传的文件或文件夹有大小限制，最小可以上传0Byte的空文件或文件夹，最大可以上传5GB（未采用分段上传）或48.8TB（采用分段上传）的单个文件。

命令结构

• Windows操作系统
  • 上传文件

    obsutil cp file_url obs://bucket[/key] [-arcDir=xxx] [-dryRun] [-link] [-u] [-vlength] [-vmd5] [-p=1] [-threshold=5248800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-o=xxx] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

  • 上传文件夹

    obsutil cp folder_url obs://bucket[/key] -r [-arcDir=xxx] [-dryRun] [-link] [-f] [-flat] [-u] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

  • 多文件/文件夹上传

    obsutil cp file1_url,folder1_url|filelist_url obs://bucket[/prefix] -msm=1 [-r] [-arcDir=xxx] [-dryRun] [-link] [-f] [-u] [-vlength] [-vmd5] [-flat] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx][-timeRange=time1-time2] [-at] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

    

    命令中的“/prefix”即为上传文件夹时的对象名前缀。运行示例请参见上传示例

• Linux/Mac操作系统
  • 上传文件

    ./obsutil cp file_url obs://bucket[/key] [-arcDir=xxx] [-dryRun] [-link] [-u] [-vlength] [-vmd5] [-p=1] [-threshold=5248800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-o=xxx] [-cpd=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

  • 上传文件夹

    ./obsutil cp folder_url obs://bucket[/key] -r [-arcDir=xxx] [-dryRun] [-link] [-f] [-flat] [-u] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx] [-timeRange=time1-time2] [-at] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

  • 多文件/文件夹上传

    ./obsutil cp file1_url,folder1_url|filelist_url obs://bucket[/prefix] -msm=1 [-r] [-arcDir=xxx] [-dryRun] [-link] [-f] [-u] [-vlength] [-vmd5] [-flat] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [-meta=aaa:bbb#ccc:ddd] [-ps=auto] [-include=*.xxx] [-exclude=*.xxx][-timeRange=time1-time2] [-mf] [-o=xxx] [-cpd=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

    

    命令中的“/prefix”即为上传文件夹时的对象名前缀。运行示例请参见上传示例

运行示例

• 以Windows操作系统为例，运行obsutil cp d:\temp\test.txt obs://bucket-test/key，将D盘temp路径下名为test.txt的文件上传至bucket-test桶中，并且重命名为key。

  obsutil cp d:\temp\test.txt obs://bucket-test/key
  
  Parallel:      3                   Jobs:          3
  Threshold:     524288000           PartSize:      5242880
  Exclude:                           Include:
  VerifyLength:  false               VerifyMd5:     false
  CheckpointDir: xxxx
  
  [====================================================] 100.00% 1.68 MB/s 8.46MB/8.46MB 5s
  Upload successfully, 8.46MB, d:\temp\test.txt --> obs://bucket-test/key

• 以Windows操作系统为例，运行obsutil cp d:\temp obs://bucket-test -f -r，递归上传D盘temp文件夹中的所有文件和子文件夹至bucket-test桶的temp文件夹中。

  obsutil cp d:\temp obs://bucket-test -f -r
  
  Parallel:      3                   Jobs:          3
  Threshold:     524288000           PartSize:      5242880
  Exclude:                           Include:
  VerifyLength:  false               VerifyMd5:     false
  CheckpointDir: xxxx
  
  Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed
  OutputDir: xxxx
  
  [========================================================] 100.00% tps:35.71 2.02 KB/s 7.20MB/7.20MB 0s
  Succeed count is:   5         Failed count is:    0
  Metrics [max cost:90 ms, min cost:45 ms, average cost:63.80 ms, average tps:35.71]
  
  Task id: 104786c8-27c2-48fc-bc6a-5886596fb0ed

• 更多运行示例，请参见上传示例。

参数说明

./obsutil cp /localpath/ obs://test/ -include=/localpath/2022-12-09/* -f -r

响应结果