OSS工具 ossutil中文幫助文檔


此工具一般安裝在linux /root目錄下

./ossutil64 help ls -L ch  #查看中文幫助文檔

------------------------------------------------------------------以下是文檔正文部分-------------------------------------

SYNOPSIS

 

    列舉Buckets或者Objects

 

SYNTAX

 

    ossutil ls [oss://bucket[/prefix]] [-s] [-d] [-m] [--limited-num num] [--marker marker] [--upload-id-marker umarker] [--payer requester] [--include include-pattern] [--exclude exclude-pattern]  [--version-id-marker id_marker] [--all-versions]  [-c file]

 

DETAIL DESCRIPTION

 

    該命令列舉指定身份憑證下的buckets,或該身份憑證下對應endpoint的objects。默認顯示長格式,

    ossutil在列舉buckets或者objects的同時展示它們的一些附加信息。如果指定了--short-format選

    項,則顯示精簡格式。

 

--encoding-type選項

 

    如果指定了encoding-type為url,則表示輸入的object(或prefix)為經過url編碼的,此時如果指定了

    --marker選項或--upload-id-marker選項,ossutil默認指定的marker或upload-id-marker也同樣是經過

    url編碼的。注意:形如oss://bucket/object的cloud_url,輸入形式為:oss://bucket/url_encode(object),

    其中oss://bucket/字符串不需要編碼。

 

--include和--exclude選項

 

    可以指定該選項以指定規則篩選要操作的文件/object

 

    規則支持以下格式:

    *:匹配索引

    ?:匹配單個字符

    [sequence]:匹配sequence的任意字符

    [!sequence]:匹配不在sequence的任意字符

    注意:規則不支持帶目錄的格式,e.g.,--include "/usr/*/test/*.jpg"。

 

    --include和--exclude可以出現多次。當多個規則出現時,這些規則按從左往右的順序應用

 

用法:

 

    該命令有兩種用法:

 

    1) ossutil ls [oss://] [-s] [--limited-num num] [--marker marker]

        如果用戶列舉時缺失cloud_url參數,則ossutil獲取用戶的身份憑證信息(從配置文件中讀取),

    並列舉該身份憑證下的所有buckets,並顯示每個bucket的最新更新時間,位置,存儲方式等信息。

    如果指定了--short-format選項則只輸出bucket名稱。該用法不支持--directory選項。

 

    2) ossutil ls oss://bucket[/prefix] [-s] [-d] [-m] [-a] [--limited-num num] [--marker marker] [--upload-id-marker umarker]  [--version-id-marker id_marker] [--all-versions]

        如果未指定--multipart和--all-type選項,則ossutil列舉指定bucket下的objects(如果指定

    了前綴,則列舉擁有該前綴的objects)。並同時展示object大小,最新更新時間和etag,但是如果

    指定了--short-format選項則只輸出object名稱。如果指定了--directory選項,則返回指定bucket

    下以指定前綴開頭的第一層目錄下的文件和子目錄,但是不遞歸顯示所有子目錄,此時默認為精簡

    格式。所有的目錄均以/結尾。

        如果指定了--multipart選項,則顯示指定URL(oss://bucket[/prefix])下未完成的上傳任務,

    即,列舉未complete的Multipart Upload事件的uploadId,這些Multipart Upload事件的object名

    稱以指定的prefix為前綴。ossutil同時顯示uploadId的init時間。該選項同樣支持--short-format

    和--directory選項。(Multipart同樣用於cp命令中大文件的斷點續傳,關於Multipart的更多信息

    見:https://help.aliyun.com/document_detail/31991.html?spm=5176.doc31992.6.880.VOSDk5)。

        如果指定了--all-type選項,則顯示指定URL(oss://bucket[/prefix])下的object和未完成的

         上傳任務(即,同時列舉以prefix為前綴的object,和object名稱以prefix為前綴的所有未complete

    的uploadId)。該選項同樣支持--short-format和--directory選項。

        如果指定了--limited-num選項,ossutil總共會輸出的對象個數不超過limited-num個,當同時

    輸出object和Multipart Upload時,兩者的總數不超過limited-num個。

        在列舉objects時,--upload-id-marker選項不起作用。在列舉Multipart Uploads事件時,--marker

    和--upload-id-marker選項同時限定了列舉的起始位置,更多信息請見oss的官網:

    https://help.aliyun.com/document_detail/31997.html?spm=5176.doc31965.6.887.MK6GVw.

 

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/dir1/obj11

        oss://bucket1/obj1

        oss://bucket1/sample.txt

        Object Number is: 3

 

    4) ossutil ls oss://bucket1

        LastModifiedTime              Size(B)  StorageClass   ETAG                              ObjectName

        2015-06-05 14:06:29 +0000 CST  201933      Standard   7E2F4A7F1AC9D2F0996E8332D5EA5B41  oss://bucket1/dir1/obj11

        2015-06-05 14:36:21 +0000 CST  201933      Standard   6185CA2E8EB8510A61B3A845EAFE4174  oss://bucket1/obj1

        2016-04-08 14:50:47 +0000 CST 6476984      Standard   4F16FDAE7AC404CEC8B727FCC67779D6  oss://bucket1/sample.txt

        Object Number is: 3

 

    5) ossutil ls oss://bucket1 -d

        oss://bucket1/obj1

        oss://bucket1/dir1

        oss://bucket1/sample.txt

        Object and Directory Number is: 3

 

    6) ossutil ls oss://bucket1 -m

        InitiatedTime                  UploadID                          ObjectName

        2017-01-13 03:45:26 +0000 CST  15754AF7980C4DFB8193F190837520BB  oss://bucket1/obj1

        2017-01-13 03:45:25 +0000 CST  3998971ACAF94AD9AC48EAC1988BE863  oss://bucket1/obj2

        2017-01-20 11:16:21 +0800 CST  A20157A7B2FEC4670626DAE0F4C0073C  oss://bucket1/tobj

        UploadID Number is: 3

   

    7) ossutil ls oss://bucket1/obj -m

        InitiatedTime                  UploadID                          ObjectName

        2017-01-13 03:45:26 +0000 CST  15754AF7980C4DFB8193F190837520BB  oss://bucket1/obj1

        2017-01-13 03:45:25 +0000 CST  3998971ACAF94AD9AC48EAC1988BE863  oss://bucket1/obj2

        UploadID Number is: 2

 

    8) ossutil ls oss://bucket1 -a

        LastModifiedTime              Size(B)  StorageClass   ETAG                              ObjectName

        2015-06-05 14:06:29 +0000 CST  201933      Standard   7E2F4A7F1AC9D2F0996E8332D5EA5B41  oss://bucket1/dir1/obj11

        2015-06-05 14:36:21 +0000 CST  201933      Standard   6185CA2E8EB8510A61B3A845EAFE4174  oss://bucket1/obj1

        2016-04-08 14:50:47 +0000 CST 6476984      Standard   4F16FDAE7AC404CEC8B727FCC67779D6  oss://bucket1/sample.txt

        Object Number is: 3

        InitiatedTime                  UploadID                          ObjectName

        2017-01-13 03:45:26 +0000 CST  15754AF7980C4DFB8193F190837520BB  oss://bucket1/obj1

        2017-01-13 03:43:13 +0000 CST  2A1F9B4A95E341BD9285CC42BB950EE0  oss://bucket1/obj1

        2017-01-13 03:45:25 +0000 CST  3998971ACAF94AD9AC48EAC1988BE863  oss://bucket1/obj2

        2017-01-20 11:16:21 +0800 CST  A20157A7B2FEC4670626DAE0F4C0073C  oss://bucket1/tobj

        UploadID Number is: 4

        

    9) ossutil ls oss://bucket1/obj -a

        LastModifiedTime              Size(B)  StorageClass   ETAG                              ObjectName

        2015-06-05 14:36:21 +0000 CST  201933      Standard   6185CA2E8EB8510A61B3A845EAFE4174  oss://bucket1/obj1

        Object Number is: 1

        InitiatedTime                  UploadID                          ObjectName

        2017-01-13 03:45:26 +0000 CST  15754AF7980C4DFB8193F190837520BB  oss://bucket1/obj1

        2017-01-13 03:43:13 +0000 CST  2A1F9B4A95E341BD9285CC42BB950EE0  oss://bucket1/obj1

        2017-01-13 03:45:25 +0000 CST  3998971ACAF94AD9AC48EAC1988BE863  oss://bucket1/obj2

        UploadID Number is: 3

 

    10) ossutil ls oss://bucket1/obj -a -s

        oss://bucket1/obj1

        Object Number is: 1

        UploadID                          ObjectName

        15754AF7980C4DFB8193F190837520BB  oss://bucket1/obj1

        2A1F9B4A95E341BD9285CC42BB950EE0  oss://bucket1/obj1

        3998971ACAF94AD9AC48EAC1988BE863  oss://bucket1/obj2

        UploadID Number is: 3

 

    11) ossutil ls oss://bucket1/obj -a -s --marker=obj1

        Object Number is: 0

        UploadID                          ObjectName

        3998971ACAF94AD9AC48EAC1988BE863  oss://bucket1/obj2

        UploadID Number is: 1

 

    12) ossutil ls oss://bucket1/obj -a -s --limited-num=2

        oss://bucket1/obj1

        Object Number is: 1

        UploadID                          ObjectName

        15754AF7980C4DFB8193F190837520BB  oss://bucket1/obj1

        UploadID Number is: 1

 

    13) ossutil ls oss://bucket1/%e4%b8%ad%e6%96%87 --encoding-type url

        LastModifiedTime                   Size(B)  StorageClass   ETAG                                  ObjectName

        2017-03-17 17:34:40 +0800 CST      8345742      Standard   BBCC8C0954B869B4A6B34D9404C5BCFD      oss://bucket1/中文

        Object Number is: 1

        0.066567(s) elapsed

   

    14) ossutil ls oss://bucket --include "*.avi" --include "*.mp4" --exclude "*.png" --exclude "*.jpg"

        LastModifiedTime                   Size(B)  StorageClass   ETAG                                  ObjectName

        2019-05-30 14:23:51 +0800 CST         1030      Standard   4A902D176BE0EE4224BC196BBB8CCC69      oss://bucket/test.avi

        2019-05-30 14:24:05 +0800 CST         1030      Standard   4A902D176BE0EE4224BC196BBB8CCC69      oss://bucket/test.mp4

        Object Number is: 2

 

    15) ossutil ls oss://bucket --all-versions

 

