Updated on 2025-09-26 GMT+08:00

Deleting a Bucket

You can use OBS Console, APIs, SDKs, OBS Browser+, or obsutil to delete unwanted or empty buckets to free up the quota of buckets.

An empty bucket must meet the following requirements:

  • There is no object or any historical version of an object in the bucket.
  • There is not any incomplete multipart upload in the bucket. In other words, there are no fragments in the bucket.

    Before deleting a bucket with versioning enabled, ensure that all historical versions and deleter markers (which are also taken as historical versions) in it have been deleted.

Constraints

OBS buckets are global resources, so each bucket name must be unique across all users, including your own. To reuse the name of a deleted bucket for another bucket, you must wait until the bucket name is released. Deleting a bucket via API takes about 30 minutes. However, the process may take longer if the bucket is not empty, or if the account is in arrears or has been deregistered. OBS cannot guarantee immediate deletion. Therefore, if you attempt to create a new bucket using a name that has not been released, the creation will fail. Similarly, if the name is released but claimed by another user before you reuse it, the creation will also fail.

Prerequisites

  • All objects in the bucket have been permanently deleted. A bucket must be emptied before it can be deleted.

    Objects under the Objects, Deleted Objects, and Fragments tabs must be all deleted.

  • A bucket can only be deleted by the bucket owner.

Ways to Delete a Bucket

You can use OBS Console, APIs, SDKs, OBS Browser+, or obsutil to delete a bucket.