如何使用du命令擷取檔案大小 - Object Storage Service

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
```