`mc admin bucket quota`

Table of Contents

Description
- Units of Measurement
Examples
Syntax

Examples

Configure a Hard Quota on a Bucket

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.

Configure a First-In First-Out (FIFO) Quota on a Bucket

Use mc admin bucket quota with the --fifo flag to specify a quota with First-In First-Out deletion of content. FIFO quotas prevent the bucket size from growing past the specified limit by deleting the oldest content on the bucket to make room for newer content.

mc admin bucket quota TARGET/BUCKET --fifo LIMIT

Replace TARGET with the alias of a configured MinIO deployment. Replace BUCKET with the name of the bucket on which to set the quota.
Replace LIMIT with the maximum size to which the bucket can grow. For example, to set a limit of 10 Terrabytes, specify 10t. See Units of Measurement for supported units.

Retrieve Bucket Quota Configuration

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 retreive the quota.

Clear Configured Bucket 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.

Syntax

mc admin bucket quota has the following syntax:

mc admin bucket quota TARGET [ARGUMENTS]

mc admin bucket quota supports the following arguments:

TARGET

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.

--hard

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.

--fifo

Sets a maximum limit to the bucket storage size. The MinIO server removes the oldest objects in the bucket to make space for newer objects such that the bucket size remains below the specified limit.

For example, a fifo limit of 10GB would result in removal of the oldest objects in the bucket once it reaches 10GB in size.

See Units of Measurement for supported unit sizes.

--clear: Clears all quotas configured for the bucket.

Suffix	Unit Size
`k`	KB (Kilobyte, 1000 Bytes)
`m`	MB (Megabyte, 1000 Kilobytes)
`g`	GB (Gigabyte, 1000 Megabytes)
`t`	TB (Terrabyte, 1000 Gigabytes)
`ki`	KiB (Kibibyte, 1024 Bites)
`mi`	MiB (Mebibyte, 1024 Kibibytes)
`gi`	GiB (Gibibyte, 1024 Mebibytes)
`ti`	TiB (Tebibyte, 1024 Gibibytes)