tencent cloud

Overview

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

Setting Bucket Tags

Description

This API is used to set tags for an existing bucket.

Method prototype

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

Sample request

package main
import (
   "context"
   "github.com/tencentyun/cos-go-sdk-v5"
   "net/http"
   "net/url"
   "os"
)
func main() {
   // Bucket name in the format of BucketName-APPID (APPID is required), which can be viewed in the COS console at https://console.intl.cloud.tencent.com/cos5/bucket
   // Replace it with your region, which can be viewed in the COS console at https://console.intl.cloud.tencent.com/. For more information about regions, see https://intl.cloud.tencent.com/document/product/436/6224.
   u, _ := url.Parse("https://examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com")
   b := &cos.BaseURL{BucketURL: u}
   client := cos.NewClient(b, &http.Client{
       Transport: &cos.AuthorizationTransport{
           // Get the key from environment variables
           // Environment variable `SECRETID` refers to the user's SecretId, which can be viewed at https://console.intl.cloud.tencent.com/cam/capi
           SecretID: os.Getenv("SECRETID"),
           // Environment variable `SECRETKEY` refers to the user's SecretId, which can be viewed at https://console.intl.cloud.tencent.com/cam/capi
           SecretKey: os.Getenv("SECRETKEY"),
       },
   })
   opt := &cos.BucketPutTaggingOptions{
       TagSet: []cos.BucketTaggingTag{
           {
               Key:   "testk1",
               Value: "testv1",
           },
           {
               Key:   "testk2",
               Value: "testv2",
           },
       },
   }
   _, err := client.Bucket.PutTagging(context.Background(), opt)
   if err != nil {
       // ERROR
   }
}

Parameter description

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

Querying Bucket Tags

Description

This API 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

package main
import (
   "context"
   "fmt"
   "github.com/tencentyun/cos-go-sdk-v5"
   "net/http"
   "net/url"
   "os"
)
func main() {
   // Bucket name in the format of BucketName-APPID (APPID is required), which can be viewed in the COS console at https://console.intl.cloud.tencent.com/cos5/bucket
   // Replace it with your region, which can be viewed in the COS console at https://console.intl.cloud.tencent.com/. For more information about regions, see https://intl.cloud.tencent.com/document/product/436/6224.
   u, _ := url.Parse("https://examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com")
   b := &cos.BaseURL{BucketURL: u}
   client := cos.NewClient(b, &http.Client{
       Transport: &cos.AuthorizationTransport{
           // Get the key from environment variables
           // Environment variable `SECRETID` refers to the user's SecretId, which can be viewed at https://console.intl.cloud.tencent.com/cam/capi
           SecretID: os.Getenv("SECRETID"),
           // Environment variable `SECRETKEY` refers to the user's SecretId, which can be viewed at https://console.intl.cloud.tencent.com/cam/capi
           SecretKey: os.Getenv("SECRETKEY"),
       },
   })
   v, _, err := client.Bucket.GetTagging(context.Background())
   if err != nil {
       fmt.Println(err)
   }
   fmt.Println(v)
}

Response description

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

Deleting Bucket Tags

Description

This API is used to delete the existing tags from a bucket.

Method prototype

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

Sample request

package main
import (
  "context"
  "fmt"
  "github.com/tencentyun/cos-go-sdk-v5"
  "net/http"
  "net/url"
  "os"
)
func main() {
  // Bucket name in the format of BucketName-APPID (APPID is required), which can be viewed in the COS console at https://console.intl.cloud.tencent.com/cos5/bucket
  // Replace it with your region, which can be viewed in the COS console at https://console.intl.cloud.tencent.com/. For more information about regions, see https://intl.cloud.tencent.com/document/product/436/6224.
  u, _ := url.Parse("https://examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com")
  b := &cos.BaseURL{BucketURL: u}
  client := cos.NewClient(b, &http.Client{
      Transport: &cos.AuthorizationTransport{
          // Get the key from environment variables
          // Environment variable `SECRETID` refers to the user's SecretId, which can be viewed at https://console.intl.cloud.tencent.com/cam/capi
          SecretID: os.Getenv("SECRETID"),
          // Environment variable `SECRETKEY` refers to the user's SecretId, which can be viewed at https://console.intl.cloud.tencent.com/cam/capi
          SecretKey: os.Getenv("SECRETKEY"),
      },
  })
  resp, err := client.Bucket.DeleteTagging(context.Background())
  if err != nil {
      fmt.Println(err)
  }
  fmt.Println(resp.Header)
}