Delete a bucket

This guide explains how to delete a bucket on the Console, with rc, or with the S3 API.

RequirementsCopy Anchor Link

• Install and configure rc before using the command-line workflow.
• Empty the target bucket before deleting it, or use --force only after reviewing the objects that will be removed.

Use the RustFS ConsoleCopy Anchor Link

1. Sign in to the RustFS Console.
2. On the homepage, select the bucket you want to delete.
3. On the far right, select the Delete button.
4. In the confirmation dialog, select Confirm.

Using rcCopy Anchor Link

See the rc guide for installation and alias configuration.

Delete a bucket:

rc bucket remove rustfs/my-bucket

✓ Bucket 'rustfs/my-bucket' removed successfully.

Using the APICopy Anchor Link

Delete a bucket via API:

DELETE /{bucketName} HTTP/1.1

S3 requests must be signed with AWS Signature V4, so use an S3 client rather than hand-crafting headers. With the AWS CLI configured for your access keys:

aws s3api delete-bucket \
  --bucket bucket-creation-by-api \
  --endpoint-url http://localhost:9000

Verify the bucket deletion in the RustFS Console.