minio/docs
1
0
Fork 0
mirror of https://github.com/minio/docs.git synced 2025-08-08 01:43:18 +03:00
Code Activity
Files
relax-event-restriction
docs/source/reference/minio-mc/mc-du.rst
Ravind Kumar 76e5e35ab3 DOCS-1191: Updating SSE params, general fixups (#1295) 
Closes #1191 

# Summary

Finally getting around to this mc release

- Added docs for enc-c, enc-s3, enc-kms
- Some docs are making assumptions around behavior that needs to be
fixed _first_
- Drive-by linker fixes

Staged: http://192.241.195.202:9000/staging/DOCS-1191/linux/index.html

---------

Co-authored-by: Andrea Longo <feorlen@users.noreply.github.com>
Co-authored-by: Daryl White <53910321+djwfyi@users.noreply.github.com>
2024-08-26 11:54:49 -04:00

4.9 KiB
Raw Permalink Blame History

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]             \
                 [--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.

--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