package cos import ( "context" "encoding/xml" "net/http" ) // BucketService 相关 API type BucketService service // BucketGetResult is the result of GetBucket type BucketGetResult struct { XMLName xml.Name `xml:"ListBucketResult"` Name string Prefix string `xml:"Prefix,omitempty"` Marker string `xml:"Marker,omitempty"` NextMarker string `xml:"NextMarker,omitempty"` Delimiter string `xml:"Delimiter,omitempty"` MaxKeys int IsTruncated bool Contents []Object `xml:"Contents,omitempty"` CommonPrefixes []string `xml:"CommonPrefixes>Prefix,omitempty"` EncodingType string `xml:"Encoding-Type,omitempty"` } // BucketGetOptions is the option of GetBucket type BucketGetOptions struct { Prefix string `url:"prefix,omitempty"` Delimiter string `url:"delimiter,omitempty"` EncodingType string `url:"encoding-type,omitempty"` Marker string `url:"marker,omitempty"` MaxKeys int `url:"max-keys,omitempty"` } // Get Bucket请求等同于 List Object请求,可以列出该Bucket下部分或者所有Object,发起该请求需要拥有Read权限。 // // https://www.qcloud.com/document/product/436/7734 func (s *BucketService) Get(ctx context.Context, opt *BucketGetOptions) (*BucketGetResult, *Response, error) { var res BucketGetResult sendOpt := sendOptions{ baseURL: s.client.BaseURL.BucketURL, uri: "/", method: http.MethodGet, optQuery: opt, result: &res, } resp, err := s.client.send(ctx, &sendOpt) return &res, resp, err } // BucketPutOptions is same to the ACLHeaderOptions type BucketPutOptions ACLHeaderOptions // Put Bucket请求可以在指定账号下创建一个Bucket。 // // https://www.qcloud.com/document/product/436/7738 func (s *BucketService) Put(ctx context.Context, opt *BucketPutOptions) (*Response, error) { sendOpt := sendOptions{ baseURL: s.client.BaseURL.BucketURL, uri: "/", method: http.MethodPut, optHeader: opt, } resp, err := s.client.send(ctx, &sendOpt) return resp, err } // Delete Bucket请求可以在指定账号下删除Bucket,删除之前要求Bucket为空。 // // https://www.qcloud.com/document/product/436/7732 func (s *BucketService) Delete(ctx context.Context) (*Response, error) { sendOpt := sendOptions{ baseURL: s.client.BaseURL.BucketURL, uri: "/", method: http.MethodDelete, } resp, err := s.client.send(ctx, &sendOpt) return resp, err } // Head Bucket请求可以确认是否存在该Bucket,是否有权限访问,Head的权限与Read一致。 // // 当其存在时,返回 HTTP 状态码200; // 当无权限时,返回 HTTP 状态码403; // 当不存在时,返回 HTTP 状态码404。 // // https://www.qcloud.com/document/product/436/7735 func (s *BucketService) Head(ctx context.Context) (*Response, error) { sendOpt := sendOptions{ baseURL: s.client.BaseURL.BucketURL, uri: "/", method: http.MethodHead, } resp, err := s.client.send(ctx, &sendOpt) return resp, err } // Bucket is the meta info of Bucket type Bucket struct { Name string Region string `xml:"Location,omitempty"` CreationDate string `xml:",omitempty"` }