Bucket Lifecycle Management

Updated at：2025-11-03

Application scenarios

Data has a lifecycle, spanning from creation to archiving and eventually deletion, which forms a complete cycle. Data is frequently accessed and read in its early stages, cools down and gets archived over time, and is ultimately deleted. Lifecycle management in object storage services helps users automate the management of data lifecycle. It is generally useful for the following situations:

Automatically archive or delete data when it reaches a specified age.
Perform specific operations at predefined times.

Create a new lifecycle configuration

Basic workflow

Create a BosClient instance.
Call the putBucketLifecycle() method

Example code

                JavaScript
                
            

                const rules = {
  id: 'rules1',
  status: 'enabled',
  action: {
    name: 'Transition',
    storageClass: 'STANDARD_IA',
    resource: ['baidubosmty2/*'],
    condition: {
      time: {
        dateGreaterThan: 'XXXX-XX-XXTXX:XX:XXZ'
      }
    }
  }
}
client.putBucketLifecycle(<bucketName>,<rules>)
 .then(function(response){
 // Operation
})
.catch(err){}
            

Note:

Only the bucket owner with full permissions can carry out this operation.

"resource" indicates resources to which the rules apply. Example: To apply to objects in samplebucket with the prefix/: samplebucket/prefix/*; to apply to all objects in samplebucket:samplebucket/*. For detailed explanations of parameters related to the lifecycle management function and configuration precautions, please refer to [PutBucketLifecycle API](BOS/API Reference/Bucket-Related Interface/Lifecycle/PutBucketLifecycle.md).

Read the lifecycle configuration of the bucket

Basic workflow

Create a BosClient instance.
Call the getBucketLifecycle() method

Example code

                JavaScript
                
            

                client.getBucketLifecycle(<bucketName>)
 .then(function(response){
    if (resnpose) {
        console.log('lifecycle rules', response)
    }
    
})
.catch(err){}
            

Delete bucket lifecycle

Basic workflow

Create a BosClient instance.
Call the deleteBucketLifecycle() method

Example code

                JavaScript
                
            

                client.deleteBucketLifecycle(<bucketName>)
 .then(function(response){
 // Operation
})
.catch(err){}
            

Bucket Logging Management

Set bucket storage class