105 lines
3.1 KiB
Go
105 lines
3.1 KiB
Go
|
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"`
|
|||
|
|
}
|