OSS命令行工具ossutil
ossutil工具旨在为您提供一个以命令行方式管理OSS数据的途径。当前版本未提供完整的Bucket和Multipart管理功能,相关功能会在后续版本中开发。如果您需要使用上述功能,建议先使用osscmd命令行工具。
工具下载
- 当前版本:1.4.2
- 运行环境
- Windows/Linux/Mac
- 支持架构:x86 (32bit, 64bit)
- binary下载
- [Linux x86 32bit] ossutil32
- [Linux x86 64bit] ossutil64
- [Windows x86 32bit] ossutil32.zip
- [Windows x86 64bit] ossutil64.zip
- [mac x86 64bit] ossutilmac64
- 安装使用
根据您的操作系统选择相应的binary或者压缩包下载后,运行相应的binary(如果binary为不可执行文件,请给binary增加可执行权限:chmod 755 ossutil),即:
- linux系统下:
./ossutil
- windows系统下(以64位系统为例):
- 解压压缩包,双击运行其中的bat文件,再键入:
ossutil64.exe
- 解压压缩包,cmd进入压缩包中binary所在的目录,键入:
ossutil64.exe
- 解压压缩包,双击运行其中的bat文件,再键入:
- mac系统下:
./ossutilmac64
- linux系统下:
快速使用
设置ossutil的语言
在使用ossutil的命令时,可以使用-L选项设置语言,可选值为CH/EN,即:中文或英文。大小写不敏感。默认语言为CH(中文)。如果设置为CH(中文),需要确保您的系统为utf-8编码,否则可能会显示乱码。
如:
./ossutil help ls
显示ls默认语言的帮助
./ossutil help ls -L ch
显示ls的中文帮助
./ossutil help ls -L en
显示ls的英文帮助
./ossutil config -L ch
运行ossutil config的交互式配置命令,提示语言为中文。
./ossutil config -L en
运行ossutil config的交互式配置命令,提示语言为英文。
./ossutil
./ossutil help
Usage: ossutil [command] [args...] [options...]
Please use 'ossutil help command' to show help of command Commands:
mb cloud_url [options]
Make Bucket
ls [cloud_url] [options]
List Buckets or Objects
rm cloud_url [options]
Remove Bucket or Objects
stat cloud_url [options]
Display meta information of bucket or objects
set-acl cloud_url [acl] [options]
Set acl on bucket or objects
set-meta cloud_url [meta] [options]
set metadata on already uploaded objects
cp src_url dest_url [options]
Upload, Download or Copy Objects
restore cloud_url [options]
Restore Frozen State Object to Read Ready Status
create-symlink cloud_url target_url [options]
Create symlink of object
read-symlink cloud_url [options]
Display meta information of symlink object
sign cloud_url [options]
Generate download link for object Additional Commands:
help [command]
Get help about commands
config [options]
Create configuration file to store credentials
hash file_url [options]
Get crc64 or md5 of local file
update [options]
Update ossutil
- 查看某命令的帮助文档
./ossutil help cmd 强烈建议在使用某命令前先使用help来查阅帮助文档。 ./ossutil help config -L ch
SYNOPSIS
创建配置文件用以存储配置项
SYNTAX
ossutil config [-e endpoint] [-i id] [-k key] [-t token] [-L language] [--output-dir outdir] [-c file]
DETAIL DESCRIPTION
该命令创建配置文件,将用户设置的配置项信息存储进该配置文件,配置项用
以访问OSS时提供访问信息(某命令是否需要配置项,参见其是否支持
--config-file选项,具体可见该命令的帮助)。
配置文件路径可由用户指定,默认为/home/admin/.ossutilconfig。如果配置
文件存在,假设其为:a,ossutil会将文件a另存为:a.bak,然后重新创建文件a
并写入配置,此时,如果a.bak存在,其会被文件a覆盖。
注意:
()如果指定的配置文件路径非默认路径,在使用命令时请将--config-file选
项设置为你配置时指定的配置文件路径(如果不指定--config-file选项,则运
行命令时默认会读取/home/admin/.ossutilconfig)。
()某些配置可在使用命令时通过选项进行设置,如--endpoint,--access-key-id,
等选项(具体请见每个命令的帮助),如果使用命令时指定了这些选项,并且同
时配置文件中也配置了这些信息,则优先级为:选项 > 配置文件。
()如果使用命令时指定了--endpoint、--access-key-id、--access-key-secret
或--sts-token选项,则ossutil不强求配置文件一定要存在。
用法:
该命令有两种用法,交互式1)和非交互式2),推荐用法为交互式,因为交互
式用法拥有更好的安全性。
) ossutil config [-c file]
该用法提供一种交互式的方法来配置信息,ossutil交互式地询问用户如下
信息:
() config file
配置文件路径,如果用户键入回车,ossutil会使用默认的配置文件:
/home/admin/.ossutilconfig。
如果用户自己指定了配置文件,在使用命令时需要将--config-file选项
设置为用户设置的配置文件路径。哪些命令支持--config-file选项可由查看
每个命令的帮助。
() language
当首次配置(配置文件不存在)时,ossutil会向用户询问语言设置,可
选值为中文或者英文(CH/EN),如果键入回车,ossutil将根据用户输入的
--language选项配置,如果此时用户也未输入--language选项,将配置成默认
语言中文。
如果配置文件已存在,ossutil会综合用户输入的language选项和配置文件
中的语言信息,配置该项,而不会询问。
ossutil在运行时会从配置文件中读取该language选项,如果该选项不存在
或者非法,将采用默认语言:CH。
注意:该配置项在此次config成功结束后才会生效,在执行config命令过
程中语言显示不会受用户的选择影响。
() endpoint, accessKeyID, accessKeySecret
回车代表着跳过相应配置项的设置。注意:endpoint应该为一个二级域
名(SLD),例如:oss.aliyuncs.com。
以上选项一般为必选项。
() stsToken
如果用户需要使用临时token来访问oss,用户需要填入该项,否则请输入
回车跳过该项配置。
() outputDir
该选项配置输出文件所在目录的路径。交互式模式时不提供该选项的配置,
但配置文件中该项配置起效。
outputDir的默认目录为:当前目录下的:ossutil_output,ossutil会在
运行过程中将输出文件都生成到该文件夹下。输出文件目前包含:在cp命令中
批量操作出错时,记录每个文件操作的错误信息的report文件。
关于outputDir和report文件的更多信息请参见cp命令的帮助。
注意:outputDir如果不存在,ossutil在输出文件时会自动创建该目录,
如果outputDir存在且并非目录,将会报错。
下述交互式Bucket-Endpoint和Bucket-Cname配置被取消,但配置文件中这两项
配置仍然起效。
() Bucket-Endpoint
Bucket-Endpoint对每个指定的bucket单独配置endpoint,此配置会优先于
配置文件中关于默认endpoint的配置。
在该版本中,ossutil取消了交互式配置中,关于Bucket-Endpoint配对的配
置,但配置文件中该项配置仍然起效,所以如果用户想对每个bucket单独指定
endpoint,仍然可以在配置文件中进行配置。注意:此处的endpoint应该为一个
二级域名(SLD),例如:oss.aliyuncs.com。
如果配置了Bucket-Endpoint选项,当对某bucket进行操作时,ossutil会在
该选项中寻找该bucket对应的endpoint,如果找到,该endpoint会覆盖基本配置
中endpoint。但是运行命令时如果指定了--endpoint选项,--endpoint选项为最
高优先级。
() Bucket-Cname
Bucket-Cname为每个指定的bucket单独配置CNAME域名(CDN加速域名),此
配置会优先于配置文件中Bucket-Endpoint及endpoint的配置。
在该版本中,ossutil取消了交互式配置中,关于Bucket-Cname配对的配置,
但配置文件中该项配置仍然起效,所以如果用户想对每个bucket单独指定CNAME
域名,仍然可以在配置文件中进行配置。
如果配置了Bucket-Cname选项,当对某bucket进行操作时,ossutil会在该
选项中寻找该bucket对应的CNAME域名,如果找到,则找到的CNAME域名会覆盖
Bucket-Endpoint选项和基本配置中的endpoint。运行命令时如果指定了--endpoint
选项,--endpoint选项为最高优先级。
优先级:--endpoint > Bucket-Cname > Bucket-Endpoint > endpoint > 默认endpoint
) ossutil config options
如果用户使用命令时输入了除--language和--config-file之外的任何选项,则
该命令进入非交互式模式。所有的配置项应当使用选项指定。
配置文件格式:
[Credentials]
language = CH
endpoint = oss.aliyuncs.com
accessKeyID = your_key_id
accessKeySecret = your_key_secret
stsToken = your_sts_token
outputDir = your_output_dir
[Bucket-Endpoint]
bucket1 = endpoint1
bucket2 = endpoint2
...
[Bucket-Cname]
bucket1 = cname1
bucket2 = cname2
...
SAMPLE
ossutil config
ossutil config -e oss-cn-hangzhou.aliyuncs.com -c ~/.myconfig
OPTIONS
-c, --config-file
ossutil工具的配置文件路径,ossutil启动时从配置文件读取配置,在config命令中,ossutil将配置写入该文件。
-e, --endpoint
ossutil工具的基本endpoint配置(该选项值会覆盖配置文件中的相应设置),注意其必须为一个二级域名。
-i, --access-key-id
访问oss使用的AccessKeyID(该选项值会覆盖配置文件中的相应设置)。
-k, --access-key-secret
访问oss使用的AccessKeySecret(该选项值会覆盖配置文件中的相应设置)。
-t, --sts-token
访问oss使用的STSToken(该选项值会覆盖配置文件中的相应设置),非必须设置项。
--output-dir=ossutil_output
指定输出文件所在的目录,输出文件目前包含:cp命令批量拷贝文件出错时所产生的report文件(关于report文件更多信息,请参考cp命令帮助)。默认值为:当前目录下的ossutil_output目录。
-L CH, --language=CH
设置ossutil工具的语言,默认值:CH,取值范围:CH/EN,若设置成"CH",请确保您的系统编码为UTF-。
- 配置ossutil
在使用访问oss的命令时,需要先配置访问AK,关于AK的更多信息见:RAM和STS介绍。 配置ossutil由两种方式:交互式和非交互式。 交互式配置ossutil
./ossutil config $./ossutil config -L ch
该命令创建将一个配置文件,在其中存储配置信息。
请输入配置文件路径(默认为:/home/admin/.ossutilconfig,回车将使用默认路径。如果用户设置为其它路径,在使用命令时需要将--config-file选项设置为该路径):
非交互式配置ossutil
./ossutil config -e oss.aliyuncs.com -i your_id -k your_key
关于配置命令的更多帮助,请使用ossutil help config查看。
OSS命令行工具ossutil的更多相关文章
- windows下的命令行工具babun
什么是babun babun是windows上的一个第三方shell,在这个shell上面你可以使用几乎所有linux,unix上面的命令,他几乎可以取代windows的shell.用官方的题目说就是 ...
- 『.NET Core CLI工具文档』(一).NET Core 命令行工具(CLI)
说明:本文是个人翻译文章,由于个人水平有限,有不对的地方请大家帮忙更正. 原文:.NET Core Command Line Tools 翻译:.NET Core命令行工具 什么是 .NET Core ...
- 命令行工具aspnet_regiis.exe实现加密和解密web.config
命令行工具aspnet_regiis.exe,是一个类似于DOS的命令工具,称之为命令解释器.使用命令行工具加密和解密web.config文件中的数据库连接字符串时,只需要简单的语法命令即可. 加密语 ...
- nodejs 编写(添加时间戳)命令行工具 timestamp
Nodejs除了编写服务器端程序还可以编写命令行工具,如gulp.js就是Nodejs编写的. 接下来我们来实现一个添加时间戳的命令: $ timestamp action https://www.n ...
- 如何用Node编写命令行工具
0. 命令行工具 当全局安装模块之后,我们可以在控制台下执行指定的命令来运行操作,如果npm一样.我把这样的模块称之为命令行工具模块(如理解有偏颇,欢迎指正) 1.用Node编写命令行工具 在Node ...
- Orchard中的命令行工具
在Orchard中提供了一个命令行工具,我们可以使用这个命令行工具创建用户.创建博客.生成代码.配置网站.打包模块等.并且这个命令行工具是可以扩充的,只要我们在自己开发的模块中创建一个Command类 ...
- Linux 性能监控之命令行工具
引言 对于系统和网络管理员来说每天监控和调试Linux系统的性能问题是一项繁重的工作.这些命令行工具可以在各种Linux系统下使用,可以用于监控和查找产生性能问题的原因.这个命令行工具列表提供了足够的 ...
- 命令行工具解析Crash文件,dSYM文件进行符号化
备份 文/爱掏蜂窝的熊(简书作者)原文链接:http://www.jianshu.com/p/0b6f5148dab8著作权归作者所有,转载请联系作者获得授权,并标注“简书作者”. 序 在日常开发 ...
- MySQL 命令行工具之 mysqldump 深入研究
mysqldump 是MySQL的一个命令行工具,用于逻辑备份.可以将数据库和表的结构,以及表中的数据分别导出成:create database, create table, insert into的 ...
随机推荐
- 使用System.Web.Optimization对CSS和JS文件合并压缩
在ASP.NET MVC 中JS/CSS文件动态合并及压缩通过调用System.Web.Optimization定义的类ScriptBundle及StyleBundle来实现. 大致步骤如下: 1.A ...
- linux下主流的三种远程技术
远程登录操作对于租用服务器的用户来说都不陌生.特别是租用国外服务器的用户来说,更是家常便饭.通过远程登录操作,即使我们人在深圳,也能无差别的操作远在美国的服务器.而对于linux系统下的服务器,目前主 ...
- Go语言的类型转换和类型断言
https://my.oschina.net/chai2010/blog/161418 https://studygolang.com/articles/9335 类型转换.类型断言和类型切换 ht ...
- node.js--Less
摘要: 现在已经有许多站点使用Node.js,所以在Node.js上配置Less环境也是很重要的,下面分享下如何在Node上使用Less开发,前提是你电脑上已经安装node. 安装: 只需要执行下面一 ...
- Linux Top命令详解(载自百度经验)
Linux系统可以通过top命令查看系统的CPU.内存.运行时间.交换分区.执行的线程等信息.通过top命令可以有效的发现系统的缺陷出在哪里.是内存不够.CPU处理能力不够.IO读写过高. 1 使用S ...
- nyoj 1239 引水project (河南省第八届acm程序设计大赛)
题目1239 pid=1239" style="color:rgb(55,119,188)">题目信息 pid=1239" style="col ...
- MongoDB文档的增删改操作
上一篇文章中介绍了MongoDB的一些基本知识,同时看到了怎么启动一个MongoDB服务,并且通过MongoDB自带的shell工具连接到了服务器. 这一次,就通过MongoDB shell介绍一下对 ...
- android studio 使用 SVN
通过android studio来进行版本控制,先前已经安装了TortoiseSVN-1.9.2,但是在打开android studio的时候会出现 Can't use Subversion comm ...
- iOS开发-- 使用VVDocumenter-Xcode添加代码注释
在开发Java代码过程中,我们只需在Eclipse中敲/**即可生成字段.方法对应的文档,简单便捷. 在Xcode如果想添加文档注释,需要花费很多时间,有没有简单.快速的方法搞定这一切? 在网上搜索了 ...
- 使用 github Pages 服务建立个人独立博客全过程
你是否有这样子的需求,只是想简单的写写文章,记录下自己的学习心得.成长经历等,都是些文字内容,不需要配置使用数据库.不想购买服务器自己搭建站点,只是想安安静静的用比较舒服的方式来写篇文章. 静态博客就 ...