ossutil__常用工具_對象存儲 OSS-阿裏雲
ossutil工具旨在為用戶提供一個方便的,以命令行方式管理OSS數據的途徑。當前版本未提供Bucket管理功能和Multipart管理功能,相關功能會在後續版本中開發。現在如果有使用上述功能的需要,可以先使用osscmd命令行工具。
工具下載
當前版本
- 當前版本:1.0.0.Beta1
版本更新提示
該版本相對於版本1.0.0.Beta為不兼容性修改。
不兼容性修改1.命令名稱風格改變,setacl變成set-acl,setmeta變成set-meta。2.選項名風格改變,下劃線變成中劃線。3.—routines選項更名為—jobs。4.去除—man選項。5.語言選項合法值由:中文/English,變更為CH/EN,如果您的配置文件中有language選項,並且其配置為English,請變更為EN。
其他修改1.所有命令除additional command都支持命令行指定endpoint, AccessKeyID, AccessKeySecret, STSToken。2.增加hash命令。3.顯示時間由UTC時間轉換為本地時間。4.Windows下cp的分隔符bug修複,用/替換目錄的,解決瀏覽器不認識url的問題。5.修複名稱中含有特殊字符的object,在bucket間拷貝出錯問題。6.cp操作對單文件支持並發數的設定。7.新上傳文件支持crc64校驗。
運行環境
- Linux
- Windows
- Mac
binary下載
- [linux 64bit] [ossutil]ossutil
- [windows 32bit] [ossutil32]ossutil32.exe
- [windows 64bit] [ossutil64]ossutil64.exe
- [mac] [ossutilmac64]ossutilmac64
快速使用
獲取命令列表
./ossutil或 ./ossutil help
$./ossutilUsage: ossutil [command] [args...] [options...]Commands:mb url [options]創建Bucketls [url] [options]列舉Buckets或者Objectsrm url [options]刪除Bucket或Objectsstat url [options]顯示bucket或者object的描述信息set-acl url [acl] [options]設置bucket或者objects的aclset-meta url [meta] [options]設置已上傳的objects的元信息cp src_url dest_url [options]上傳,下載或拷貝ObjectsAdditional Commands:help [command]獲取命令的幫助文檔config [options]創建配置文件用以存儲配置項hash file_url [options]計算本地文件的crc64或md5update [options]更新ossutil
查看某命令的幫助文檔
./ossutil help cmd強烈建議在使用某命令前先使用help來查閱幫助文檔。
$./ossutil help lsSYNOPSIS列舉Buckets或者ObjectsSYNTAXossutil ls [oss://bucket[/prefix]] [-s] [-d] [-c file]DETAIL DESCRIPTION該命令列舉指定身份憑證下的buckets,或該身份憑證下對應endpoint的objects。默認顯示長格式,ossutil在列舉buckets或者objects的同時展示它們的一些附加信息。如果指定了--short-format選項,則顯示精簡格式。對於用戶使用multipart方式上傳且未complete的object,ossutil在顯示objects或者目錄時,不會顯示這些objects。(關於multipart的更多信息請查看oss官網API文檔。)用法:該命令有兩種用法:1) ossutil ls [oss://] [-s]如果用戶列舉時缺失url參數,則ossutil獲取用戶的身份憑證信息(從配置文件中讀取),並列舉該身份憑證下的所有buckets,並顯示每個bucket的最新更新時間和位置信息。如果指定了--short-format選項則隻輸出bucket名稱。該用法不支持--directory選項。2) ossutil ls oss://bucket[/prefix] [-s] [-d]該用法列舉指定bucket下的objects(如果指定了前綴,則列舉擁有該前綴的objects),同時展示了object大小,最新更新時間和etag,但是如果指定了--short-format選項則隻輸出object名稱。如果指定了--directory選項,則返回指定bucket下以指定前綴開頭的首級目錄下的文件和子目錄,但是不遞歸顯示所有子目錄,此時默認為精簡格式。SAMPLE1)ossutil ls -soss://bucket1oss://bucket2oss://bucket3Bucket Number is: 32)ossutil ls oss:// -soss://bucket1oss://bucket2oss://bucket3Bucket Number is: 33)ossutil ls oss://bucket1 -soss://bucket1/obj1oss://bucket1/dir1/obj11Object Number is: 24)ossutil ls oss://bucket1LastModifiedTime Size(B) ETAG ObjectName2016-04-08 14:50:47 +0000 UTC 6476984 4F16FDAE7AC404CEC8B727FCC67779D6 oss://bucket1/obj12015-06-05 14:06:29 +0000 UTC 201933 7E2F4A7F1AC9D2F0996E8332D5EA5B41 oss://bucket1/dir1/obj11Object Number is: 25)ossutil ls oss://bucket1 -doss://bucket1/obj1oss://bucket1/dir1Object or Directory Number is: 2OPTIONS-s, --short-format顯示精簡格式,如果未指定該選項,默認顯示長格式。-d, --directory返回當前目錄下的文件和子目錄,而非遞歸顯示所有子目錄下的所有object-c, --config-fileossutil工具的配置文件路徑,ossutil啟動時從配置文件讀取配置,在config命令中,ossutil將配置寫入該文件。-e, --endpointossutil工具的基本endpoint配置(該選項值會覆蓋配置文件中的相應設置),注意其必須為一個二級域名。-i, --access-key-id訪問oss使用的AccessKeyID(該選項值會覆蓋配置文件中的相應設置)。-k, --access-key-secret訪問oss使用的AccessKeySecret(該選項值會覆蓋配置文件中的相應設置)。-t, --sts-token訪問oss使用的STSToken(該選項值會覆蓋配置文件中的相應設置),非必須設置項。--retry-times=3當錯誤發生時的重試次數,默認值:3,取值範圍:1-500
配置ossutil
./ossutil config
$./ossutil config該命令創建將一個配置文件,在其中存儲配置信息。請輸入配置文件路徑(默認為:/home/admin/.ossutilconfig,回車將使用默認路徑):
列舉Buckets
./ossutil ls或 ./ossutil ls oss://
$./ossutil lsCreationTime Region BucketName2016-10-21 16:18:37 +0800 CST oss-cn-hangzhou oss://go-sdk-test-bucket-xyz-for-object2016-12-01 15:06:21 +0800 CST oss-cn-hangzhou oss://ossutil-test2016-07-18 17:54:49 +0800 CST oss-cn-hangzhou oss://ossutilconfig2016-07-20 10:36:24 +0800 CST oss-cn-hangzhou oss://ossutilupdate2016-11-14 13:08:36 +0800 CST oss-cn-hangzhou oss://yyyyy2016-08-25 09:06:10 +0800 CST oss-cn-hangzhou oss://ztzt2016-11-21 21:18:39 +0800 CST oss-cn-hangzhou oss://ztztztBucket Number is: 70.252174(s) elapsed
列舉Objects
./ossutil ls oss://bucket
$./ossutil ls oss://ossutil-testLastModifiedTime Size(B) ETAG ObjectName2016-12-01 15:06:37 +0800 CST 10363812 61DE142E5AFF9A6748707D4A77BFBCFB oss://ossutil-test/a12016-12-01 15:06:42 +0800 CST 10363812 61DE142E5AFF9A6748707D4A77BFBCFB oss://ossutil-test/a22016-12-01 15:06:45 +0800 CST 10363812 61DE142E5AFF9A6748707D4A77BFBCFB oss://ossutil-test/a3Object Number is: 30.007379(s) elapsed
上傳文件
./ossutil cp localfile oss://bucket
$./ossutil cp a oss://ossutil-testSucceed: scanned 1 files or directories, dealed 1 files or directories(upload 1 files, 0 directories, skip 0 files).0.699795(s) elapsed
$./ossutil cp -r dir oss://ossutil-testSucceed: scanned 12 files or directories, dealed 12 files or directories(upload 9 files, 3 directories, skip 0 files).0.896320(s) elapsed
刪除Bucket
./ossutil rm oss://bucket -rfb
$./ossutil rm oss://ossutil-test -rfbscaned 16 objects, removed 16 objects.removed bucket: ossutil-test.0.875690(s) elapsed
其它
請使用./ossutil help cmd來查看想要使用的命令的幫助文檔。
最後更新:2016-12-06 15:53:22
上一篇:
第三方工具推薦__常用工具_對象存儲 OSS-阿裏雲
下一篇:
圖片URL規則__接入圖片服務_老版圖片服務手冊_對象存儲 OSS-阿裏雲
用戶簽名驗證__訪問控製_API 參考_對象存儲 OSS-阿裏雲
nodejs sdk__SDK使用手冊_內容檢測API文檔_阿裏綠網-阿裏雲
企業郵箱postmaster管理員賬號更改密碼方法__控製台操作_產品使用問題_企業郵箱-阿裏雲
GetBucketReferer__關於Bucket的操作_API 參考_對象存儲 OSS-阿裏雲
按秒計費!阿裏雲服務器大升級
推送日誌到OSS__日誌管理使用幫助_控製台使用幫助_消息服務-阿裏雲
容器監控服務__日誌和監控_用戶指南_容器服務-阿裏雲
主鍵列自增__最佳實踐_表格存儲-阿裏雲
刪除編排模板__鏡像與模板管理_用戶指南_容器服務-阿裏雲
Ping響應延遲或丟包的解決辦法__故障處理_雲服務器 ECS-阿裏雲
相關內容
常見錯誤說明__附錄_大數據計算服務-阿裏雲
發送短信接口__API使用手冊_短信服務-阿裏雲
接口文檔__Android_安全組件教程_移動安全-阿裏雲
運營商錯誤碼(聯通)__常見問題_短信服務-阿裏雲
設置短信模板__使用手冊_短信服務-阿裏雲
OSS 權限問題及排查__常見錯誤及排除_最佳實踐_對象存儲 OSS-阿裏雲
消息通知__操作指南_批量計算-阿裏雲
設備端快速接入(MQTT)__快速開始_阿裏雲物聯網套件-阿裏雲
查詢API調用流量數據__API管理相關接口_API_API 網關-阿裏雲
使用STS訪問__JavaScript-SDK_SDK 參考_對象存儲 OSS-阿裏雲