mirror of
https://github.com/minio/docs.git
synced 2025-08-09 13:02:53 +03:00
5865c3b93d
Bucket quotas don't work the way people think they work, as they cannot enforce hard limits. Deprecate in docs while we sort out what to do with the commands. The future replacement is MinIO Enterprise Catalog. Staged: http://192.241.195.202:9000/staging/deprecate-bucket-quota/linux/reference/minio-mc-deprecated.html See: https://github.com/minio/mc/pull/5011 https://github.com/minio/mc/pull/5012
72 lines
2.0 KiB
ReStructuredText
72 lines
2.0 KiB
ReStructuredText
============
|
|
``mc quota``
|
|
============
|
|
|
|
.. default-domain:: minio
|
|
|
|
.. contents:: Table of Contents
|
|
:local:
|
|
:depth: 2
|
|
|
|
.. mc:: mc quota
|
|
|
|
.. versionchanged:: RELEASE.2024-07-31T15-58-33Z
|
|
|
|
``mc quota`` and its subcommands are deprecated.
|
|
|
|
Description
|
|
-----------
|
|
|
|
.. start-mc-quota-desc
|
|
|
|
The :mc:`mc quota` commands configure, display, or remove a quota limit on a bucket.
|
|
|
|
.. end-mc-quota-desc
|
|
|
|
When a bucket with a quota configured reaches the specified limit, as determined by the MinIO object scanner, MinIO rejects further ``PUT`` requests for the bucket.
|
|
|
|
Each time the MinIO :ref:`object scanner <minio-lifecycle-management-scanner>` scans a bucket for pending :ref:`object lifecycle transitions <minio-lifecycle-management>`, it also checks if the bucket has exceeded a configured quota.
|
|
|
|
.. admonition:: Quota enforcement is not immediate
|
|
:class: note
|
|
|
|
Bucket quotas are not intended to enforce a strict hard limit on a bucket's size.
|
|
If a bucket exceeds its quota between scanner passes, MinIO continues to accept ``PUT`` requests for that bucket until _after_ the next scanner pass identifies the quota violation.
|
|
|
|
|
|
Subcommands
|
|
-----------
|
|
|
|
:mc:`mc quota` includes the following subcommands:
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
:widths: 30 70
|
|
:width: 100%
|
|
|
|
* - Subcommand
|
|
- Description
|
|
|
|
* - :mc:`~mc quota clear`
|
|
- .. include:: /reference/deprecated/mc-quota-clear.rst
|
|
:start-after: start-mc-quota-clear-desc
|
|
:end-before: end-mc-quota-clear-desc
|
|
|
|
* - :mc:`~mc quota info`
|
|
- .. include:: /reference/deprecated/mc-quota-info.rst
|
|
:start-after: start-mc-quota-info-desc
|
|
:end-before: end-mc-quota-info-desc
|
|
|
|
* - :mc:`~mc quota set`
|
|
- .. include:: /reference/deprecated/mc-quota-set.rst
|
|
:start-after: start-mc-quota-set-desc
|
|
:end-before: end-mc-quota-set-desc
|
|
|
|
.. toctree::
|
|
:titlesonly:
|
|
:hidden:
|
|
|
|
/reference/deprecated/mc-quota-clear
|
|
/reference/deprecated/mc-quota-info
|
|
/reference/deprecated/mc-quota-set
|