快速使用命令行工具ossutil - 对象存储 OSS

使用ossutil，您可以在Windows、macOS和Linux系统上通过命令行高效管理阿里云对象存储服务（OSS），并执行批量操作或自动化任务。本文将介绍如何通过命令行完成创建存储空间（Bucket）、上传文件、下载文件、列举文件，以及删除文件和删除Bucket等操作。

说明

本文以ossutil2.0为例。ossutil2.0相比于ossutil1.0版本进行了全面的功能升级，强烈推荐您使用全新版本的 ossutil2.0。如果您想查看ossutil1.0的相关内容，建议您参见命令行工具ossutil 1.0。
如果您已安装并配置ossutil 2.0，也可以直接参阅ossutil 2.0命令。

前提条件

已注册阿里云账号。
已开通OSS服务。
已创建有OSS管理权限的RAM用户AccessKey。
使用ROS脚本快速创建有OSS管理权限的RAM用户AccessKey
在资源编排ROS控制台的创建资源栈页面的安全确认下，勾选确认，然后单击创建。
创建完成后，在输出中，复制创建的AccessKey。

安装ossutil

Linux

安装unzip解压工具。

Alibaba Cloud Linux

sudo yum install -y unzip

CentOS

sudo yum install -y unzip

Ubuntu

sudo apt install -y unzip

下载ossutil压缩包。

curl -o ossutil-2.0.5-beta.11291800-linux-amd64.zip https://gosspublic.alicdn.com/ossutil/v2-beta/2.0.5-beta.11291800/ossutil-2.0.5-beta.11291800-linux-amd64.zip

说明

此处以Linux x86 64bit为例进行介绍。其他系统下载地址，请参见下载ossutil。

在下载压缩包的所在目录执行以下解压命令。
```
unzip ossutil-2.0.5-beta.11291800-linux-amd64.zip
```
进入ossutil-2.0.5-beta.11291800-linux-amd64目录。
```
cd ossutil-2.0.5-beta.11291800-linux-amd64
```
在当前目录执行以下命令。
```
chmod 755 ossutil
```
验证是否成功安装ossutil。
```
ossutil
```
返回ossutil的帮助信息即表示安装成功。

Windows

根据您电脑的配置点击Windows x86 64bit、Windows x86 32bit或Windows x86 64bit下载安装包。
将工具解压，并双击运行ossutil.exe文件。
验证是否成功安装ossutil。
```
ossutil
```
返回ossutil的帮助信息。

macOS

安装ossutil。

curl -o ossutil-2.0.5-beta.11291800-mac-arm64.zip  https://gosspublic.alicdn.com/ossutil/v2-beta/2.0.5-beta.11291800/ossutil-2.0.5-beta.11291800-mac-arm64.zip

说明

此处以macOS ARM 64bit为例进行介绍。其他系统下载地址，请参见下载ossutil。

在下载压缩包的所在目录执行以下解压命令。
```
unzip ossutil-2.0.5-beta.11291800-mac-arm64.zip
```
进入ossutil-2.0.5-beta.11291800-mac-arm64目录。
```
cd ossutil-2.0.5-beta.11291800-mac-arm64
```
在当前目录执行以下命令。
```
chmod 755 ossutil
```
验证是否成功安装ossutil。
```
ossutil
```
返回ossutil的帮助信息。

配置ossutil

配置ossutil。
```
ossutil config
```

根据提示设置ossutil配置文件路径。您可以直接回车使用默认的配置文件路径。

以下提示以Linux系统为例。

Please enter the config file name,the file name can include path(default /root/.ossutilconfig, carriage return will use the default file. If you specified this option to other file, you should specify --config-file option to the file when you use other commands):

根据提示输入之前创建的AccessKey ID。

Please enter Access Key ID [****************id]:LTAI****************

根据提示输入之前创建的AccessKey Secret。

Please enter Access Key Secret [****************sk]:R6vg*********************

根据提示输入OSS数据中心所在的地域ID。
```
Please enter Region [cn-hangzhou]:cn-hangzhou
```
本文以杭州地域为例，其他地域的ID参见OSS地域和访问域名。

运行示例

创建Bucket。
```
 ossutil mb oss://examplebucket
```
以下输出结果表明已成功创建examplebucket。
```
0.668238(s) elapsed
```

创建本地文件并上传到Bucket。

echo 'Hello, OSS!' > uploadFile.txt

ossutil cp uploadFile.txt oss://examplebucket

以下输出结果表明文件已成功上传至examplebucket。

Success: Total 1 file, size 12 B, Upload done:(1 objects, 12 B), avg 44 B/s

0.271779(s) elapsed

下载文件。
将已上传的示例文件uploadFile.txt从examplebucket下载至本地localfolder文件夹下。
```
ossutil cp oss://examplebucket/uploadFile.txt localfolder/
```
以下输出结果表明文件已成功下载至本地localfolder文件夹下。
```
Success: Total 1 object, size 12 B, Download done:(1 files, 12 B), avg 74 B/s

0.162447(s) elapsed
```

列举examplebucket下的文件。

ossutil ls oss://examplebucket

以下输出结果表明已成功列举examplebucket下的文件。

LastModifiedTime                   Size(B)  StorageClass   ETAG                                  ObjectName
2024-11-26 14:35:29 +0800 CST           12      Standard   1103F650EB2C292D179A032D2A97B0F5      oss://examplebucket/uploadFile.txt
Object Number is: 1

0.124679(s) elapsed

删除examplebucket下的uploadFile.txt。
```
ossutil rm oss://examplebucket/uploadFile.txt
```
以下输出结果表明已成功删除examplebucket下的uploadFile.txt。
```
0.295530(s) elapsed
```
删除examplebucket。
```
ossutil rb oss://examplebucket
```
以下输出结果表明已成功删除examplebucket。
```
0.478659(s) elapsed
```