閱讀786 返回首頁    go iPhone_iPad_Mac_apple


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下載

快速使用

獲取命令列表

./ossutil./ossutil help

  1. $./ossutil
  2. Usage: ossutil [command] [args...] [options...]
  3. Commands:
  4. mb url [options]
  5. 創建Bucket
  6. ls [url] [options]
  7. 列舉Buckets或者Objects
  8. rm url [options]
  9. 刪除Bucket或Objects
  10. stat url [options]
  11. 顯示bucket或者object的描述信息
  12. set-acl url [acl] [options]
  13. 設置bucket或者objects的acl
  14. set-meta url [meta] [options]
  15. 設置已上傳的objects的元信息
  16. cp src_url dest_url [options]
  17. 上傳,下載或拷貝Objects
  18. Additional Commands:
  19. help [command]
  20. 獲取命令的幫助文檔
  21. config [options]
  22. 創建配置文件用以存儲配置項
  23. hash file_url [options]
  24. 計算本地文件的crc64或md5
  25. update [options]
  26. 更新ossutil

查看某命令的幫助文檔

./ossutil help cmd強烈建議在使用某命令前先使用help來查閱幫助文檔。

  1. $./ossutil help ls
  2. SYNOPSIS
  3. 列舉Buckets或者Objects
  4. SYNTAX
  5. ossutil ls [oss://bucket[/prefix]] [-s] [-d] [-c file]
  6. DETAIL DESCRIPTION
  7. 該命令列舉指定身份憑證下的buckets,或該身份憑證下對應endpoint的objects。默認顯示
  8. 長格式,ossutil在列舉buckets或者objects的同時展示它們的一些附加信息。如果指定了
  9. --short-format選項,則顯示精簡格式。
  10. 對於用戶使用multipart方式上傳且未complete的object,ossutil在顯示objects或者目錄時,
  11. 不會顯示這些objects。(關於multipart的更多信息請查看oss官網API文檔。)
  12. 用法:
  13. 該命令有兩種用法:
  14. 1) ossutil ls [oss://] [-s]
  15. 如果用戶列舉時缺失url參數,則ossutil獲取用戶的身份憑證信息(從配置文件中讀取),
  16. 並列舉該身份憑證下的所有buckets,並顯示每個bucket的最新更新時間和位置信息。如果指定
  17. 了--short-format選項則隻輸出bucket名稱。該用法不支持--directory選項。
  18. 2) ossutil ls oss://bucket[/prefix] [-s] [-d]
  19. 該用法列舉指定bucket下的objects(如果指定了前綴,則列舉擁有該前綴的objects),同時
  20. 展示了object大小,最新更新時間和etag,但是如果指定了--short-format選項則隻輸出object名
  21. 稱。如果指定了--directory選項,則返回指定bucket下以指定前綴開頭的首級目錄下的文件和子
  22. 目錄,但是不遞歸顯示所有子目錄,此時默認為精簡格式。
  23. SAMPLE
  24. 1)ossutil ls -s
  25. oss://bucket1
  26. oss://bucket2
  27. oss://bucket3
  28. Bucket Number is: 3
  29. 2)ossutil ls oss:// -s
  30. oss://bucket1
  31. oss://bucket2
  32. oss://bucket3
  33. Bucket Number is: 3
  34. 3)ossutil ls oss://bucket1 -s
  35. oss://bucket1/obj1
  36. oss://bucket1/dir1/obj11
  37. Object Number is: 2
  38. 4)ossutil ls oss://bucket1
  39. LastModifiedTime Size(B) ETAG ObjectName
  40. 2016-04-08 14:50:47 +0000 UTC 6476984 4F16FDAE7AC404CEC8B727FCC67779D6 oss://bucket1/obj1
  41. 2015-06-05 14:06:29 +0000 UTC 201933 7E2F4A7F1AC9D2F0996E8332D5EA5B41 oss://bucket1/dir1/obj11
  42. Object Number is: 2
  43. 5)ossutil ls oss://bucket1 -d
  44. oss://bucket1/obj1
  45. oss://bucket1/dir1
  46. Object or Directory Number is: 2
  47. OPTIONS
  48. -s, --short-format
  49. 顯示精簡格式,如果未指定該選項,默認顯示長格式。
  50. -d, --directory
  51. 返回當前目錄下的文件和子目錄,而非遞歸顯示所有子目錄下的所有object
  52. -c, --config-file
  53. ossutil工具的配置文件路徑,ossutil啟動時從配置文件讀取配置,在config命令中,ossutil將配置寫入該文件。
  54. -e, --endpoint
  55. ossutil工具的基本endpoint配置(該選項值會覆蓋配置文件中的相應設置),注意其必須為一個二級域名。
  56. -i, --access-key-id
  57. 訪問oss使用的AccessKeyID(該選項值會覆蓋配置文件中的相應設置)。
  58. -k, --access-key-secret
  59. 訪問oss使用的AccessKeySecret(該選項值會覆蓋配置文件中的相應設置)。
  60. -t, --sts-token
  61. 訪問oss使用的STSToken(該選項值會覆蓋配置文件中的相應設置),非必須設置項。
  62. --retry-times=3
  63. 當錯誤發生時的重試次數,默認值:3,取值範圍:1-500

