如何使用du命令获取文件大小 - 对象存储 OSS

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（归档存储），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
```