Overview

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

Setting a Lifecycle Configuration

API 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

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 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 
}

Querying a Lifecycle Configuration

API 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

_, _, 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

API 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

_, err := client.Bucket.DeleteLifecycle(context.Background())
if err != nil {
   panic(err)
}