Delete bucket

Updated at：2025-11-03

Delete bucket

Basic workflow
1. Create a BosClient instance.
2. Run the deleteBucket() method.

Example code

                JavaScript
                
            

                client.deleteBucket(<BucketName>)
  .then(function() {
 // Deletion completed
  })
  .catch(function(error) {
 // Deletion failed
  });
            

Plain Text

1> **Note:**
2>
3> - If the bucket is not empty (i.e., it contains objects or unfinished three-step upload parts), it cannot be deleted. You must empty the bucket first to delete it successfully.  
4> - Before deleting a bucket, verify that Cross-Region Replication (CRR) is not enabled for the bucket, and that it is neither the source nor target bucket in any CRR rules. Otherwise, the deletion will fail.

Check if bucket exists

Object management

BOS

BOS

Delete bucket

Delete bucket