tencent cloud

Overview

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

Setting a Lifecycle Configuration

Description

This API (PUT Bucket lifecycle) is used to set the lifecycle configuration for a bucket.

Method prototype

func (s *BucketService) PutLifecycle(ctx context.Context, opt *BucketPutLifecycleOptions) (*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"),
       },
   })
   lc := &cos.BucketPutLifecycleOptions{
       Rules: []cos.BucketLifecycleRule{
           {
               ID:     "1234",
               Filter: &cos.BucketLifecycleFilter{Prefix: "test"},
               Status: "Enabled",
               Transition: []cos.BucketLifecycleTransition{
                   {
                       Days:         10,
                       StorageClass: "Standard",
                   },
               },
           },
           {
               ID:     "123422",
               Filter: &cos.BucketLifecycleFilter{Prefix: "gg"},
               Status: "Disabled",
               Expiration: &cos.BucketLifecycleExpiration{
                   Days: 10,
               },
           },
       },
   }
   _, err := client.Bucket.PutLifecycle(context.Background(), lc)
   if err != nil {
       panic(err)
   }
}

Parameter description

type BucketPutLifecycleOptions struct {
   XMLName xml.Name
   Rules   []BucketLifecycleRule
}
type BucketLifecycleRule struct {
   ID                             string
   Status                         string
   Filter                         *BucketLifecycleFilter
   Transition                     []BucketLifecycleTransition
   Expiration                     *BucketLifecycleExpiration
   AbortIncompleteMultipartUpload *BucketLifecycleAbortIncompleteMultipartUpload
   NoncurrentVersionTransition    []BucketLifecycleNoncurrentVersion
   NoncurrentVersionExpiration    *BucketLifecycleNoncurrentVersion
}
type BucketLifecycleFilter struct {
   Prefix string
   Tag    *BucketTaggingTag
   And    *BucketLifecycleAndOperator
}
type BucketLifecycleTransition struct {
Date         string 
Days         int    
StorageClass string
}
type BucketLifecycleExpiration struct {
   Date                      string
   Days                      int
   ExpiredObjectDeleteMarker bool
}
type BucketLifecycleNoncurrentVersion struct {
   NoncurrentDays int
   StorageClass   string
}
type BucketLifecycleAbortIncompleteMultipartUpload struct {
DaysAfterInitiation int 
}

Querying a Lifecycle Configuration

Description

This API (GET Bucket lifecycle) is used to query the lifecycle configuration of a bucket.

Method prototype

func (s *BucketService) GetLifecycle(ctx context.Context) (*BucketGetLifecycleResult, *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"),
       },
   })
   _, _, err := client.Bucket.GetLifecycle(context.Background())
   if err != nil {
       panic(err)
   }
}

Response description

The result of the request is returned through GetBucketLifecycleResult.

type BucketLifecycleRule struct {
ID                             string
Status                         string
Filter                         *BucketLifecycleFilter
Transition                     *BucketLifecycleTransition
Expiration                     *BucketLifecycleExpiration
AbortIncompleteMultipartUpload  *BucketLifecycleAbortIncompleteMultipartUpload 
}
type BucketLifecycleFilter struct {
Prefix       string 
}
type BucketLifecycleTransition struct {
Date         string 
Days         int    
StorageClass string
}
type BucketLifecycleExpiration struct {
Date string 
Days int    
}
type BucketLifecycleAbortIncompleteMultipartUpload struct {
DaysAfterInitiation string 
}

Deleting a Lifecycle Configuration

Description

This API (DELETE Bucket lifecycle) is used to delete the lifecycle configuration from a bucket.

Method prototype

func (s *BucketService) DeleteLifecycle(ctx context.Context) (*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"),
       },
   })
   _, err := client.Bucket.DeleteLifecycle(context.Background())
   if err != nil {
       panic(err)
   }
}