All Products
Search

This Product

    Object Storage Service:Delete a bucket

    Document Center

    Object Storage Service:Delete a bucket

    Last Updated:Jul 31, 2024

    Deletes a bucket.

    Usage notes

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

    • To delete a bucket, you must have the oss:DeleteBucket permission. For more information, see Attach a custom policy to a RAM user.

    • To prevent unexpected deletion, Object Storage Service (OSS) does not allow you to delete a non-empty 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