mirror of
https://github.com/minio/docs.git
synced 2025-07-30 07:03:26 +03:00
MinIO removed the version limit in a prior version (#1244)
This removes references to version limits and suggests using object expiration rules to manage unneeded noncurrent versions. There is no doc issue to track this.
This commit is contained in:
@ -120,11 +120,6 @@ For a deeper discussion on the benefits of limiting prefix contents, see the art
|
||||
Object Versioning
|
||||
-----------------
|
||||
|
||||
.. versionchanged:: RELEASE.2023-08-04T17-40-21Z
|
||||
|
||||
MinIO supports keeping up to 10,000 "versions" of an object in a single bucket.
|
||||
For workloads that require keeping more than 10K versions per object, please reach out to MinIO by email at hello@min.io.
|
||||
|
||||
.. image:: /images/retention/minio-versioning-multiple-versions.svg
|
||||
:alt: Object with Multiple Versions
|
||||
:align: center
|
||||
|
@ -29,12 +29,7 @@ For versioned buckets, a write operation that mutates an object results in a new
|
||||
MinIO marks the "latest" version of the object that clients retrieve by default.
|
||||
Clients can then explicitly choose to list, retrieve, or remove a specific object version.
|
||||
|
||||
.. versionchanged:: 2023-08-04T17-40-21Z
|
||||
|
||||
MinIO restricts object versioning to no more than 10,000 versions of each object.
|
||||
|
||||
If a write operation would exceed the 10,000 object version limit, MinIO blocks the operation and returns an error.
|
||||
:ref:`Delete one or more <minio-bucket-versioning-delete>` versions to create a new version of the object.
|
||||
Define :ref:`object expiration <minio-lifecycle-management-create-expiry-rule>` rules to remove versions of objects no longer needed, such as by the number of versions or the date of versions.
|
||||
|
||||
Read Operations on Versioned Objects
|
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
|
@ -107,7 +107,8 @@ Parameters
|
||||
:optional:
|
||||
|
||||
Enables :ref:`object versioning <minio-bucket-versioning>` on the new bucket.
|
||||
When enabled, MinIO keeps up to 10,000 versions of each object.
|
||||
With versioning enabled, by default MinIO allows up to the maximum value of an Int64 versions per object, or over 9.2 quintillion.
|
||||
Define :ref:`object expiration <minio-lifecycle-management-create-expiry-rule>` rules to remove versions of objects no longer needed, such as by the number of versions or the date of versions.
|
||||
|
||||
Versioning is required for :ref:`bucket replication <minio-bucket-replication>` or :ref:`site replication <minio-site-replication-overview>`.
|
||||
Versioning does not imply or require object locking.
|
||||
|
@ -371,12 +371,17 @@ Maximum Object Versions
|
||||
|
||||
*Optional*
|
||||
|
||||
Overrides the default maximum version per object limit of ``10000`` with the user specified value.
|
||||
Defines the default maximum versions to allow per object.
|
||||
|
||||
.. important::
|
||||
By default, MinIO allows up to the maximum value of an Int64 versions per object, or over 9.2 quintillion.
|
||||
|
||||
The default limit of 10,000 provides a safety valve against incorrect or inefficient application behavior in versioned buckets.
|
||||
Lifting this limit without first ensuring your applications are designed for versioned operations may result in a negative performance impact over time.
|
||||
.. note::
|
||||
|
||||
MinIO versions from ``RELEASE.2023-08-04T17-40-21Z``to ``RELEASE.2024-03-26T22-10-45Z`` had a default limit of 10,000 object versions.
|
||||
This setting can be used to override that limit to another value.
|
||||
|
||||
Arbitrarily high versions per objects may cause performance degradation on some operations, such as ``LIST``.
|
||||
This is especially true on systems running budget hardware or spinning drives (HDD).
|
||||
Applications or workloads which produce thousands or more versions per object may require design or architecture review to mitigate potential performance degradations.
|
||||
|
||||
Setting a limit of no more than ``100`` should provide enough versions for most typical use cases.
|
||||
|
Reference in New Issue
Block a user