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.
- If versioning is enabled for the bucket, ensure that all historical versions and versions with the Delete Marker (which are also considered as historical versions) have been deleted.
- The name of a deleted bucket can be reused at least 30 minutes after the deletion.

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.

Using OBS Console

In the navigation pane of OBS Console, choose Object Storage.
In the bucket list, select the bucket you want to delete, and then click Delete on the right.

The name of a deleted bucket can be reused for another bucket or parallel file system at least 30 minutes after the deletion.
Click OK to confirm the deletion.

Figure 1 Deleting a bucket

Using the API

Deleting Buckets

Using SDKs

Using the GUI Tool - OBS Browser+

Log in to OBS Browser+.
Select the bucket you want to delete and click Delete.

The name of a deleted bucket can be reused for another bucket or a parallel file system at least 30 minutes after the deletion.
Click Yes to delete the bucket.

Using the CLI Tool - obsutil

Command Line Structure

In Windows

obsutil rm obs://bucket [-f] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

In Linux or macOS

./obsutil rm obs://bucket [-f] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

Examples

Take the Windows OS as an example. Run the obsutil rm obs://bucket-test command to delete bucket bucket-test.

obsutil rm obs://bucket-test

Start at 2024-09-30 07:58:33.736622 +0000 UTC

Do you want to delete bucket [bucket-test] ? Please input (y/n) to confirm:
y
Delete bucket [bucket-test] successfully!

Parameter Description

Parameter	Optional or Mandatory	Description
bucket	Mandatory	Bucket name
f	Optional (additional parameter)	Runs in force mode.
config	Optional (additional parameter)	User-defined configuration file for executing the current command. To learn the parameters that can be configured in this file, see Configuration Parameters.
e	Optional (additional parameter)	Specifies the endpoint.
i	Optional (additional parameter)	Specifies the user's AK.
k	Optional (additional parameter)	Specifies the user's SK.
t	Optional (additional parameter)	Specifies the user's security token.