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

Setting Lifecycle

Feature description

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

Method prototype

public Guzzle\Service\Resource\Model putBucketLifecycle(array $args = array());

Sample request

Sample 1. Deleting all objects 1 day after generation

try {
    $result = $cosClient->putBucketLifecycle(array(
        'Bucket' => 'examplebucket-1250000000', // Format: BucketName-APPID
        'Rules' => array(
            array(
                'Expiration' => array(
                    'Days' => 1,
                ),
                'ID' => 'rule01',
                'Filter' => array(
                    'Prefix' => ''
                ),
                'Status' => 'Enabled',
            ),
        )
    ));
    // Request succeeded
    print_r($result);
} catch (\Exception $e) {
    // Request failed
    echo "$e\n";
}

Sample 2. Transitioning objects with a specific prefix to archive storage 1 day after generation

try {
    $result = $cosClient->putBucketLifecycle(array(
        'Bucket' => 'examplebucket-1250000000', // Format: BucketName-APPID
        'Rules' => array(
            array(
                'ID' => 'rule01',
                'Filter' => array(
                    'Prefix' => 'prefix01/'
                ),  
                'Status' => 'Enabled',
                'Transitions' => array(
                    array(
                        'Days' => 1,
                        'StorageClass' => 'Archive'
                    ),
                ),  
            ),
        )
    ));  
    // Request succeeded
    print_r($result);
} catch (\Exception $e) {
    // Request failed
    echo "$e\n";
}

Parameter description

Querying Lifecycle

Feature description

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

Method prototype

public Guzzle\Service\Resource\Model getBucketLifecycle(array $args = array());

Sample request

try {
    $result = $cosClient->getBucketLifecycle(array(
        'Bucket' => 'examplebucket-1250000000' // Format: BucketName-APPID
    )); 
    // Request succeeded
    print_r($result);
} catch (\Exception $e) {
    // Request failed
    echo($e);
}

Parameter description

Sample return result

Guzzle\Service\Resource\Model Object
(
    [data:protected] => Array
        (
            [Rules] => Array
                (
                    [0] => Array
                        (
                            [ID] => id1
                            [Filter] => Array
                                (
                                    [Prefix] => documents/
                                )
                            [Status] => Enabled
                            [Transition] => Array
                                (
                                    [Days] => 200
                                    [StorageClass] => Standard_IA
                                )
                            [Expiration] => Array
                                (
                                    [Days] => 1000
                                )
                        )
                )
            [RequestId] => NWE3YzhlZjNfY2FhMzNiMGFfNDVkNF8yZDIxODE=
        )
)

Returned result description

Deleting Lifecycle

Feature description

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

Method prototype

public Guzzle\Service\Resource\Model deleteBucketLifecycle(array $args = array());

Sample request

try {
    $result = $cosClient->deleteBucketLifecycle(array(
        'Bucket' => 'examplebucket-1250000000' // Format: BucketName-APPID
    )); 
    // Request succeeded
    print_r($result);
} catch (\Exception $e) {
    // Request failed
    echo($e);
}

Parameter description