Skip to content

Commit 522ccf4

Browse files
authored
copy conflicting object text from thresholds page (#1473)
Add the conflicting objects info from the thresholds page to object management, where someone might actually find it. Did not make it an include. cc @klauspost Related changes: `miniohq/aistor-object-store-docs`: https://github.com/miniohq/aistor-object-store-docs/pull/66 `miniohq/aistor-object-store-docs/hugo-migration`: https://github.com/miniohq/aistor-object-store-docs/pull/65
1 parent dffba75 commit 522ccf4

1 file changed

Lines changed: 23 additions & 0 deletions

File tree

source/administration/object-management.rst

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -251,6 +251,29 @@ MinIO ignores any objects in the remote bucket or bucket prefix not explicitly m
251251
To facilitate this exclusive access, grant the lifecycle management user ``read``, ``write``, and ``delete`` access to the target bucket in its :ref:`policy <minio-policy>`.
252252
All other policies should ``deny`` access to the target bucket.
253253

254+
255+
Conflicting Objects
256+
-------------------
257+
258+
Applications must assign non-conflicting, unique keys for all objects.
259+
This includes avoiding creating objects where the name can collide with that of a parent or sibling object.
260+
MinIO returns an empty set for LIST operations at the location of the collision.
261+
262+
For example, the following operations create a namespace conflicts
263+
264+
.. code-block::
265+
266+
PUT data/invoices/2024/january/vendors.csv
267+
PUT data/invoices/2024/january <- collides with existing object prefix
268+
269+
.. code-block::
270+
271+
PUT data/invoices/2024/january
272+
PUT data/invoices/2024/january/vendors.csv <- collides with existing object
273+
274+
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.
275+
276+
254277
.. toctree::
255278
:titlesonly:
256279
:hidden:

0 commit comments

Comments
 (0)