Overview

This document provides an overview of APIs and SDK code samples related to bucket tagging.

Setting Bucket Tag

Feature description

This API (PUT Bucket tagging) is used to set a tag for an existing bucket.

Method prototype

func (s *BucketService) PutTagging(ctx context.Context, opt *BucketPutTaggingOptions) (*Response, error)

Sample request

opt := &cos.BucketPutTaggingOptions{
    TagSet: []cos.BucketTaggingTag{
    {   
        Key:   "testk1",
        Value: "testv1",
    },  
    {   
        Key:   "testk2",
        Value: "testv2",
    },  
    },  
}   
resp, err := client.Bucket.PutTagging(context.Background(), opt)

Parameter description

type BucketTaggingTag struct {
    Key   string
    Value string
}
type BucketPutTaggingOptions struct {
    XMLName xml.Name           
    TagSet  []BucketTaggingTag 
}

Querying Bucket Tag

Feature description

This API (GET Bucket tagging) is used to query the existing tags of a specified bucket.

Method prototype

func (s *BucketService) GetTagging(ctx context.Context) (*BucketGetTaggingResult, *Response, error)

Sample request

v, resp, err := client.Bucket.GetTagging(context.Background())

Returned result description

type BucketTaggingTag struct {
    Key   string
    Value string
}
type BucketGetTaggingResult struct {
    XMLName xml.Name           
    TagSet  []BucketTaggingTag 
}

Deleting Bucket Tag

Feature description

This API (DELETE Bucket tagging) is used to delete an existing tag of a specified bucket.

Method prototype

func (s *BucketService) DeleteTagging(ctx context.Context) (*Response, error)

Sample request

resp, err := client.Bucket.DeleteTagging(context.Background())