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.

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 APIs

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	The bucket name
f	Optional (additional parameter)	Runs in force mode.
config	Optional (additional parameter)	The 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)	The endpoint
i	Optional (additional parameter)	The user's AK
k	Optional (additional parameter)	The user's SK
t	Optional (additional parameter)	The user's security token