tencent cloud

Overview

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

Creating an Inventory Job

Description

This API (PUT Bucket inventory) is used to create an inventory job for a bucket.

Method prototype

func (s *BucketService) PutInventory(ctx context.Context, id string, opt *BucketPutInventoryOptions) (*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.BucketPutInventoryOptions{
       ID: "test_id",
       // True or False
       IsEnabled:              "True",
       IncludedObjectVersions: "All",
       Filter: &cos.BucketInventoryFilter{
           Prefix: "test",
       },
       OptionalFields: &cos.BucketInventoryOptionalFields{
           BucketInventoryFields: []string{
               "Size", "LastModifiedDate",
           },
       },
       Schedule: &cos.BucketInventorySchedule{
           // Weekly or Daily
           Frequency: "Daily",
       },
       Destination: &cos.BucketInventoryDestination{
           Bucket: "dest_bucket-1250000000",
           Format: "CSV",
       },
   }
   _, err := client.Bucket.PutInventory(context.Background(), "test_id", opt)
   if err != nil {
       // ERROR
   }
}

Parameter description

type BucketInventoryFilter struct {
  Prefix string 
}
type BucketInventoryOptionalFields struct {
  BucketInventoryFields []string 
}
type BucketInventorySchedule struct {
  Frequency string 
}
type BucketInventoryEncryption struct {
  SSECOS string 
}
type BucketInventoryDestination struct {
  Bucket     string                     
  AccountId  string                     
  Prefix     string                    
  Format     string
  Encryption *BucketInventoryEncryption 
}
// BucketPutInventoryOptions ...
type BucketPutInventoryOptions struct {
  XMLName                xml.Name                     
  ID                     string                         
  IsEnabled              string                       
  IncludedObjectVersions string                      
  Filter                 *BucketInventoryFilter        
  OptionalFields         *BucketInventoryOptionalFields 
  Schedule               *BucketInventorySchedule      
  Destination            *BucketInventoryDestination
}

Error codes

The following describes some common errors that may occur when you call this API:

Querying Inventory Jobs

Description

This API is used to query the inventory jobs of a bucket.

Method prototype

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

Response description

type BucketGetInventoryResult BucketPutInventoryOptions

Querying All Inventories

Description

This API is used to query all inventory jobs set for a bucket. You can configure up to 1,000 inventory jobs for a bucket.

Method prototype

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

Response description

type BucketListInventoryConfiguartion BucketPutInventoryOptions
type ListBucketInventoryConfigResult struct {
  XMLName                 xml.Name          
  InventoryConfigurations []BucketListInventoryConfiguartion 
  IsTruncated             bool   
  ContinuationToken       string    
  NextContinuationToken   string
}

Deleting an Inventory Job

Description

This API is used to delete a specified inventory job from a bucket.

Method prototype

func (s *BucketService) DeleteInventory(ctx context.Context, id string) (*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.DeleteInventory(context.Background(), "test_id")
   if err != nil {
       // ERROR
   }
}

Parameter description