docs/source/reference/minio-mc/mc-du.rst

mc du

minio

Table of Contents

mc du

Syntax

The mc du command summarizes the disk usage of buckets and folders. You can also use ~mc du against the local filesystem to produce similar results as the du command.

EXAMPLE

The following command prints the disk usage of the mybucket bucket on the myminio MinIO deployment:

mc du play/mybucket

The output resembles the following:

825KiB 3 objects        mybucket

SYNTAX

The mc du command has the following syntax:

mc [GLOBALFLAGS] du              \
                 [--depth]       \
                 [--encrypt-key] \
                 [--recursive]   \
                 [--rewind]      \
                 [--versions]    \
                 ALIAS [ALIAS ...]

Parameters

ALIAS

The alias <alias> of a MinIO deployment and the full path to the folder. For example:

mc du myminio/mybucket

You can specify multiple buckets and folders on the same or different MinIO deployment. For example:

mc du myminio/mybucket myminio/myotherbucket/myfolder

For a folder on a local filesystem, specify the full path to that folder. For example:

mc du ~/data/images

The time required for mc du to complete depends on the size of the target buckets and folders. A large bucket may take some time to generate a disk usage summary.

--depth, d

Print the total for all folders N or fewer levels below the path specified in the command. Default is 0, for the specified path only.

--encrypt-key

Encrypt or decrypt objects using server-side encryption with client-specified keys. Specify key-value pairs as KEY=VALUE.

• Each KEY represents a bucket or object.
• Each VALUE represents the data key to use for encrypting object(s).

Enclose the entire list of key-value pairs passed to ~mc du --encrypt-key in double quotes ".

~mc du --encrypt-key can use the MC_ENCRYPT_KEY environment variable for retrieving a list of encryption key-value pairs as an alternative to specifying them on the command line.

--recursive, r

Recursively print the total for each bucket or child folder.

--rewind

Use ~mc du --rewind and ~mc du --versions together to show the disk usage for those object versions which existed at a specific point in time.

--versions

Use ~mc du --versions and ~mc du --rewind together to show the disk usage for those object versions which existed at a specific point in time.

Global Flags

Examples

View the Disk Usage for a Bucket or Folder

Use mc du to print a summary of the disk usage for a bucket or folder:

mc du ALIAS/PATH

• Replace ALIAS with the alias <mc alias> of the S3-compatible host.
• Replace PATH with the path to the bucket or folder on the S3-compatible host.

View the Disk Usage at a Point-In-Time

Use mc du --rewind to print a summary of disk usage at a specific point-in-time in the past:

mc du --rewind DURATION ALIAS/PATH

• Replace DURATION with the desired point-in-time in the past. For example, specify 30d to show the disk usage 30 days prior to the current date.
• Replace ALIAS with the alias <mc alias> of the S3-compatible host.
• Replace PATH with the path to the bucket or folder on the S3-compatible host.

View the Disk Usage Recursively

Use mc du --recursive to print a summary for each folder recursively:

mc du --recursive ALIAS/PATH

• Replace ALIAS with the alias <mc alias> of the S3-compatible host.
• Replace PATH with the path to the bucket or folder on the S3-compatible host.

Behavior

S3 Compatibility