Recursive Deletes

Gateway utilizes Swarm's recursive deleting mechanism with some augmentation for requests not containing a "recursive={value}" query argument.

See Managing Domains and SCSP Query Arguments for more about recursive deletes of domains and buckets.

Gateway automatically adds "recursive=yes" to the DELETE request transmitted to Swarm when removing an empty storage domain or an empty bucket if the client request does not include the recursive query argument. This preserves the protocol behavior of the Gateway versions before 4.0. This is analogous to the Unix rmdir behavior on empty directories.

The request must include the recursive query argument or else the request fails if a client issues a DELETE on a non-empty storage domain or bucket. This is analogous to attempting to run rmdir on a non-empty directory in Unix.

The Gateway client audit log records the single DELETE operation. The individual objects do not receive individual audit log records of deletion even if the delete is permitted and the domain or bucket contains objects.