全部產品
Search

搜尋本產品

    Object Storage Service：使用ls命令列舉帳號下的Bucket、檔案、片段

    文件中心

    Object Storage Service：使用ls命令列舉帳號下的Bucket、檔案、片段

    更新時間：Feb 28, 2024

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

    說明

    本文各命令列樣本均基於Linux 64位系統，其他系統請將命令開頭的./ossutil64替換成對應的Binary名稱。詳情請參見命令列工具ossutil命令參考。

    列舉Bucket

    • 命令格式

      ./ossutil64 ls [-s] [--limited-num] [--marker]

      參數說明如下：

      選項

      說明

      -s

      列舉結果僅返回Bucket的名稱。

      --limited-num

      設定返回結果的最大個數。您可以使用此項結合marker對返回結果進行分頁展示。

      --marker

      列舉名稱字母序排在marker之後的Bucket。

    • 使用樣本

      • 列舉所有Bucket

        ./ossutil64 ls

        或

        ./ossutil64 ls oss://

        以下輸出結果表明已成功列舉當前帳號下所有Bucket，包括Bucket名稱、建立時間、所在地區、儲存類型、數量等資訊。

        2016-10-21 16:18:37 +0800 CST       oss-cn-hangzhou         Archive    oss://examplebucketA
2016-12-01 15:06:21 +0800 CST       oss-cn-hangzhou        Standard    oss://examplebucketB
2016-07-20 10:36:24 +0800 CST       oss-cn-hangzhou              IA    oss://examplebucketC
2016-10-21 17:31:27 +0800 CST       oss-cn-hangzhou         Archive    oss://examplebucketD
Bucket Number is:4
0.252174(s) elapsed

      • 以精簡模式列舉所有Bucket

        ./ossutil64 ls -s

        以下輸出結果表明已成功列舉當前帳號下所有Bucket，僅包含Bucket名稱以及Bucket數量。

        oss://examplebucketA
oss://examplebucketB
oss://examplebucketC
oss://examplebucketD
Bucket Number is:4
0.235104(s) elapsed

      • 列舉字母序排在指定marker為examplebucketA之後的Bucket

        ./ossutil64 ls oss:// --limited-num=2 -s --marker examplebucketA

        以下輸出結果表明已成功列舉examplebucketA之後的2個Bucket。

        2016-12-01 15:06:21 +0800 CST       oss-cn-hangzhou        Standard    oss://examplebucketB
2016-07-20 10:36:24 +0800 CST       oss-cn-hangzhou              IA    oss://examplebucketC
Bucket Number is:2
0.132174(s) elapsed

    列舉Object

    • 命令格式

      ./ossutil64 ls oss://bucketname[/prefix] [-s] [-d] [--limited-num] [--marker] [--include] [--exclude]  [--version-id-marker] [--all-versions]

      參數說明如下：

      選項

      說明

      bucketname

      目標Bucket名稱。

      prefix

      目標Object首碼。當您列舉目標Bucket中指定首碼的Object時添加此項。

      -s

      列舉結果僅返回Object的名稱。

      -d

      僅列舉Object和子目錄，忽略子目錄下的Object。

      --limited-num

      設定返回結果的最大個數。您可以使用此項結合--marker，對返回結果進行分頁展示。

      --marker

      列舉名稱字母排序在marker之後的Object。

      --include

      列舉符合指定條件的Object。

      更多資訊，請參見include和exclude選項。

      --exclude

      列舉不符合指定條件的Object。

      更多資訊，請參見include和exclude選項。

      --version-id-marker

      列舉Version ID字母排序在marker之後的Object版本。僅當Bucket開啟版本控制後可用。

      --all-versions

      列舉Object的所有版本，僅當Bucket開啟版本控制後可用。

    • 使用樣本

      • 列舉examplebucket內所有Object

        ./ossutil64 ls oss://examplebucket

        以下輸出結果表明已成功列舉examplebucket內所有Object的資訊，包括檔案最後更新時間（LastModifiedTime）、以位元組為單位統計的檔案大小（Size）、ETag值以及檔案名稱（ObjectName）。

        其中，ETag值用於標識一個Object的內容。對於通過PutObject請求建立的Object，ETag值是其內容的MD5值；對於通過其他方式建立的Object，ETag值是基於一定計算規則產生的唯一值，但不是其內容的MD5值。

        LastModifiedTime                    Size(B)  StorageClass   ETag                                    ObjectName