OPTIONS

 

    -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(該選項值會覆蓋配置文件中的相應設置),非必須設置項。

 

    --proxy-host

        網絡代理服務器的url地址,支持http/https/socks5,比如 https://120.79.128.211:3128, socks5://120.79.128.211:1080

 

    --proxy-user

        網絡代理服務器的用戶名,默認為空

 

    --proxy-pwd

        網絡代理服務器的密碼,默認為空

 

    --retry-times=10

        當錯誤發生時的重試次數,默認值:10,取值范圍:1-500

 

    --loglevel

        日志級別,默認為空,表示不輸出日志文件,可選值為:info|debug,info輸出提示信息日志,debug輸出詳細信息日志(包括http請求和響應信息)

 

    --payer

        請求的支付方式,如果為請求者付費模式,可以將該值設置成"requester"

 

    -s, --short-format

        顯示精簡格式,如果未指定該選項,默認顯示長格式。

 

    -d, --directory

        返回當前目錄下的文件和子目錄,而非遞歸顯示所有子目錄下的所有object。

 

    -m, --multipart

        指定操作的對象為bucket中未完成的Multipart事件,而非默認情況下的object。

 

    -a, --all-type

        指定操作的對象為bucket中的object和未完成的Multipart事件。

 

    --limited-num=-1

        返回結果的最大個數。

 

    --marker

        列舉Buckets時的marker,或列舉objects或Multipart Uploads時的key marker, 或者其他有需要marker的地方。

 

    --upload-id-marker

        列舉Multipart Uploads時的uploadID marker。

 

    --encoding-type

        輸入或者輸出的object名或文件名的編碼方式,目前只支持url encode,即指定該選項時,取值范圍為:url,如果不指定該選項,則表示object名或文件名未經過編碼。bucket名不支持url encode。注意,如果指定了該選項,則形如oss://bucket/object的cloud_url,輸入形式為:oss://bucket/url_encode(object),其中oss://bucket/字符串不需要編碼。

 

    --include

        包含對象匹配模式,如:*.jpg

 

    --exclude

        不包含對象匹配模式,如:*.txt

 

    --all-versions

        表示object所有版本

 

    --version-id-marker

        表示列舉objects所有版本的version id marker


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM