文档首页/ 对象存储服务 OBS/ 快速入门/ obsutil命令行工具快速入门
更新时间:2024-07-30 GMT+08:00
分享

obsutil命令行工具快速入门

obsutil是一款用于访问管理华为云对象存储服务(Object Storage Service,OBS)的命令行工具,您可以使用该工具对OBS进行常用的配置管理操作。对于熟悉命令行程序的用户,obsutil能在执行批量处理、自动化任务场景能为您带来更优体验。

本文以上传一个“test.txt”文件至“bucket-test”桶为例,帮助您快速通过obsutil使用OBS的基础功能,包括创建桶、上传对象、下载对象、分享对象。

步骤一:创建桶

  • 以Windows操作系统为例,运行obsutil mb obs://bucket-test,创建一个名为bucket-test的新桶。桶名不能重复。
    obsutil mb obs://bucket-test
    
    Create bucket [bucket-test] successfully, request id [0000016979E1D2EA860BB5E80A6B8FCC]
  • 以Linux操作系统为例,运行./obsutil mb obs://bucket-test -location=cn-north-4,在华北-北京四区域创建一个名为bucket-test的新桶。桶名不能重复。
    ./obsutil mb obs://bucket-test -location=cn-north-4
    
    Create bucket [bucket-test] successfully, request id [00000190CA0531DE4015FE3458C7B4C0]

步骤二:上传对象

  • 以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
  • 以Linux操作系统为例,运行./obsutil cp /temp/test.txt obs://bucket-test/test.txt,将本地test.txt文件上传至bucket-test桶中。
    ./obsutil cp /temp/test.txt obs://bucket-test/test.txt
    
    Parallel:      5                   Jobs:          5
    Threshold:     52428800            PartSize:      5242880
    VerifyLength:  false               VerifyMd5:     false
    CheckpointDir: /root/.obsutil_checkpoint
    
    test.txt:[j1] [==============================================] 100.00% 48.47 KB/s 0s
    Upload successfully, 4.44KB, /temp/test.txt --> obs://bucket-test1/test.txt

步骤三:下载对象

  • 以Windows操作系统为例,运行obsutil cp obs://bucket-test/key d:\temp\test.txt,下载bucket-test桶内名为test.txt的对象。
    obsutil cp obs://bucket-test/key d:\temp\test.txt
    
    Parallel:      3                   Jobs:          3
    Threshold:     524288000           PartSize:      5242880
    Exclude:                           Include:
    VerifyLength:  false               VerifyMd5:     false
    CheckpointDir: xxxx
    
    [==========================================] 100.00% 4.86 KB/s 8.46MB/8.46MB 0s
    Download successfully, 8.46MB, obs://bucket-test/key --> d:\temp\test.txt
  • 以Linux操作系统为例,运行./obsutil cp obs://bucket-test/test.txt /temp/test1.txt,将bucket-test桶中的test.txt对象下载至本地。
    ./obsutil cp obs://bucket-test/test.txt /temp/test1.txt
    
    Parallel:      5                   Jobs:          5
    Threshold:     52428800            PartSize:      5242880
    VerifyLength:  false               VerifyMd5:     false
    CheckpointDir: /root/.obsutil_checkpoint
    
    test.txt:[=============================================] 100.00% 775.52 KB/s 0s
    Download successfully, 4.44KB, obs://bucket-test1/test.txt --> /temp/test1.txt

步骤四:分享对象

  • 以Windows操作系统为例,运行obsutil create-share obs://bucket/test.txt/ -ac=123456 -vp=1m,创建一个月内有效的授权码。
    obsutil create-share obs://bucket/test.txt/ -ac=123456 -vp=1m
    Authorization Code:
    https://e-share.obs-website.cn-north-4.myhuaweicloud.com?
    token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    
    Access Code:
    123456
    
    Valid Until:
    Sat, 26 Oct 2019 11:28:10 GMT +8000
  • 以Linux操作系统为例,运行obsutil create-share obs://bucket/test.txt/ -ac=123456 -vp=1m,创建一个月内有效的授权码。
    ./obsutil create-share obs://bucket/test.txt/ -ac=123456 -vp=1m
    
    Authorization Code:
    https://e-share.obs-website.cn-north-4.myhuaweicloud.com?
    token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    
    Access Code:
    123456
    
    Valid Until:
    Thu, 25 Jul 2024 17:10:36 GMT +0800

更多操作

当您完成创建OBS桶、上传对象、下载对象、分享对象等基本操作后,您还可以结合业务需求使用OBS的其他常用功能,具体请参见功能总览

相关文档