2020-12-01 15:06:37 +0800 CST           114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://examplebucket/example.txt
2020-12-01 15:06:42 +0800 CST        363812      Standard   E7581E5D2EBC56ECCB6FB6050B4C6545        oss://examplebucket/examplefolder/photo.jpg
2020-12-01 15:06:45 +0800 CST      57374182      Standard   BE97B7AD7A2C1277B11221E5C9537544        oss://examplebucket/video.mp4
Object Number is:3
0.007379(s) elapsed

      • 列舉examplebucket內首碼為example的Object

        ./ossutil64 ls oss://examplebucket/example

        以下輸出結果表明已成功列舉examplebucket內所有首碼為example的Object。

        LastModifiedTime                    Size(B)  StorageClass   ETag                                     ObjectName
2020-12-01 15:06:37 +0800 CST           114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://examplebucket/example.txt
2020-12-01 15:06:42 +0800 CST        363812      Standard   E7581E5D2EBC56ECCB6FB6050B4C6545        oss://examplebucket/examplefolder/photo.jpg
Object Number is:2
0.007379(s) elapsed

      • 列舉examplebucket內所有尾碼名為.mp4的檔案

        ./ossutil64 ls oss://examplebucket --include *.mp4

        以下輸出結果表明已成功列舉examplebucket內所有尾碼名為.mp4的檔案。

        LastModifiedTime                    Size(B)  StorageClass   ETag                                     ObjectName
2020-12-01 15:06:45 +0800 CST      57374182      Standard   BE97B7AD7A2C1277B11221E5C9537544        oss://examplebucket/video.mp4
Object Number is:1
0.007379(s) elapsed

      • 僅列舉examplebucket根目錄下Object和子目錄

        ./ossutil64 ls oss://examplebucket -d

        以下輸出結果表明已成功列舉examplebucket根目錄下Object和子目錄。

        oss://examplebucket/example.txt
oss://examplebucket/examplefolder/
oss://examplebucket/video.mp4
Object and Directory Number is: 3

0.278489(s) elapsed

      • 列舉examplebucket內所有Object的所有版本 

        ./ossutil64 ls oss://examplebucket --all-versions

        以下輸出結果表明已成功列舉examplebucket內所有Object的所有版本。

        LastModifiedTime                   Size(B)  StorageClass   ETag                                   VERSIONID                                                           IS-LATEST   DELETE-MARKER   ObjectName
2020-12-01 15:06:37 +0800 CST         114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB      CAEQARiBgICUsOuR2hYiIDI3NWVjNmEyYmM0NTRkZWNiMTkxY2VjMDMwZjFlMDA3    true        false           oss://examplebucket/example.txt
2020-06-11 11:03:37 +0800 CST      363812      Standard   E7581E5D2EBC56ECCB6FB6050B4C6545      CAEQARiBgIDZtvuR2hYiIDNhYjRkN2M5NTA5OTRlN2Q4YTYzODQwMzQ4NDYwZDdm    true        false           oss://examplebucket/examplefolder/photo.jpg
2021-01-26 13:27:08 +0800 CST           0                                                       CAEQLxiBgIDd7NH0uRciIDA3Yzg0MTZjOWNlYzQ4ODZhMzVkZWE0MmE2NzBlYTYx    true        true            oss://examplebucket/image.png
2020-12-01 15:06:45 +0800 CST    57374182      Standard   BE97B7AD7A2C1277B11221E5C9537544      CAEQLBiBgMDZiprwthciIDY2NGM0NTNmZDE3ODRmZmVhZGM4YTUwZGQyNGU3ZjQ3    true        false           oss://examplebucket/video.mp4
2016-06-11 10:53:46 +0800 CST      118076      Standard   FFDB300F053AAF06F4C4C58A4869C427      CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk    false       false           oss://examplebucket/example.txt
2016-06-11 11:02:05 +0800 CST      345374      Standard   078A9852BCF81DC4811E6EDCBFD121BE      CAEQARiBgICNz_iR2hYiIGJjZTBjNDQxYWRhNTQ2ZTNiNmMzYzQ1YzMzMDA5ZjUw    false       false           oss://examplebucket/examplefolder/photo.jpg
Object Number is: 6

0.692000(s) elapsed

      • 列舉examplebucket根目錄下example.txt的所有版本

        ./ossutil64 ls oss://examplebucket/example.txt --all-versions

        以下輸出結果表明已成功列舉example.txt的所有版本。

        LastModifiedTime                   Size(B)  StorageClass  ETag                                   VERSIONID                                                           IS-LATEST   DELETE-MARKER  ObjectName
