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 | / | 以人類可讀方式輸出資訊。檔案大小轉換成K|M|G|T|P 尾碼格式。 |
--include | stringArray | 路徑或檔案名稱的包含規則。 |
--include-from | stringArray | 從規則檔案裡讀取包含規則。 |
--list-objects | / | 使用ListObjects介面列舉對象。 |
--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 | 僅擷取修改時間在指定時間間隔前的檔案,預設單位是秒,可以使用單位尾碼形式。例如 1h,表示1小時。 說明
|
--max-age | Duration | 僅擷取修改時間在指定時間間隔內的檔案,預設單位是秒,可以使用單位尾碼形式。例如 1h,表示1小時。 說明
|
--min-mtime | Time | 僅擷取修改時間在指定時間之後的檔案,時間格式:UTC時間。例如2006-01-02T15:04:05。 說明
|
--max-mtime | Time | 僅擷取修改時間在指定時間之前的檔案,時間格式:UTC時間,例如 2006-01-02T15:04:05。 |
--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