minio/docs
1
0
Fork 0
mirror of https://github.com/minio/docs.git synced 2025-07-30 07:03:26 +03:00
Code Activity

DOCS-1040: Clarify behavior with name conflicts on prefixes (#1052)

Browse Source 
Closes #1040 

Tried to keep this simple:

1. Use better examples
2. Try to use more clear language
3. Keep the consequence clear.

---------

Co-authored-by: Andrea Longo <feorlen@users.noreply.github.com>
This commit is contained in:
Ravind Kumar
2023-10-27 14:13:39 -04:00
committed by GitHub
parent 9cc466e9df
commit f2d61b2bee
1 changed files with 11 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
source/operations/concepts/thresholds.rst
View File

@ -122,18 +122,20 @@ MinIO recommends using LInux operating system with an XFS based filesystem for p
Conflicting Objects
~~~~~~~~~~~~~~~~~~~
Objects cannot have a conflicting object as its parent.
Applications must assign non-conflicting, unique keys.
Applications must assign non-conflicting, unique keys for all objects.
This includes avoiding creating objects where the name can collide with that of a parent or sibling object.
MinIO returns an empty set for LIST operations at the location of the collision.
MinIO does not support a situation where an object's name is also the name of the prefix for a child object.
For the following example operations, the second PUT operation fails because of a naming conflict with the object created by the first.
For example, the following operations create a namespace conflicts
.. code-block::
PUT <bucketname>/a/b/1.txt
PUT <bucketname>/a/b
PUT data/invoices/2024/january/vendors.csv
PUT data/invoices/2024/january <- collides with existing object prefix
.. code-block::
PUT <bucketname>/a/b
PUT <bucketname>/a/b/1.txt
PUT data/invoices/2024/january
PUT data/invoices/2024/january/vendors.csv <- collides with existing object
While you can perform GET or HEAD operations against these objects, the name collision causes LIST operations to return an empty result set at the ``/invoices/2024/january`` path.