すべてのプロダクト
Search

このプロダクト

    Object Storage Service:du

    ドキュメントセンター

    Object Storage Service:du

    最終更新日:Jun 18, 2025

    du コマンドを使用して、バケットまたはディレクトリ内のすべてのオブジェクトの合計サイズを照会できます。

    使用方法

    バケットまたはディレクトリ内のすべての現行バージョンのオブジェクトの合計サイズを照会するには、oss:ListObjects、oss:ListParts、および oss:ListMultipartUploads 権限が必要です。 バケットまたはディレクトリ内のすべてのバージョンのオブジェクトの合計サイズを照会するには、oss:ListObjectVersions、oss:ListParts、および oss:ListMultipartUploads 権限が必要です。 詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。

    コマンド構文

    ossutil du oss://bucket[/prefix] [flags]

    パラメーター

    タイプ

    説明

    prefix

    string

    オブジェクトが格納されているディレクトリ、またはオブジェクト名のプレフィックス。

    --all-versions

    /

    コマンドが指定されたオブジェクトのすべてのバージョンの合計サイズを照会することを指定します。

    -d, --dirs

    /

    現在のディレクトリ内のオブジェクトとサブディレクトリが返されることを指定します。

    --encoding-type

    string

    オブジェクト名のエンコードに使用されるエンコード方式。 有効値: url。

    --end-with

    string

    名前がアルファベット順で --end-with パラメーターの値以前であるオブジェクトが返されることを指定します。

    --exclude

    stringArray

    パスまたはオブジェクト名の除外ルール。

    --exclude-from

    stringArray

    除外ルールがルールファイルから読み取られることを指定します。

    --files-from

    stringArray

    オブジェクト名がルールファイルから読み取られ、空行またはコメント行は無視されることを指定します。

    --files-from-raw

    stringArray

    オブジェクト名がルールファイルから読み取られることを指定します。

    --filter

    stringArray

    パスまたはオブジェクト名のフィルタールール。

    --filter-from

    stringArray

    パスまたはオブジェクト名のフィルタールールがルールファイルから読み取られることを指定します。

    -f, --force

    /

    確認のプロンプトなしでコマンドが強制的に実行されることを指定します。

    --human-readable

    /

    読みやすいようにユーザーフレンドリーな方法で情報が出力されることを指定します。 オブジェクトサイズの単位は、KiB、MiB、GiB、TiB、または PiB にすることができます。

    --include

    stringArray

    パスまたはオブジェクト名の包含ルール。

    --include-from

    stringArray

    包含ルールがルールファイルから読み取られることを指定します。

    --list-objects

    /

    ListObjects オペレーションがオブジェクトをリストするために呼び出されることを指定します。

    --max-size

    SizeSuffix

    転送できるオブジェクトの最大サイズを指定します。 デフォルトの単位はバイトです。 オブジェクトサイズの単位は、バイト、KiB、MiB、GiB、TiB、または PiB にすることができます。 注: 1 KiB = 1024 バイト。

    --metadata-exclude

    stringArray

    オブジェクトメタデータの除外ルール。

    --metadata-filter

    stringArray

    オブジェクトメタデータのフィルタールール。

    --metadata-filter-from

    stringArray

    オブジェクトメタデータのフィルタールールがルールファイルから読み取られることを指定します。

    --metadata-include

    stringArray

    オブジェクトメタデータの包含ルール。

    --min-age

    Duration

    指定された期間の開始後に最終変更されたオブジェクトが除外されることを指定します。 デフォルトの単位は s (秒) です。 数値の後に時間の単位を付けることができます。 たとえば、1h は 1 時間を示します。

    説明

    --min-age 1h は、1 時間前またはそれ以前に変更されたオブジェクトのみが照会されることを指定します。

    --max-age

    Duration

    最終変更時刻が指定された期間内であるオブジェクトのみを照会します。 デフォルトの単位は s (秒) です。 数値の後に時間の単位を付けることができます。 たとえば、1h は 1 時間を示します。

    説明

    --max-age 1h は、過去 1 時間以内に変更されたオブジェクトのみが照会されることを指定します。

    --min-mtime

    Time

    最終変更時刻がこのオプションの値より遅いオブジェクトのみを照会します。 時刻は UTC でなければなりません。 例: 2006-01-02T15:04:05.

    説明

    --min-mtime "2006-01-02T15:04:05" は、2006 年 1 月 2 日 15:04:05 以降に変更されたオブジェクトのみが照会されることを指定します。

    --max-mtime

    Time

    最終変更時刻がこのオプションの値より早いオブジェクトを照会します。 時刻は UTC でなければなりません。 例: 2006-01-02T15:04:05.

    --min-size

    SizeSuffix

    転送できるオブジェクトの最小サイズを指定します。 デフォルトの単位はバイトです。 オブジェクトサイズの単位は、バイト、KiB、MiB、GiB、TiB、または PiB にすることができます。 注: 1 KiB = 1024 バイト。

    --page-size

    int

    バッチモードでページ分割リストを実行するときに、ページごとに返されるオブジェクトの最大数。 有効値: 1 ～ 1000。 デフォルト値: 1000。

    -r, --recursive

    /

    オブジェクトに対してコマンドが再帰的に実行されることを指定します。 このパラメーターを指定すると、コマンドはバケット内の条件を満たすすべてのオブジェクトに有効になります。 そうでない場合、コマンドは指定されたパスのオブジェクトにのみ有効になります。

    --request-payer

    string

    リクエストの支払者を指定します。 バケットでリクエスト者による支払い有効になっている場合は、このパラメーターを requester に設定します。

    --start-after

    string

    名前がアルファベット順で --start-after パラメーターの値より後であるオブジェクトが返されることを指定します。

    説明

    詳細については、「コマンドラインオプション」をご参照ください。

    例

    • examplebucket という名前のバケット内のオブジェクトの合計サイズを照会する

      ossutil du oss://examplebucket

      次の出力は、examplebucket バケットに 13 個のオブジェクト (12 個の標準ストレージオブジェクトと 1 個のアーカイブオブジェクト) が格納されていることを示しています。 オブジェクトの合計サイズは 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 バケットの desfolder ディレクトリに 4 つの標準ストレージオブジェクトが格納されていることを示しています。 オブジェクトの合計サイズは 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

      次の出力は、名前に .jpg サフィックスが含まれる 1 つの標準ストレージオブジェクトが、examplebucket バケットの desfolder ディレクトリに格納されていることを示しています。 オブジェクトの合計サイズは 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 バケットの desfolder ディレクトリに 4 つの標準ストレージオブジェクトが格納されていることを示しています。 オブジェクトの合計サイズは 92927 バイトです。

      {
  "ObjectCount": 4,
  "ObjectSize": 92927,
  "StandardObjectCount": 4,
  "StandardObjectSize": 92927,
  "Storage": 92927
}
0.508607(s) elapsed