du 命令用于列出某存储桶或某文件夹下,每一种存储类型文件的统计信息。统计信息包括不同存储类型的文件总数、每种类型文件的总大小。
注意:
如需使用此命令统计所有对象信息,在您进行 授权策略 时,action 需要设置为
cos:HeadBucket , cos:GetBucket。如需使用此命令统计所有历史版本信息,在您进行 授权策略 时,action 需要设置为
cos:HeadBucket , cos:GetBucketVersioning ,cos:GetBucketObjectVersions。命令格式
./coscli du cos://<bucket-name>[/prefix/] [flag]
du 命令包含以下参数:
参数格式 | 参数用途 | 示例 |
cos://<bucket-name> | 使用桶别名访问:cos://example-alias 使用桶名称访问:cos://examplebucket-1250000000 | |
/prefix/ | 可选参数,指定某一文件夹 | /picture/ |
du 命令包含以下可选 flag:
flag 简写 | flag 全称 | flag 用途 |
-h | --help | 查看该命令的具体用法 |
无 | --include | 包含特定模式的文件 |
无 | --exclude | 排除特定模式的文件 |
无 | --all-versions | 统计对象的所有版本数据,仅当 bucket 开启版本控制后可用,统计信息增加显示 DeleteMarker 数量 |
说明
--include 和 --exclude 支持标准正则表达式的语法,您可以使用它来过滤出符合特定条件的文件。使用 zsh 时,您可能需要在 pattern 串的两端加上双引号。
./coscli du cos://bucket1/picture/ --include ".*\\.mp4$"
关于此命令的其他通用选项(例如切换存储桶、切换用户账号等),请参见 通用选项 文档。
操作示例
列出 bucket1存储桶内文件的统计信息
./coscli du cos://bucket1
返回的结果示例如下,输出的信息包括:该桶各存储类型下的对象数量和大小、桶内对象总数、桶内对象总容量。
STORAGE CLASS | OBJECTS COUNT | TOTAL SIZE--------------------------+---------------+-------------STANDARD | 2 | 164 BSTANDARD_IA | 0 | 0 BINTELLIGENT_TIERING | 0 | 0 BARCHIVE | 0 | 0 BDEEP_ARCHIVE | 0 | 0 BMAZ_STANDARD | 0 | 0 BMAZ_STANDARD_IA | 0 | 0 BMAZ_INTELLIGENT_TIERING | 0 | 0 BMAZ_ARCHIVE | 0 | 0 B--------------------------+---------------+-------------INFO[2022-12-14 17:35:41] Total Objects Count: 2INFO[2022-12-14 17:35:41] Total Objects Size: 164 B
列出 bucket1存储桶 picture 文件夹下文件的统计信息
./coscli du cos://bucket1/picture/
列出 bucket1存储桶 picture 文件夹下所有 .mp4 类型文件的统计信息
./coscli du cos://bucket1/picture/ --include ".*\\.mp4$"
列出 bucket1存储桶 picture 文件夹下所有非 .md 类型文件的统计信息
./coscli du cos://bucket1/picture/ --exclude ".*\\.md$"
列出 bucket1存储桶内文件及所有历史版本的统计信息
./coscli du cos://bucket1 --all-versions
返回的结果示例如下,输出的信息包括:该桶各存储类型下的对象数量和大小、桶内对象总数、桶内对象总容量。
STORAGE CLASS | OBJECTS COUNT | TOTAL SIZE--------------------------+---------------+-------------STANDARD | 545 | 1.14 MBSTANDARD_IA | 0 | 0 BINTELLIGENT_TIERING | 0 | 0 BARCHIVE | 0 | 0 BDEEP_ARCHIVE | 13 | 11.74 KBMAZ_STANDARD | 0 | 0 BMAZ_STANDARD_IA | 0 | 0 BMAZ_INTELLIGENT_TIERING | 0 | 0 BMAZ_ARCHIVE | 0 | 0 B--------------------------+---------------+-------------INFO[2025-02-25 17:36:36] Total Objects Count: 558INFO[2025-02-25 17:36:36] Total Objects Size: 1.15 MBINFO[2025-02-25 17:36:36] Total DeleteMarker Count: 501