All Products
Search

This Product

    Object Storage Service:Delete a bucket

    Document Center

    Object Storage Service:Delete a bucket

    Last Updated:May 07, 2025

    Deletes a bucket.

    Usage notes

    • Only the owner of a bucket has the permissions to delete the bucket.

    • To prevent unexpected deletion, Object Storage Service (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 Policy 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