du命令用于獲取指定存儲空間(Bucket)、文件目錄下包含的所有Object的大小。
注意事項
要獲取當前版本所有Object的大小,您需要具有oss:ListObjects
、oss:ListParts
和oss:ListMultipartUploads
權限;要獲取所有版本Object大小,您需要具有oss:ListObjectVersions
、oss:ListParts
和oss:ListMultipartUploads
權限。具體操作,請參見為RAM用戶授權自定義的權限策略。
命令格式
ossutil du oss://bucket[/prefix] [flags]
參數 | 類型 | 說明 |
prefix | string | Bucket下的某個文件目錄或指定前綴。 |
--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 | / | 強制操作,不進行詢問提示。 |
--human-readable | / | 以人類可讀方式輸出信息。文件大小轉成 Ki|Mi|Gi|Ti|Pi 后綴格式。 |
--include | stringArray | 路徑或文件名的包含規則。 |
--include-from | stringArray | 從規則文件里讀取包含規則。 |
--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。 |
--page-size | int | 返回對象或文件的最大數(默認值1000),取值范圍1~1000。 |
-r, --recursive | / | 遞歸進行操作。當指定該選項時,命令會對存儲空間下所有符合條件的對象進行操作,否則只對路徑指定的對象進行操作。 |
--request-payer | string | 請求的支付方式,如果為請求者付費模式,請設置該值。取值:requester。 |
--start-after | string | 按字母排序,返回設定值之后的對象,不包含設定值。 |
關于支持的全局命令行選項,請參見支持的全局命令行選項。
使用示例
查詢examplebucket內的文件大小。
ossutil du oss://examplebucket
以下輸出結果表明examplebucket內共有13個Object,其中12個Object的存儲類型為Standard(標準存儲),1個Object為Archive(歸檔存儲),Object總大小為132116024字節。
storage class object count sum size ---------------------------------------------------------- Standard 12 132115210 Archive 1 814 ---------------------------------------------------------- total object count: 13 total object sum size: 132116024 total part count: 0 total part sum size: 0 total du size:132116024 0.382978(s) elapsed
查詢examplebucket內desfolder文件夾的文件大小。
ossutil du oss://examplebucket/desfolder
以下輸出結果表明examplebucket內共有4個存儲類型為Standard(標準存儲)的Object,Object總大小為92927字節。
storage class object count sum size ---------------------------------------------------------- Standard 4 92927 ---------------------------------------------------------- total object count: 4 total object sum size: 92927 total part count: 0 total part sum size: 0 total du size:92927 0.350440(s) elapsed
查詢examplebucket內desfolder文件夾中包含.jpg后綴的文件大小。
ossutil du oss://examplebucket/desfolder --include *.jpg
以下輸出結果表明examplebucket內共有1個存儲類型為Standard(標準存儲)的Object,Object總大小為92884字節。
storage class object count sum size ---------------------------------------------------------- Standard 1 92884 ---------------------------------------------------------- total object count: 1 total object sum size: 92884 total part count: 0 total part sum size: 0 total du size:92884 0.381506(s) elapsed
查詢examplebucket內desfolder文件夾的文件大小,輸出方式為JSON。
ossutil du oss://examplebucket/desfolder --output-format json
以下輸出結果表明examplebucket內共有4個存儲類型為Standard(標準存儲)的Object,Object總大小為92927字節。
{ "ObjectCount": 4, "ObjectSize": 92927, "StandardObjectCount": 4, "StandardObjectSize": 92927, "Storage": 92927 } 0.508607(s) elapsed