此工具一般安裝在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