配置ossutil

./ossutil config

  1. $./ossutil config
  2. 該命令創建將一個配置文件,在其中存儲配置信息。
  3. 請輸入配置文件路徑(默認為:/home/admin/.ossutilconfig,回車將使用默認路徑):

列舉Buckets

./ossutil ls./ossutil ls oss://

  1. $./ossutil ls
  2. CreationTime Region BucketName
  3. 2016-10-21 16:18:37 +0800 CST oss-cn-hangzhou oss://go-sdk-test-bucket-xyz-for-object
  4. 2016-12-01 15:06:21 +0800 CST oss-cn-hangzhou oss://ossutil-test
  5. 2016-07-18 17:54:49 +0800 CST oss-cn-hangzhou oss://ossutilconfig
  6. 2016-07-20 10:36:24 +0800 CST oss-cn-hangzhou oss://ossutilupdate
  7. 2016-11-14 13:08:36 +0800 CST oss-cn-hangzhou oss://yyyyy
  8. 2016-08-25 09:06:10 +0800 CST oss-cn-hangzhou oss://ztzt
  9. 2016-11-21 21:18:39 +0800 CST oss-cn-hangzhou oss://ztztzt
  10. Bucket Number is: 7
  11. 0.252174(s) elapsed

列舉Objects

./ossutil ls oss://bucket

  1. $./ossutil ls oss://ossutil-test
  2. LastModifiedTime Size(B) ETAG ObjectName
  3. 2016-12-01 15:06:37 +0800 CST 10363812 61DE142E5AFF9A6748707D4A77BFBCFB oss://ossutil-test/a1
  4. 2016-12-01 15:06:42 +0800 CST 10363812 61DE142E5AFF9A6748707D4A77BFBCFB oss://ossutil-test/a2
  5. 2016-12-01 15:06:45 +0800 CST 10363812 61DE142E5AFF9A6748707D4A77BFBCFB oss://ossutil-test/a3
  6. Object Number is: 3
  7. 0.007379(s) elapsed

上傳文件

./ossutil cp localfile oss://bucket

  1. $./ossutil cp a oss://ossutil-test
  2. Succeed: scanned 1 files or directories, dealed 1 files or directories(upload 1 files, 0 directories, skip 0 files).
  3. 0.699795(s) elapsed
  1. $./ossutil cp -r dir oss://ossutil-test
  2. Succeed: scanned 12 files or directories, dealed 12 files or directories(upload 9 files, 3 directories, skip 0 files).
  3. 0.896320(s) elapsed

刪除Bucket

./ossutil rm oss://bucket -rfb

  1. $./ossutil rm oss://ossutil-test -rfb
  2. scaned 16 objects, removed 16 objects.
  3. removed bucket: ossutil-test.
  4. 0.875690(s) elapsed

其它

請使用./ossutil help cmd來查看想要使用的命令的幫助文檔。

最後更新:2016-12-06 15:53:22

  上一篇:go 第三方工具推薦__常用工具_對象存儲 OSS-阿裏雲
  下一篇:go 圖片URL規則__接入圖片服務_老版圖片服務手冊_對象存儲 OSS-阿裏雲