全部產品
Search
文件中心

Object Storage Service:du(擷取大小)

更新時間:Aug 01, 2024

du命令用於擷取指定儲存空間(Bucket)、檔案目錄下包含的所有Object的大小。

注意事項

要擷取目前的版本所有Object的大小,您需要具有oss:ListObjectsoss:ListPartsoss:ListMultipartUploads許可權;要擷取所有版本Object大小,您需要具有oss:ListObjectVersionsoss:ListPartsoss: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