|
|
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:"EncodingType,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 struct { XCosACL string `header:"x-cos-acl,omitempty" url:"-" xml:"-"` XCosGrantRead string `header:"x-cos-grant-read,omitempty" url:"-" xml:"-"` XCosGrantWrite string `header:"x-cos-grant-write,omitempty" url:"-" xml:"-"` XCosGrantFullControl string `header:"x-cos-grant-full-control,omitempty" url:"-" xml:"-"` XCosGrantReadACP string `header:"x-cos-grant-read-acp,omitempty" url:"-" xml:"-"` XCosGrantWriteACP string `header:"x-cos-grant-write-acp,omitempty" url:"-" xml:"-"` CreateBucketConfiguration *CreateBucketConfiguration `header:"-" url:"-" xml:"-"`}type CreateBucketConfiguration struct { XMLName xml.Name `xml:"CreateBucketConfiguration"` BucketAZConfig string `xml:"BucketAZConfig,omitempty"`}
// 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, } if opt != nil && opt.CreateBucketConfiguration != nil { sendOpt.body = opt.CreateBucketConfiguration } 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"`}
type BucketGetObjectVersionsOptions struct { Prefix string `url:"prefix,omitempty"` Delimiter string `url:"delimiter,omitempty"` EncodingType string `url:"encoding-type,omitempty"` KeyMarker string `url:"key-marker,omitempty"` VersionIdMarker string `url:"version-id-marker,omitempty"` MaxKeys int `url:"max-keys,omitempty"`}
type BucketGetObjectVersionsResult struct { XMLName xml.Name `xml:"ListVersionsResult"` Name string `xml:"Name,omitempty"` EncodingType string `xml:"EncodingType,omitempty"` Prefix string `xml:"Prefix,omitempty"` KeyMarker string `xml:"KeyMarker,omitempty"` VersionIdMarker string `xml:"VersionIdMarker,omitempty"` MaxKeys int `xml:"MaxKeys,omitempty"` Delimiter string `xml:"Delimiter,omitempty"` IsTruncated bool `xml:"IsTruncated,omitempty"` NextKeyMarker string `xml:"NextKeyMarker,omitempty"` NextVersionIdMarker string `xml:"NextVersionIdMarker,omitempty"` CommonPrefixes []string `xml:"CommonPrefixes>Prefix,omitempty"` Version []ListVersionsResultVersion `xml:"Version,omitempty"` DeleteMarker []ListVersionsResultDeleteMarker `xml:"DeleteMarker,omitempty"`}
type ListVersionsResultVersion struct { Key string `xml:"Key,omitempty"` VersionId string `xml:"VersionId,omitempty"` IsLatest bool `xml:"IsLatest,omitempty"` LastModified string `xml:"LastModified,omitempty"` ETag string `xml:"ETag,omitempty"` Size int `xml:"Size,omitempty"` StorageClass string `xml:"StorageClass,omitempty"` Owner *Owner `xml:"Owner,omitempty"`}
type ListVersionsResultDeleteMarker struct { Key string `xml:"Key,omitempty"` VersionId string `xml:"VersionId,omitempty"` IsLatest bool `xml:"IsLatest,omitempty"` LastModified string `xml:"LastModified,omitempty"` Owner *Owner `xml:"Owner,omitempty"`}
func (s *BucketService) GetObjectVersions(ctx context.Context, opt *BucketGetObjectVersionsOptions) (*BucketGetObjectVersionsResult, *Response, error) { var res BucketGetObjectVersionsResult sendOpt := sendOptions{ baseURL: s.client.BaseURL.BucketURL, uri: "/?versions", method: http.MethodGet, optQuery: opt, result: &res, } resp, err := s.client.send(ctx, &sendOpt) return &res, resp, err}
|