2020-12-01 15:06:37 +0800 CST         114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB      CAEQARiBgICUsOuR2hYiIDI3NWVjNmEyYmM0NTRkZWNiMTkxY2VjMDMwZjFlMDA3    true        false           oss://examplebucket/example.txt
2016-06-11 10:53:46 +0800 CST         114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB      CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk    false       false           oss://examplebucket/example.txt
Object Number is: 2

0.361000(s) elapsed

    列舉Part

    • 命令格式

      ./ossutil64 ls oss://bucketname[/prefix] [-s] [-d] [-m] [-a] [--limited-num] [--upload-id-marker]

      參數說明如下：

      選項

      說明

      bucketname

      目標Bucket名稱。

      當您需要列舉指定Bucket中的Object時添加此項。

      prefix

      列舉指定首碼下的Part。

      -s

      列舉結果僅返回UploadID和Object名稱。

      -d

      列舉Object和子目錄，忽略子目錄下的Object。

      -m

      列舉Part。

      -a

      列舉Object和Part。

      --limited-num

      設定返回結果的最大個數。您可以使用此項結合--upload-id-marker對返回結果進行分頁展示。

      --upload-id-marker

      列舉Upload ID字母排序在marker之後的Part。

    • 使用樣本

      • 列舉examplebucket內所有Part

        ./ossutil64 ls oss://examplebucket -m

        以下輸出結果表明已成功列舉examplebucket內所有Part。

        InitiatedTime                     UploadID                           ObjectName
2017-01-13 03:45:26 +0000 CST     15754AF7980C4DFB8193F190837520BB    oss://examplebucket/test.mp4
2017-01-13 03:45:13 +0000 CST     2A1F9B4A95E341BD9285CC42BB950EE0    oss://examplebucket/test.mp4
2017-01-13 03:45:01 +0000 CST     3998971ACAF94AD9AC48EAC1988BE863    oss://examplebucket/test.mp4
2017-01-20 11:16:21 +0800 CST     A20157A7B2FEC4670626DAE0F4C0073C    oss://examplebucket/object.exe
UploadId Number is:4
0.191289(s) elapsed

      • 列舉examplebucket內所有Object和Part

        ./ossutil64 ls oss://examplebucket -a

        以下輸出結果表明已成功列舉examplebucket內所有Object和Part。

        LastModifiedTime                    Size(B)  StorageClass   ETag                                     ObjectName
2020-12-01 15:06:37 +0800 CST           114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://examplebucket/example.txt
2020-12-01 15:06:42 +0800 CST        363812      Standard   E7581E5D2EBC56ECCB6FB6050B4C6545        oss://examplebucket/examplefolder/photo.jpg
2020-12-01 15:06:45 +0800 CST      57374182      Standard   BE97B7AD7A2C1277B11221E5C9537544        oss://examplebucket/video.mp4
Object Number is:3
InitiatedTime                     UploadID                           ObjectName
2017-01-13 03:45:26 +0000 CST     15754AF7980C4DFB8193F190837520BB    oss://examplebucket/test.mp4
2017-01-13 03:45:13 +0000 CST     2A1F9B4A95E341BD9285CC42BB950EE0    oss://examplebucket/test.mp4
2017-01-13 03:45:01 +0000 CST     3998971ACAF94AD9AC48EAC1988BE863    oss://examplebucket/test.mp4
2017-01-20 11:16:21 +0800 CST     A20157A7B2FEC4670626DAE0F4C0073C    oss://examplebucket/object.exe
UploadId Number is:4
0.791289(s) elapsed

    通用選項

    當您需要通過命令列工具ossutil切換至另一個地區的Bucket時，可以通過-e選項指定該Bucket所屬的Endpoint。當您需要通過命令列工具ossutil切換至另一個阿里雲帳號下的Bucket時，可以通過-i選項指定該帳號的AccessKey ID，並通過-k選項指定該帳號的AccessKey Secret。

    例如您需要列舉另一個阿里雲帳號下，華東1（杭州）名為test的Bucket內所有檔案，命令如下：

    ./ossutil64 ls oss://test -e oss-cn-hangzhou.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA****  -k 67DLVBkH7EamOjy2W5RVAHUY9H****

    關於此命令的其他通用選項的更多資訊，請參見通用選項。