From 522ccf4c33ed8a6e36b7aed64fd1878b85c0c4f5 Mon Sep 17 00:00:00 2001 From: Andrea Longo Date: Tue, 3 Jun 2025 12:53:57 -0600 Subject: [PATCH] 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 --- source/administration/object-management.rst | 23 +++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/source/administration/object-management.rst b/source/administration/object-management.rst index 59f7d952..b61815fe 100644 --- a/source/administration/object-management.rst +++ b/source/administration/object-management.rst @@ -251,6 +251,29 @@ MinIO ignores any objects in the remote bucket or bucket prefix not explicitly m To facilitate this exclusive access, grant the lifecycle management user ``read``, ``write``, and ``delete`` access to the target bucket in its :ref:`policy `. All other policies should ``deny`` access to the target bucket. + +Conflicting Objects +------------------- + +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. + +For example, the following operations create a namespace conflicts + +.. code-block:: + + PUT data/invoices/2024/january/vendors.csv + PUT data/invoices/2024/january <- collides with existing object prefix + +.. code-block:: + + 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. + + .. toctree:: :titlesonly: :hidden: