快速使用命令列工具ossutil - Object Storage Service

使用ossutil，您可以在Windows、macOS和Linux系統上通過命令列高效管理阿里雲Object Storage Service服務（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
在Resource Orchestration Service控制台的建立資源棧頁面的安全確認下，勾選確認，然後單擊建立。
建立完成後，在輸出中，複製建立的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
```