功能说明
删除一个高性能桶(DELETE Bucket)。删除的目标桶由客户端初始化时的访问域名决定。
方法原型
func (s *BucketService) Delete(ctx context.Context, opt ...*BucketDeleteOptions) (*Response, error)
参数说明
参数名称 | 参数描述 | 类型 | 是否必选 |
ctx | 请求上下文,用于控制超时与取消 | context.Context | 是 |
opt | 删除桶选项,可省略,通常直接 c.Bucket.Delete(ctx) | ...*BucketDeleteOptions | 否 |
返回结果说明
参数名称 | 参数描述 | 类型 |
*Response | 响应对象,删除成功状态码为 204 | *cos.Response |
error | 错误信息,成功时为 nil | error |
使用案例
package mainimport ("context""log""net/http""net/url""os""time""github.com/tencentyun/cos-go-sdk-v5")func main() {u, _ := url.Parse("https://examplebucket-x--1250000000.cosrapid.ap-guangzhou.myqcloud.com")b := &cos.BaseURL{BucketURL: u}base := &cos.AuthorizationTransport{SecretID: os.Getenv("SECRETID"),SecretKey: os.Getenv("SECRETKEY"),}c := cos.NewClient(b, &http.Client{Transport: cos.NewRapidCredentialTransport(base),Timeout: 30 * time.Second,})ctx := context.Background()_, err := c.Bucket.Delete(ctx)if err != nil {log.Fatalf("DeleteBucket failed: %v", err)}log.Println("bucket deleted")}
注意事项
删除桶前必须先清空桶内所有对象,否则会返回
BucketNotEmpty 错误。删除的目标桶由客户端初始化时的访问域名决定,请确认域名指向待删除的桶。
桶删除后不可恢复,请谨慎操作。