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
$./ossutil
Usage: ossutil [command] [args...] [options...]
Commands:
mb url [options]
創建Bucket
ls [url] [options]
列舉Buckets或者Objects
rm url [options]
刪除Bucket或Objects
stat url [options]
顯示bucket或者object的描述信息
set-acl url [acl] [options]
設置bucket或者objects的acl
set-meta url [meta] [options]
設置已上傳的objects的元信息
cp src_url dest_url [options]
上傳,下載或拷貝Objects
Additional Commands:
help [command]
獲取命令的幫助文檔
config [options]
創建配置文件用以存儲配置項
hash file_url [options]
計算本地文件的crc64或md5
update [options]
更新ossutil
查看某命令的幫助文檔
./ossutil help cmd
強烈建議在使用某命令前先使用help來查閱幫助文檔。
$./ossutil help ls
SYNOPSIS
列舉Buckets或者Objects
SYNTAX
ossutil 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下以指定前綴開頭的首級目錄下的文件和子
目錄,但是不遞歸顯示所有子目錄,此時默認為精簡格式。
SAMPLE
1)ossutil ls -s
oss://bucket1
oss://bucket2
oss://bucket3
Bucket Number is: 3
2)ossutil ls oss:// -s
oss://bucket1
oss://bucket2
oss://bucket3
Bucket Number is: 3
3)ossutil ls oss://bucket1 -s
oss://bucket1/obj1
oss://bucket1/dir1/obj11
Object Number is: 2
4)ossutil ls oss://bucket1
LastModifiedTime Size(B) ETAG ObjectName
2016-04-08 14:50:47 +0000 UTC 6476984 4F16FDAE7AC404CEC8B727FCC67779D6 oss://bucket1/obj1
2015-06-05 14:06:29 +0000 UTC 201933 7E2F4A7F1AC9D2F0996E8332D5EA5B41 oss://bucket1/dir1/obj11
Object Number is: 2
5)ossutil ls oss://bucket1 -d
oss://bucket1/obj1
oss://bucket1/dir1
Object or Directory Number is: 2
OPTIONS
-s, --short-format
顯示精簡格式,如果未指定該選項,默認顯示長格式。
-d, --directory
返回當前目錄下的文件和子目錄,而非遞歸顯示所有子目錄下的所有object
-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(該選項值會覆蓋配置文件中的相應設置),非必須設置項。
--retry-times=3
當錯誤發生時的重試次數,默認值:3,取值範圍:1-500
配置ossutil
./ossutil config
$./ossutil config
該命令創建將一個配置文件,在其中存儲配置信息。
請輸入配置文件路徑(默認為:/home/admin/.ossutilconfig,回車將使用默認路徑):
列舉Buckets
./ossutil ls
或 ./ossutil ls oss://
$./ossutil ls
CreationTime Region BucketName
2016-10-21 16:18:37 +0800 CST oss-cn-hangzhou oss://go-sdk-test-bucket-xyz-for-object
2016-12-01 15:06:21 +0800 CST oss-cn-hangzhou oss://ossutil-test
2016-07-18 17:54:49 +0800 CST oss-cn-hangzhou oss://ossutilconfig
2016-07-20 10:36:24 +0800 CST oss-cn-hangzhou oss://ossutilupdate
2016-11-14 13:08:36 +0800 CST oss-cn-hangzhou oss://yyyyy
2016-08-25 09:06:10 +0800 CST oss-cn-hangzhou oss://ztzt
2016-11-21 21:18:39 +0800 CST oss-cn-hangzhou oss://ztztzt
Bucket Number is: 7
0.252174(s) elapsed
列舉Objects
./ossutil ls oss://bucket
$./ossutil ls oss://ossutil-test
LastModifiedTime Size(B) ETAG ObjectName
2016-12-01 15:06:37 +0800 CST 10363812 61DE142E5AFF9A6748707D4A77BFBCFB oss://ossutil-test/a1
2016-12-01 15:06:42 +0800 CST 10363812 61DE142E5AFF9A6748707D4A77BFBCFB oss://ossutil-test/a2
2016-12-01 15:06:45 +0800 CST 10363812 61DE142E5AFF9A6748707D4A77BFBCFB oss://ossutil-test/a3
Object Number is: 3
0.007379(s) elapsed
上傳文件
./ossutil cp localfile oss://bucket
$./ossutil cp a oss://ossutil-test
Succeed: 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-test
Succeed: 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 -rfb
scaned 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-阿裏雲