All Products
Search
Document Center

Object Storage Service:Delete a bucket

Last Updated:Sep 23, 2026

Deletes a bucket.

Usage notes

  • Only the bucket owner can delete the bucket.

  • OSS does not allow you to delete a non-empty bucket.

Permissions

By default, an Alibaba Cloud account has full permissions. RAM users or RAM roles under an Alibaba Cloud account do not have any permissions by default. The Alibaba Cloud account or account administrator must grant operation permissions through RAM policies or Bucket Policy.

API

Action

Description

DeleteBucket

oss:DeleteBucket

Deletes a bucket.

Command syntax

ossutil api delete-bucket --bucket value [flags]

Parameter

Type

Description

--bucket

string

The name of the bucket.

Note

For more information, see Command-line options.

Examples

Delete the examplebucket bucket.

ossutil api delete-bucket --bucket examplebucket