ls(列舉賬號級別下的資源)
當您需要對賬號下的OSS資源進行查詢并管理時,例如查詢并刪除占用空間比較大的文件,您可以通過ls命令列舉當前賬號下的存儲空間(Bucket)、對象(Object)和碎片(Part)信息。
注意事項
要列舉Bucket,您必須具有
oss:ListBuckets
權(quán)限。要列舉Object,您必須具有
oss:ListObjects
權(quán)限。要列舉Object的所有版本,您必須具有
oss:ListObjectVersions
權(quán)限。要列舉所有Part,您必須具有
oss:ListParts
和oss:ListMultipartUploads
權(quán)限。
具體操作,請參見為RAM用戶授權(quán)自定義的權(quán)限策略。
命令格式
ossutil ls [oss://bucket[/prefix]] [flags]
局部選項 | 類型 | 說明 |
--all-versions | / | 表示對象的所有版本。 |
-d, --dirs | / | 返回當前目錄下的文件和子目錄,而非遞歸顯示所有子目錄下的所有文件。 |
--encoding-type | string | 輸入的對象名或文件名的編碼方式,取值:url。 |
--end-with | string | 按字母排序,返回設(shè)定值之前的對象。 |
--exclude | stringArray | 路徑或文件名的排除規(guī)則。 |
--exclude-from | stringArray | 從規(guī)則文件里讀取排除規(guī)則。 |
--files-from | stringArray | 從文件中讀取源文件名列表,忽略空行或注釋行。 |
--files-from-raw | stringArray | 從文件中讀取源文件名列表。 |
--filter | stringArray | 路徑或文件名過濾規(guī)則。 |
--filter-from | stringArray | 從規(guī)則文件讀取過濾規(guī)則。 |
-f, --force | / | 強制操作,不進行詢問提示。 |
--include | stringArray | 路徑或文件名的包含規(guī)則。 |
--include-from | stringArray | 從規(guī)則文件里讀取包含規(guī)則。 |
--limited-num | int | 返回結(jié)果的最大個數(shù)。 |
--list-objects | / | 使用ListObjects接口列舉對象。 |
--max-age | Duration | 不傳輸任何比此更早的文件。默認是秒,或單位后綴形式 ms|s|m|h|d|w|M|y(默認值off)。 |
--max-mtime | Time | 不傳輸任何比此更新的文件,UTC時間格式(默認值off)。 |
--max-size | SizeSuffix | 限制傳輸?shù)淖畲笪募笮。J是字節(jié),或單位后綴形式B|K|M|G|T|P,1K(KiB)=1024B。 |
--metadata-exclude | stringArray | 對象元數(shù)據(jù)的排除規(guī)則。 |
--metadata-filter | stringArray | 對象元數(shù)據(jù)過濾規(guī)則。 |
--metadata-filter-from | stringArray | 從規(guī)則文件讀取對象元數(shù)據(jù)過濾規(guī)則。 |
--metadata-include | stringArray | 對象元數(shù)據(jù)的包含規(guī)則。 |
--min-age | Duration | 不傳輸任何比此更新的文件,默認是秒,或單位后綴形式 ms|s|m|h|d|w|M|y(默認值off)。 |
--min-mtime | Time | 不傳輸任何比此更早的文件,UTC時間格式 (默認值off)。 |
--min-size | SizeSuffix | 限制傳輸?shù)淖钚∥募笮。J是字節(jié),或單位后綴形式B|K|M|G|T|P,1K(KiB)=1024B。 |
--multipart | / | 指定操作的對象為存儲空間中未完成的分片事件。 |
--page-size | int | 返回對象或文件的最大數(shù)(默認值1000),取值范圍1~1000。 |
-r, --recursive | / | 遞歸進行操作。當指定該選項時,命令會對存儲空間下所有符合條件的對象進行操作, 否則只對路徑指定的對象進行操作。 |
--request-payer | string | 請求的支付方式,如果為請求者付費模式,請設(shè)置該值。取值:requester。 |
--short-format | / | 顯示精簡格式,如果未指定該選項,默認顯示長格式。 |
--start-after | string | 按字母排序,返回設(shè)定值之后的對象。 |
--resource-group-id | string | 指定資源組的ID。 |
關(guān)于支持的全局命令行選項,請參見支持的全局命令行選項。
使用示例
列舉所有存儲空間。
ossutil ls
列舉存儲空間examplebucket下的所有對象。
ossutil ls oss://examplebucket
列舉存儲空間examplebucket下,指定前綴dir下的所有對象。
ossutil ls oss://examplebucket/dir
列舉存儲空間examplebucket下,指定前綴dir、當前目錄下的所有對象。
ossutil ls oss://examplebucket/dir -d
列舉存儲空間examplebucket下,指定前綴dir下前100個對象。
ossutil ls oss://examplebucket/dir --limited-num 100
列舉存儲空間examplebucket下,根目錄dir1和dir2下的所有后綴為.txt的文件。
ossutil ls oss://examplebucket/ --include "/dir1/**.txt" --include "/dir2/**.txt"
列舉存儲空間examplebucket下, 根目錄dir1和dir2目錄最近三天生成的所有文件。
ossutil ls oss://examplebucket --include "/dir1/**" --include "/dir2/**" --max-age 3d
列舉所有的存儲空間,按照JSON格式輸出。
ossutil ls --output-format json