duコマンドを使用してオブジェクトサイズを照会します。 - Object Storage Service

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

使用上の注意

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

コマンド構文

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

パラメーター	データ型	説明
prefix	String	オブジェクトが格納されているディレクトリ、またはオブジェクトの名前のプレフィックス。
-すべてのバージョン	/	コマンドが指定したオブジェクトのすべてのバージョンの合計サイズを照会するように指定します。
-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-age	有効期間	最終変更時刻が -- max-ageパラメーターの値より前のオブジェクトを転送しないように指定します。デフォルトの単位は秒です。単位は、ミリ秒、秒、分、時間、日、週、月、または年とすることができる。デフォルトでは、このパラメータは空のままです。
-- max-mtime	時間	最終変更時刻が -- max-mtimeパラメーターの値より後のオブジェクトを転送しないように指定します。値はUTCです。デフォルトでは、このパラメータは空のままです。
--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	有効期間	最終変更時刻が -- min-ageパラメーターの値より後のオブジェクトを転送しないように指定します。デフォルトの単位は秒です。単位は、ミリ秒、秒、分、時間、日、週、月、または年とすることができる。デフォルトでは、このパラメータは空のままです。
-- min-mtime	時間	最終変更時刻が -- min-mtimeパラメーターの値より前のオブジェクトを転送しないように指定します。値はUTCです。デフォルトでは、このパラメータは空のままです。
--min-size	SizeSuffix	転送できるオブジェクトの最小サイズを指定します。デフォルトの単位はバイトです。オブジェクトサイズの単位は、バイト、KiB、MiB、GiB、TiB、またはPiBです。注: 1 KiB = 1024バイト。
--page-size	int	返されるオブジェクトの最大数。デフォルト値は 1000 です。有効な値: 1 ~ 1000
-r, -- recursive	/	コマンドがオブジェクトに対して再帰的に実行されることを指定します。このパラメーターを指定すると、バケット内の条件を満たすすべてのオブジェクトに対してコマンドが有効になります。それ以外の場合、コマンドは指定されたパス内のオブジェクトに対してのみ有効になります。
-- request-payer	String	リクエストの支払者を指定します。 pay-by-requesterがバケットに対して有効になっている場合、このパラメーターをrequesterに設定します。
-- start-after	String	-- start-afterパラメーターの値の後に名前がアルファベット順であるオブジェクトが返されることを指定します。

説明

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

例

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

ossutil du oss:// examplebucket

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

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

次の出力は、名前に含まれる1つのStandardオブジェクトを示します。jpgサフィックスは、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
```