All Products
Document Center

Object Storage Service:Delete a bucket

Last Updated:Oct 17, 2023

If you no longer use a bucket, you can delete the bucket to stop unnecessary charges.


Deleted buckets cannot be recovered. Make sure that the data in the buckets is no longer required before you delete the buckets. If you want to continue using the data in the buckets, back up the data in advance. For more information, see Back up buckets.


  • All objects in the bucket are deleted.

    • For more information about how to manually delete a small number of objects, see Delete objects.

    • If you want to delete a large number of objects, we recommend that you configure lifecycle rules to delete the objects in batches. For more information, see Configure lifecycle rules.


    If versioning is enabled for the bucket that you want to delete, make sure that all versions of objects in the bucket are deleted. For more information, see Configure versioning.

  • Parts generated by multipart upload or resumable upload tasks in the bucket are deleted. For more information, see Delete parts.

  • All LiveChannels in the bucket are deleted. For more information, see DeleteLiveChannel.


The following code provides an example on how to delete a bucket named examplebucket:

require 'aliyun/oss'

client =
  # In this example, the endpoint of the China (Hangzhou) region is used. Specify your actual endpoint. 
  endpoint: '',
  # Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. 
  access_key_id: ENV['OSS_ACCESS_KEY_ID'],
  access_key_secret: ENV['OSS_ACCESS_KEY_SECRET']
# Specify the name of the bucket. Example: examplebucket. 


For more information about the API operation that you can call to delete a bucket, see DeleteBucket.