Skip to content

destroy bucket

Tear down a utopia-managed bucket completely — versions, delete markers, then the bucket itself.

bash
awsutopia destroy bucket <name> [--force] [--yes] [--dry-run] [--json]
bash
awsutopia destroy bucket my-app-dev-assets --yes
awsutopia destroy bucket my-app-dev-assets --dry-run --json

What happens

  1. Confirms ownership (current project tags by default)
  2. Empties all object versions and delete markers
  3. Deletes the bucket

Confirmation required unless --yes. Decline → no-op, exit 5.

--force allows other utopia-tagged projects (still refuses untagged buckets). Full rules: Destroy policy.

--dry-run may read tags and versions to print the plan; it does not delete anything.

Working name — your AWS account, your bill.