mc quota set
Changed in version RELEASE.2022-12-13T00-23-28Z: mc quota set replaced mc admin bucket quota --hard.
Changed in version RELEASE.2024-07-31T15-58-33Z: mc quota set is deprecated.
Description
The mc quota set assigns a hard quota limit to a bucket beyond which MinIO does not allow writes.
Units of Measurement
The mc quota set --size flag accepts the following case-insensitive suffixes to represent the unit of the specified size value:
Suffix |
Unit Size |
|---|---|
|
KB (Kilobyte, 1000 Bytes) |
|
MB (Megabyte, 1000 Kilobytes) |
|
GB (Gigabyte, 1000 Megabytes) |
|
TB (Terabyte, 1000 Gigabytes) |
|
KiB (Kibibyte, 1024 Bites) |
|
MiB (Mebibyte, 1024 Kibibytes) |
|
GiB (Gibibyte, 1024 Mebibytes) |
|
TiB (Tebibyte, 1024 Gibibytes) |
Omitting a suffix defaults to bytes.
Examples
Configure a Hard Quota on a Bucket
Use mc quota set with the --size flag to specify a hard quota on a bucket.
Hard quotas prevent the bucket size from growing past the specified limit.
mc quota set TARGET/BUCKET --size LIMIT
Replace
TARGETwith thealiasof a configured MinIO deployment. ReplaceBUCKETwith the name of the bucket on which to set the hard quota.Replace
LIMITwith the maximum size to which the bucket can grow as an integer and, as desired, a suffix. For example, to set a hard limit of 10 Terabytes, specify10t.
Syntax
mc quota set has the following syntax:
mc quota set TARGET --size LIMIT
mc quota set supports the following arguments:
- TARGET
- Required
The full path to the bucket for which the command creates the quota. Specify the
aliasof the MinIO deployment as a prefix to the path. For example:mc quota set play/mybucket --size 10Gi
- --size
- Required
Sets a maximum limit to the bucket storage size. The MinIO server rejects any incoming
PUTrequest whose contents would exceed the bucket’s configured quota.For example, a hard limit of
10Gwould prevent adding any additional objects if the bucket reaches 10 gigabytes of size.
Global Flags
This command supports any of the global flags.
S3 Compatibility
The mc commandline tool is built for compatibility with the AWS S3 API and is tested with MinIO and AWS S3 for expected functionality and behavior.
MinIO provides no guarantees for other S3-compatible services, as their S3 API implementation is unknown and therefore unsupported. While mc commands may work as documented, any such usage is at your own risk.
