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(Archive Storage),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