Skip to content

Home

Jump to bottom
Ken Steinfeldt edited this page Feb 5, 2019 · 9 revisions

Welcome to the bucket-wipe wiki!

What is bucket-wipe?

bucket-wipe is a tool designed to enumerate a bucket and delete all of its contents in parallel threads.

Why use bucket-wipe?

S3 buckets cannot be deleted as long as they have objects in them. This tool allows a user to delete a non-empty bucket by programmatically deleting all objects in the specified bucket before deleting the bucket itself. If desired, the bucket can instead be kept, allowing the user to simply empty a bucket quickly and easily.

What it Does?

This tool permanently deletes all data from the bucket and, by default, the bucket itself. However, a bucket can be kept after emptied with the --keep-bucket option. Please note: data cannot be recovered after deletion.

Examples of Use

  1. Delete all objects in a bucket, but keep the empty bucket. In this example there is an external load balancer in place, therefore the -no-smart-client option is used.
java -jar bucket-wipe-1.10.jar -e <end-point> -a <access-key> -s <secret-key> --no-smart-client --keep-bucket <bucket-name>
  1. Delete all objects in a bucket, then delete the bucket. In this example there is no external load balancer, so we keep do not deactivate the smart-client.
java -jar bucket-wipe-1.10.jar -e <end-point> -a <access-key> -s <secret-key> <bucket-name>
Clone this wiki locally