ossutil支持通过Windows、Linux和macOS系统以命令行方式管理OSS数据。
sudo -v ; curl https://gosspublic.alicdn.com/ossutil/install.sh | sudo bash
安装过程中,需要使用解压工具(unzip、7z)解压软件包,请提前安装其中的一个解压工具。
安装完成后,ossutil会安装到/usr/bin/目录下。
ossutil config
请输入配置文件名,文件名可以带路径(默认为:/home/user/.ossutilconfig,回车将使用默认路径。
如果用户设置为其它路径,在使用命令时需要将--config-file选项设置为该路径):
ossutil默认使用/home/user/.ossutilconfig作为配置文件,若您设置了配置文件的路径,则每次使用命令时需增加-c选项指定配置文件。例如配置文件保存为/home/config,使用ls时,命令格式如下:
ossutil ls oss://examplebucket -c /home/config
CH
或EN
。工具使用的语言默认与操作系统保持一致。该配置项将在此次config命令设置成功后生效。
关于如何创建AccessKey和获取Endpoint,请参见创建AccessKey和访问域名和数据中心。更多配置方式,请参见通过config命令进行快速配置。
如果使用STSToken进行临时访问授权,需获取临时访问凭证,具体内容请参见使用STS临时访问凭证访问OSS。
获取到临时访问凭证后,在配置STSToken、AccessKey ID、AccessKey Secret时,请填入临时访问凭证中的SecurityToken、AccessKey ID和AccessKey Secret。
ossutil
如果屏幕中输出ossutil所有支持的命令,表明已成功安装ossutil。
本文以Linux系统为例,将本地文件或文件夹上传至OSS中。您在实际使用中,请根据您的系统和使用环境修改对应参数。本文涉及的通用示例说明如下:
本地文件:examplefile.txt(根目录下的文件)
本地文件夹:localfolder(根目录下的文件夹)
目标Bucket:examplebucket
目标Bucket指定目录:desfolder
上传文件时,如果不指定上传至OSS的文件名,则默认使用原文件名进行保存;如果指定文件名,则按照指定的文件名保存在OSS中。
ossutil cp examplefile.txt oss://examplebucket/desfolder/
ossutil cp -r localfolder/ oss://examplebucket/desfolder/
上传文件夹内的文件并指定时间戳
将本地文件夹内的文件上传到OSS指定路径,文件修改时间限定在北京时间2023年10月31日10:09:18至2023年10月31日12:55:58内。
ossutil cp -r localfolder/ oss://examplebucket/desfolder/ --start-time 1698718158 --end-time 1698728158
ossutil cp -r localfolder/ oss://examplebucket/desfolder/ -u
ossutil cp oss://examplebucket/destfolder/examplefile.txt localfolder/
下载某一个文件夹(包含子目录)下所有文件的示例如下:
ossutil cp -r oss://examplebucket/destfolder/ localfolder/
当批量下载失败或者需要增量下载文件时,可以通过指定--update(可缩写为-u)选项选择跳过已经成功下载的文件。如果本地与OSS没有同名文件,或本地同名文件的最后修改时间早于OSS文件,ossutil会下载该文件。如果本地已有同名文件,且文件的最后修改时间晚于OSS内文件时,ossutil会跳过该文件。示例如下:
ossutil cp -r oss://examplebucket/destfolder/ localfolder/ --update