中文文档

mc du

语法

mc du 命令总结了存储桶和文件夹的磁盘使用情况。 您还可以对本地文件系统使用 du 命令,以产生类似于 du 命令的结果。

以下命令会打印出在 myminio MinIO部署上 mybucket 存储桶的磁盘使用情况:

mc du play/mybucket

输出类似于以下内容:

825KiB 3 objects        mybucket

mc du 命令的语法如下:

mc [GLOBALFLAGS] du                    \
                 [--depth]             \
                 [--recursive]         \
                 [--rewind]            \
                 [--versions]          \
                 ALIAS [ALIAS ...]
  • 方括号 [] 表示可选参数。

  • 参数在同一行表示它们是相互依赖的。

  • 使用管道 | 运算符分隔的参数是相互排斥的。

在终端/壳中运行命令之前,将示例复制到文本编辑器中并按需进行修改。

参数

ALIAS
Required

MinIO部署的 alias 和文件夹的完整路径。 例如:

mc du myminio/mybucket

您可以指定同一或不同MinIO部署上的多个存储桶和文件夹。 例如:

mc du myminio/mybucket myminio/myotherbucket/myfolder

对于本地文件系统上的一个文件夹,请指定该文件夹的完整路径。 例如:

mc du ~/data/images

mc du 命令完成所需的时间取决于目标存储桶和文件夹的大小。一个大的存储桶可能需要一些时间来生成磁盘使用情况摘要。

--depth, d
Optional

打印指定路径下N或更少层级的所有文件夹的总计。默认值为0,仅针对指定的路径。

--recursive, r
Optional

递归地打印每个存储桶或子文件夹的总计。

--rewind
Optional

指令 mc du 只对在指定时间点存在的 对象版本进行操作。

  • 要回退到过去的特定日期,请将日期指定 为 ISO8601 格式的时间戳。例如: --rewind 2020.03.24T10:00

  • 要回退一段时间,请将持续时间指定为字符串格式, 例如 #d#hh#mm#ss 。例如: --rewind 1d2hh3mm4ss

--rewind 命令要求指定的 ALIAS 是一个支持 桶版本控制 的 S3 兼容服务。 对于 MinIO 部署,使用 mc version 命令来启用或禁用桶版本控制。

使用 --rewind--versions 命令一起,可以显示在特定时间点存在的对象版本的使用磁盘空间情况。

--versions
Optional

指令 mc du 对存储桶中所有的对象版本进行 操作。

--versions 命令要求指定的 ALIAS 是一个支持 桶版本控制 的 S3 兼容服务。 对于 MinIO 部署,使用 mc version 命令来启用或禁用桶版本控制。

使用 --versions--rewind 一起,可以显示在特定时间点存在的对象版本占用的磁盘空间。

全局标记

此命令支持任何 全局标志

示例

查看存储桶或文件夹的磁盘使用情况

使用 mc du 命令来打印一个存储桶或文件夹的磁盘使用情况总结:

mc du ALIAS/PATH
  • ALIAS 替换为 S3 兼容主机的 alias 命令创建的别名。

  • PATH 替换为 S3 兼容主机上存储桶或文件夹的路径。

查看某个时间点的磁盘使用情况

使用 mc du --rewind 命令来打印过去特定时间点的磁盘使用情况总结:

mc du --rewind DURATION ALIAS/PATH
  • DURATION 替换为所需的历史时间点。例如,指定 30d 来显示当前日期前30天的磁盘使用情况。

  • ALIAS 替换为 S3 兼容主机的 alias 命令创建的别名。

  • PATH 替换为 S3 兼容主机上存储桶或文件夹的路径。

Requires Versioning

mc du 需要使用 桶版本控制 来使用此功能。 使用 mc version 命令来为一个桶启用版本控制。

递归查看磁盘使用情况

使用 mc du --recursive 命令来递归地打印每个文件夹的使用情况总结:

mc du --recursive ALIAS/PATH
  • ALIAS 替换为 S3 兼容主机的 alias 命令创建的别名。

  • PATH 替换为 S3 兼容主机上存储桶或文件夹的路径。

行为

S3兼容性

mc 命令行工具是为了与 AWS S3 API 兼容而构建的,并且已经过测试, 以确保在与 MinIO 和 AWS S3 配合使用时,功能和行为符合预期。

MinIO 不对其他 S3 兼容服务提供任何保证,因为它们的 S3 API 实现是 未知的,因此不受支持。尽管 mc 命令 可能 如文档中所 述工作,但任何此类使用都是您自己的风险。

Join Slack 商业支持购买咨询