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

MinIO Implicit Prefix Trimming on Removal of Last Object (see minio/mc issue#3621)

Browse Source
This commit is contained in:
ravindk89
2021-03-31 21:41:32 -04:00
committed by Ravind Kumar
parent 077dcc8f14
commit bc8d563e96
4 changed files with 90 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

50
source/includes/common-admonitions.rst
View File

@ -15,4 +15,52 @@
a maintenance period to minimize interruption of services while performing
this procedure.
.. end-restart-downtime
.. end-restart-downtime
.. Used in the following pages:
/reference/minio-cli/minio-mc/mc-rm.rst
/reference/minio-cli/minio-mc/mc-mv.rst
/reference/minio-cli/minio-mc/mc-mirror.rst
.. start-remove-api-trims-prefixes
|command| relies on the :mc:`mc` removal API for deleting objects. As part of
removing the last object in a bucket prefix, :mc:`mc` also recursively removes
each empty part of the prefix up to the bucket root. :mc:`mc` only applies the
recursive removal to prefixes created *implicitly* as part of object write
operations - that is, the prefix was not created using an explicit directory
creation command such as :mc:`mc mb`.
For example, consider a bucket ``photos`` with the following object prefixes:
- ``photos/2021/january/myphoto.jpg``
- ``photos/2021/february/myotherphoto.jpg``
- ``photos/NYE21/NewYears.jpg``
``photos/NYE21`` is the *only* prefix explicitly created using :mc:`mc mb`.
All other prefixes were *implicitly* created as part of writing the object
located at that prefix.
If an :mc:`mc` command removes ``myphoto.jpg``, the removal API automatically
trims the empty ``/january`` prefix. If a subsequent :mc:`mc` command removes
``myotherphoto.jpg``, the removal API automatically trims both the ``/february``
prefix *and* the now-empty ``/2021`` prefix. If an :mc:`mc` command removes
``NewYears.jpg``, the ``/NYE21`` prefix remains in place since it was
*explicitly* created.
.. end-remove-api-trims-prefixes
.. Following is linked topically to the remove-api-trims-prefixes core
.. start-remove-api-trims-prefixes-fs
If using |command| for operations on a filesystem, :mc:`mc` applies this same
behavior by recursively trimming empty directory paths up to the root. However,
the :mc:`mc` remove API cannot distinguish between an explicitly created
directory path and an implicitly created one. If |command| deletes the last
object at a filesystem path, :mc:`mc` recursively deletes all empty directories
within that path up to the root as part of the removal operation.
.. end-remove-api-trims-prefixes-fs