bucket_tagging.go

package cos

import (
	"context"
	"encoding/xml"
	"net/http"
)

// BucketTaggingTag ...
type BucketTaggingTag struct {
	Key   string
	Value string
}

// BucketGetTaggingResult ...
type BucketGetTaggingResult struct {
	XMLName xml.Name           `xml:"Tagging"`
	TagSet  []BucketTaggingTag `xml:"TagSet>Tag,omitempty"`
}

// MethodGetTagging method name of Bucket.GetTagging
const MethodGetTagging MethodName = "Bucket.GetTagging"

// GetTagging ...
//
// Get Bucket Tagging接口实现获取指定Bucket的标签。
//
// https://www.qcloud.com/document/product/436/8277
func (s *BucketService) GetTagging(ctx context.Context) (*BucketGetTaggingResult, *Response, error) {
	var res BucketGetTaggingResult
	sendOpt := sendOptions{
		baseURL: s.client.BaseURL.BucketURL,
		uri:     "/?tagging",
		method:  http.MethodGet,
		result:  &res,
		caller: Caller{
			Method: MethodGetTagging,
		},
	}
	resp, err := s.client.send(ctx, &sendOpt)
	return &res, resp, err
}

// BucketPutTaggingOptions ...
type BucketPutTaggingOptions struct {
	XMLName xml.Name           `xml:"Tagging"`
	TagSet  []BucketTaggingTag `xml:"TagSet>Tag,omitempty"`
}

// MethodPutTagging method name of Bucket.PutTagging
const MethodPutTagging MethodName = "Bucket.PutTagging"

// PutTagging ...
//
// Put Bucket Tagging接口实现给用指定Bucket打标签。用来组织和管理相关Bucket。
//
// 当该请求设置相同Key名称，不同Value时，会返回400。请求成功，则返回204。
//
// https://www.qcloud.com/document/product/436/8281
func (s *BucketService) PutTagging(ctx context.Context, opt *BucketPutTaggingOptions) (*Response, error) {
	sendOpt := sendOptions{
		baseURL: s.client.BaseURL.BucketURL,
		uri:     "/?tagging",
		method:  http.MethodPut,
		body:    opt,
		caller: Caller{
			Method: MethodPutTagging,
		},
	}
	resp, err := s.client.send(ctx, &sendOpt)
	return resp, err
}

// MethodDeleteTagging method name of Bucket.DeleteTagging
const MethodDeleteTagging MethodName = "Bucket.DeleteTagging"

// DeleteTagging ...
//
// Delete Bucket Tagging接口实现删除指定Bucket的标签。
//
// https://www.qcloud.com/document/product/436/8286
func (s *BucketService) DeleteTagging(ctx context.Context) (*Response, error) {
	sendOpt := sendOptions{
		baseURL: s.client.BaseURL.BucketURL,
		uri:     "/?tagging",
		method:  http.MethodDelete,
		caller: Caller{
			Method: MethodDeleteTagging,
		},
	}
	resp, err := s.client.send(ctx, &sendOpt)
	return resp, err
}