全部產品
Search
文件中心

Object Storage Service:ls(列舉帳號層級下的資源)

更新時間:Aug 01, 2024

當您需要對帳號下的OSS資源進行查詢並管理時,例如查詢並刪除佔用空間比較大的檔案,您可以通過ls命令列舉當前帳號下的儲存空間(Bucket)、對象(Object)和片段(Part)資訊。

注意事項

  • 要列舉Bucket,您必須具有oss:ListBuckets許可權;要列舉Object,您必須具有oss:ListObjects許可權;要列舉Object的所有版本,您必須具有oss:ListObjectVersions許可權;要列舉所有Part,您必須具有oss:ListPartsoss:ListMultipartUploads許可權。具體操作,請參見為RAM使用者授權自訂的權限原則

命令格式

ossutil ls [oss://bucket[/prefix]] [flags]

局部選項

類型

說明

--all-versions

/

表示對象的所有版本。

-d, --dirs

/

返回目前的目錄下的檔案和子目錄,而非遞迴顯示所有子目錄下的所有檔案。

--encoding-type

string

輸入的對象名或檔案名稱的編碼方式,取值:url。

--end-with

string

按字母排序,返回設定值之前的對象。

--exclude

stringArray

路徑或檔案名稱的排除規則。

--exclude-from

stringArray

從規則檔案裡讀取排除規則。

--files-from

stringArray

從檔案中讀取源檔案名稱列表,忽略空行或注釋行。

--files-from-raw

stringArray

從檔案中讀取源檔案名稱列表。

--filter

stringArray

路徑或檔案名稱過濾規則。

--filter-from

stringArray

從規則檔案讀取過濾規則。

-f, --force

/

強制操作,不進行詢問提示。

--include

stringArray

路徑或檔案名稱的包含規則。

--include-from

stringArray

從規則檔案裡讀取包含規則。

--limited-num

int

返回結果的最大個數。

--list-objects

/

使用ListObjects介面列舉對象。

--max-age

Duration

不傳輸任何比此更早的檔案。預設是秒,或單位尾碼形式 ms|s|m|h|d|w|M|y(預設值off)。

--max-mtime

Time

不傳輸任何比此更新的檔案,UTC時間格式(預設值off)。

--max-size

SizeSuffix

限制傳輸的最大檔案大小,預設是位元組,或單位尾碼形式B|K|M|G|T|P,1K(KiB)=1024B。

--metadata-exclude

stringArray

對象中繼資料的排除規則。

--metadata-filter

stringArray

對象中繼資料過濾規則。

--metadata-filter-from

stringArray

從規則檔案讀取對象中繼資料過濾規則。

--metadata-include

stringArray

對象中繼資料的包含規則。

--min-age

Duration

不傳輸任何比此更新的檔案,預設是秒,或單位尾碼形式 ms|s|m|h|d|w|M|y(預設值off)。

--min-mtime

Time

不傳輸任何比此更早的檔案,UTC時間格式 (預設值off)。

--min-size

SizeSuffix

限制傳輸的最小檔案大小,預設是位元組,或單位尾碼形式B|K|M|G|T|P,1K(KiB)=1024B。

--multipart

/

指定操作的對象為儲存空間中未完成的分區事件。

--page-size

int

返回對象或檔案的最大數(預設值1000),取值範圍1~1000。

-r, --recursive

/

遞迴進行操作。當指定該選項時,命令會對儲存空間下所有合格對象進行操作, 否則只對路徑指定的對象進行操作。

--request-payer

string

請求的支付方式,如果為要求者付費模式,請設定該值。取值:requester。

--short-format

/

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

--start-after

string

按字母排序,返回設定值之後的對象。

說明

關於支援的全域命令列選項,請參見支援的全域命令列選項

使用樣本

  • 列舉所有儲存空間。

    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