Permanently delete every file version (including hide markers and historic
uploads) under a prefix. Differs from delete in that delete's
implementation streams over listFileVersions and removes all versions,
but purge makes the wipe-the-prefix intent explicit and warns loudly.
If source is empty or /, this purges the entire bucket only when
allow-bucket-purge: true is also set. Default behavior is to require a
scoped prefix so an omitted source cannot become a bucket-wide wipe.
Supports dry-run to preview what would be deleted.
Permanently delete every file version (including hide markers and historic uploads) under a prefix. Differs from
deletein thatdelete's implementation streams overlistFileVersionsand removes all versions, butpurgemakes the wipe-the-prefix intent explicit and warns loudly.If
sourceis empty or/, this purges the entire bucket only whenallow-bucket-purge: trueis also set. Default behavior is to require a scoped prefix so an omitted source cannot become a bucket-wide wipe.Supports
dry-runto preview what would be deleted.