mc admin bucket quota
Table of Contents
The mc admin bucket quota
command manages per-bucket
storage quotas.
Use mc admin
on MinIO Deployments Only
MinIO does not support using mc admin
commands with other
S3-compatible services, regardless of their claimed compatibility with MinIO
deployments.
The mc admin bucket quota --hard
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 (Terrabyte, 1000 Gigabytes) |
|
KiB (Kibibyte, 1024 Bites) |
|
MiB (Mebibyte, 1024 Kibibytes) |
|
GiB (Gibibyte, 1024 Mebibytes) |
|
TiB (Tebibyte, 1024 Gibibytes) |
Omitting the suffix defaults to bytes
.
Use mc admin bucket quota
with the
--hard
flag to specify a hard quota
on a bucket. Hard quotas prevent the bucket size from growing past the specified
limit.
mc admin bucket quota TARGET/BUCKET --hard LIMIT
Replace TARGET
with the alias
of a configured
MinIO deployment. Replace BUCKET
with the name of the bucket on which to
set the hard quota.
Replace LIMIT
with the maximum size to which the bucket can grow.
For example, to set a hard limit of 10 Terrabytes, specify 10t
.
See Units of Measurement for supported units.
Use mc admin bucket quota
to retrieve the current quota configuration
for a bucket:
mc admin bucket quota TARGET/BUCKET
Replace TARGET
with the alias
of a configured
MinIO deployment. Replace BUCKET
with the name of the bucket on which to
retrieve the quota.
Use mc admin bucket quota
with the
--clear
flag to clear all quotas from
a bucket.
mc admin bucket quota TARGET/BUCKET --clear
Replace TARGET
with the alias
of a configured
MinIO deployment. Replace BUCKET
with the name of the bucket on which to
clear the quota.
mc admin bucket quota
has the following syntax:
mc admin bucket quota TARGET [ARGUMENTS]
mc admin bucket quota
supports the following arguments:
The full path to the bucket for which the command creates the quota.
Specify the alias
of the MinIO deployment as a
prefix to the path. For example:
mc admin bucket quota play/mybucket
Omit all other arguments to return the current quota settings for the specified bucket.
Sets a maximum limit to the bucket storage size. The MinIO server rejects any
incoming PUT
request whose contents would exceed the bucket’s configured
quota.
For example, a hard limit of 10GB
would prevent adding any additional
objects if the bucket reaches 10GB
of size.
See Units of Measurement for supported unit sizes.
This work is licensed under a Creative Commons Attribution 4.0 International License.
©2020-Present, MinIO, Inc.