minio/docs
1
0
Fork 0
mirror of https://github.com/minio/docs.git synced 2025-07-28 19:42:10 +03:00
Code Activity
Files
rename
docs/source/reference/deprecated/mc-admin-bucket-quota.rst
Andrea Longo 091a321e32 Improve mc deprecated reference: cleanup, move mc admin top (#1019) 
First batch of mc deprecation cleanup:

[x] Reorder section TOC: `mc` alphabetical, then `mc admin`
alphabetical.
[x] Standardize deprecation notice format and wording.
[x] Move `mc admin top` to deprecated section.

Staged

http://192.241.195.202:9000/staging/DOCS-896-cleanup-mc-admin-top/linux/reference/minio-mc-deprecated.html

Partially addresses https://github.com/minio/docs/issues/896
2023-10-05 10:29:02 -06:00

4.2 KiB
Raw Permalink Blame History

mc admin bucket quota

minio

Table of Contents

mc admin bucket quota

RELEASE.2022-12-13T00-23-28Z

mc admin bucket quota replaced by:

  • mc quota set
  • mc quota info
  • mc quota clear

Description

The mc admin bucket quota command manages per-bucket storage quotas.

Use mc admin on MinIO Deployments Only

Units of Measurement

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

Omitting the suffix defaults to bytes.

Examples

Configure a Hard Quota on a Bucket

Use mc admin bucket quota with the ~mc admin bucket quota --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 <mc 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 mc-admin-bucket-quota-units 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 <mc alias> of a configured MinIO deployment. Replace BUCKET with the name of the bucket on which to retrieve the quota.

Clear Configured Bucket Quota

Use mc admin bucket quota with the ~mc admin bucket quota --clear flag to clear all quotas from a bucket.

mc admin bucket quota TARGET/BUCKET --clear
  • Replace TARGET with the alias <mc 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 <mc 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 mc-admin-bucket-quota-units for supported unit sizes.

--clear

Clears all quotas configured for the bucket.