全部文档
当前文档
最近更新时间：2025-11-07 15:16:28
du命令用于获取指定桶、目录下包含的所有对象（Object）和碎片（Part）的大小和数量。
以下示例均以Linux为例。
./ks3util du ks3://bucketname[/prefix]
[-m, --multipart]
[-a, --all-type]
[--retention]
[--readable]
[-d, --directory]
[--limited-num <value>]
[--marker <value>]
[--include <value>]
[--exclude <value>]
[--time-range <value>]
[--list-parallel <value>]
[--list-depth <value>]参数 | 说明 |
|---|---|
bucketname | 操作的桶名。 |
prefix | 操作的对象的前缀。 |
-m, --multipart | 指定操作的对象为桶中未完成的Multipart事件，而非默认情况下的Object。 |
-a, --all-type | 指定操作的对象为桶中符合prefix条件的Object和未完成的Multipart事件。 |
--retention | 指定操作的对象为回收站中的Object。使用该选项时，将无法使用--directory/--all-type/--multipart选项。 |
--readable | 以更友好的可读性输出信息，文件大小自适应合适的单位显示。 |
-d, --directory | 指定操作当前目录下的文件，而非递归显示所有子目录下的所有Object或Part。 |
--limited-num | 计算结果的最大个数。 |
--marker | 计算名称字母排序在marker之后的Object或Part。 |
--include | 包含对象匹配模式，满足匹配规则的文件将会被选中，如：*.jpg。 该选项可以出现多次，多个--include规则取并集。 |
--exclude | 不包含对象匹配模式，满足匹配规则的文件将会被排除，如：*.txt。 该选项可以出现多次，多个--exclude规则取并集。 |
--time-range | 时间段匹配模式，仅匹配最后修改时间在该时间段内的文件。时间段格式为：time1-time2，其中time1、time2需要填写UTC时间，格式为：yyyyMMddHHmmss。 详细请参考通用选项&过滤规则文档。 |
--list-parallel | 扫描文件的并发数，默认值：1，取值范围：1-100。 |
--list-depth | 并行扫描的最大深度，超过此深度的目录将不再并行扫描，默认值：1，取值范围：1-100。 假设源目录为prefix/，而该目录存在以下结构： prefix/aa/ prefix/aa/1/、prefix/aa/2/ prefix/bb/ prefix/bb/1/、prefix/bb/2/ 值为 1 代表使用 delimiter=/ 扫描顶层（prefix/），获取到 prefix/aa/，prefix/bb/后，二者不再使用 delimiter=/ 进行扫描。 值为 2 代表获取到 prefix/aa/，prefix/bb/ 后，二者仍使用 delimiter=/ 进行扫描，再得到的结果不再使用 delimiter=/ 进行扫描。 |
1. 除上述的功能参数，关于Util支持的通用选项参数，详情请参考通用选项&过滤规则文档。
2. 获取桶内文件大小和数量需具备ks3:ListBucket权限，获取回收站内文件大小和数量需具备ks3:ListBucketRetention权限，获取未完成分块上传任务的数量和分块大小需具备ks3:ListBucketMultipartUploads、ks3:ListMultipartUploadParts权限。
获取sampleBucket中所有文件的大小和数量
./ks3util du ks3://sampleBucket输出示例
Storage class Object number Object size
---------------------------------------------------------------------------------------------
STANDARD 14000 141516800(byte)
STANDARD_IA 6000 65658880(byte)
---------------------------------------------------------------------------------------------
Total object number: 20000 Total object size: 207175680(byte)
3.758233(s) elapsed获取sampleBucket中所有文件的大小和数量，自适应单位展示文件大小
./ks3util du ks3://sampleBucket --readable输出示例
Storage class Object number Object size
---------------------------------------------------------------------------------------------
STANDARD 14000 134.96MB
STANDARD_IA 6000 62.62MB
---------------------------------------------------------------------------------------------
Total object number: 20000 Total object size: 197.58MB
3.702493(s) elapsed获取sampleBucket中前缀为abc的所有文件的大小和数量
./ks3util du ks3://sampleBucket/abc输出示例
Storage class Object number Object size
---------------------------------------------------------------------------------------------
STANDARD 3400 35256320(byte)
---------------------------------------------------------------------------------------------
Total object number: 3400 Total object size: 35256320(byte)
0.621619(s) elapsed获取sampleBucket中所有文件的大小和数量，设置扫描并发数为5，最大并发扫描深度为1
./ks3util du ks3://sampleBucket --list-parallel 5 --list-depth 1输出示例
Storage class Object number Object size
---------------------------------------------------------------------------------------------
STANDARD 14000 141516800(byte)
STANDARD_IA 6000 65658880(byte)
---------------------------------------------------------------------------------------------
Total object number: 20000 Total object size: 207175680(byte)
3.758233(s) elapsed获取sampleBucket根目录下所有文件的大小和数量
./ks3util du ks3://sampleBucket -d输出示例
Storage class Object number Object size
---------------------------------------------------------------------------------------------
STANDARD 600 6389760(byte)
---------------------------------------------------------------------------------------------
Total object number: 600 Total object size: 6389760(byte)
0.472973(s) elapsed获取sampleBucket中所有未完成分块上传任务的数量和分块总大小
./ks3util du ks3://sampleBucket -m输出示例
Total multipart upload number: 10 Total multipart upload size: 251658240(byte)
0.349222(s) elapsed获取sampleBucket中所有文件的大小和数量、所有未完成分块上传任务的数量和碎片的大小
./ks3util du ks3://sampleBucket -a输出示例
Storage class Object number Object size
---------------------------------------------------------------------------------------------
STANDARD 14000 141516800(byte)
STANDARD_IA 6000 65658880(byte)
---------------------------------------------------------------------------------------------
Total object number: 20000 Total object size: 207175680(byte)
Total multipart upload number: 10 Total multipart upload size: 251658240(byte)
4.047088(s) elapsed获取sampleBucket中对象的key排序在file100后所有文件的大小和数量
./ks3util du ks3://sampleBucket --marker file100输出示例
Storage class Object number Object size
---------------------------------------------------------------------------------------------
STANDARD 9900 101376000(byte)
---------------------------------------------------------------------------------------------
Total object number: 9900 Total object size: 101376000(byte)
1.298945(s) elapsed获取sampleBucket中前1000个文件的大小和数量
./ks3util du ks3://sampleBucket --limited-num 1000输出示例
Storage class Object number Object size
---------------------------------------------------------------------------------------------
STANDARD 1000 10240000(byte)
---------------------------------------------------------------------------------------------
Total object number: 1000 Total object size: 10240000(byte)
0.286927(s) elapsed获取sampleBucket回收站中所有文件的大小和数量
./ks3util du ks3://sampleBucket --retention输出示例
Storage class Retention Object number Retention object size
---------------------------------------------------------------------------------------------
STANDARD 4000 38328320(byte)
STANDARD_IA 3000 35225600(byte)
---------------------------------------------------------------------------------------------
Total retention object number: 7000 Total retention object size: 73553920(byte)
2.871750(s) elapsed获取sampleBucket回收站中前缀为abc的所有文件的大小和数量
./ks3util du ks3://sampleBucket/abc --retention输出示例
Storage class Retention Object number Retention object size
---------------------------------------------------------------------------------------------
STANDARD 3400 35256320(byte)
---------------------------------------------------------------------------------------------
Total retention object number: 3400 Total retention object size: 35256320(byte)
1.121254(s) elapsed获取sampleBucket中最后修改时间在指定范围的文件的大小和数量
./ks3util du ks3://sampleBucket --time-range "20241106120000-20241110120000"输出示例
Storage class Object number Object size
---------------------------------------------------------------------------------------------
STANDARD 600 6389760(byte)
---------------------------------------------------------------------------------------------
Total object number: 600 Total object size: 6389760(byte)
0.472973(s) elapsed纯净模式