You need to enable JavaScript to run this app.
Torch Object Storage

Torch Object Storage

Copy page
Download PDF
Basic Bucket Interface
Deleting a Bucket (Go SDK)
Copy page
Download PDF
Deleting a Bucket (Go SDK)
When a bucket (Bucket) is no longer required, you may delete it to avoid incurring additional charges.​
Precautions​
  • Once a bucket is deleted, it cannot be restored. Please proceed with caution.​
  • Before deleting a bucket, you must have the tos:DeleteBucket permission. For detailed instructions, please refer to the Permission Configuration Guide.​
Prerequisites​
Before deleting a bucket, ensure that all data within the bucket has been removed.​
  • If versioning is enabled for the bucket, please ensure that all current and historical version objects within the bucket have been deleted. For specific operations, refer to Delete Object.​
  • If there are unmerged fragments in the bucket, ensure that all fragment data is deleted. For detailed instructions, see Deleting Fragments.​
  • If a bucket contains a large number of objects, you can configure lifecycle rules to enable batch deletion of objects. For detailed instructions, see Setting Lifecycle Rules.​
Sample Code​
​
package main​
​
import (​
"context"​
"fmt"​
​
"github.com/volcengine/ve-tos-golang-sdk/v2/tos"​
)​
​
func checkErr(err error) {​
if err != nil {​
if serverErr, ok := err.(*tos.TosServerError); ok {​
fmt.Println("Error:", serverErr.Error())​
fmt.Println("Request ID:", serverErr.RequestID)​
fmt.Println("Response Status Code:", serverErr.StatusCode)​
fmt.Println("Response Header:", serverErr.Header)​
fmt.Println("Response Err Code:", serverErr.Code)​
fmt.Println("Response Err Msg:", serverErr.Message)​
} else if clientErr, ok := err.(*tos.TosClientError); ok {​
fmt.Println("Error:", clientErr.Error())​
fmt.Println("Client Cause Err:", clientErr.Cause.Error())​
} else {​
fmt.Println("Error:", err)​
}​
panic(err)​
}​
}​
​
func main() {​
var (​
accessKey = os.Getenv("TOS_ACCESS_KEY")​
secretKey = os.Getenv("TOS_SECRET_KEY")​
​
endpoint = "https://tos-cn-beijing.volces.com"​
region = "cn-beijing"​
​
bucketName = "*** Provide your bucket name ***"​
)​
​
client, err := tos.NewClientV2(endpoint, tos.WithRegion(region), tos.WithCredentials(tos.NewStaticCredentials(accessKey, secretKey)))​
checkErr(err)​
​
output, err := client.DeleteBucket(context.Background(), &tos.DeleteBucketInput{Bucket: bucketName})​
checkErr(err)​
fmt.Println("Delete Bucket Request ID: ", output.RequestID)​
fmt.Println("Delete Bucket Response Status Code: ", output.StatusCode)​
}​
​
Relevant Documentation​
For API documentation on deleting a bucket, refer to DeleteBucket.​
Last updated: 2025.09.19 17:30:19