tencent cloud

Overview

This document provides an overview of APIs and Go SDK code samples related to logging.

Setting Logging Configuration

Description

This API is used to enable logging for a source bucket and store the access logs in a specified destination bucket.

Method prototype

func (s *BucketService) PutLogging(ctx context.Context, opt *BucketPutLoggingOptions) (*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.BucketPutLoggingOptions{
       LoggingEnabled: &cos.BucketLoggingEnabled{
           TargetBucket: "TargetBucket-1250000000",
       },
   }
   _, err := client.Bucket.PutLogging(context.Background(), opt)
   if err != nil {
       // ERROR
   }
}

Parameter description

type BucketLoggingEnabled struct {
  TargetBucket string 
  TargetPrefix string 
}
// BucketPutLoggingOptions is the options of PutBucketLogging
type BucketPutLoggingOptions struct {
  XMLName        xml.Name             
  LoggingEnabled *BucketLoggingEnabled 
}

Querying Logging Configuration

Description

This API is used to query the logging configuration of a specified bucket.

Method prototype

func (s *BucketService) GetLogging(ctx context.Context) (*BucketGetLoggingResult, *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.GetLogging(context.Background())
   if err != nil {
       // ERROR
   }
   fmt.Println(v)
}

Response description

type BucketGetLoggingResult BucketPutLoggingOptions