生命周期规则

1. 登录OSS管理控制台。

2. 在左侧导航栏，选择数据服务 > 云盒Bucket，然后在Bucket列表中单击目标Bucket。

3. 在左侧导航栏，选择数据管理 > 生命周期。

4. 单击创建规则，在创建生命周期规则面板，按如下说明配置生命周期规则。

   • 云盒Bucket未开启版本控制

     区域	配置项	说明
     基本设置	状态	设置生命周期规则的状态，可选择启动或禁用。
     	策略	选择生命周期规则作用的Object。您可以选择按前缀匹配或配置到整个Bucket。
     	前缀	输入规则要匹配的Object名称的前缀。例如，您需要匹配名称以img开头的Object，则输入img。
     清除策略	文件时间策略	选择Object过期策略，可选择过期天数、过期日期和不启用。选择不启用时，文件过期策略不生效。
     	删除文件	配置删除过期Object的规则。 例如，过期日期设置为2022年09月24日，并指定在指定日期前的数据自动删除，则最后修改日期在2021年9月24日之前的Object会被自动删除，且删除后不可恢复。
     清理碎片	碎片过期策略	设置对过期碎片执行的操作。您可以选择碎片过期策略的过期天数或过期日期，也可以选择不启用碎片过期策略。当选择不启用时，碎片过期策略不生效。 重要 生命周期规则至少包含文件过期策略或碎片过期策略。
     	删除碎片	根据碎片过期策略选择的过期天数或过期日期设定碎片何时过期，碎片过期后会被自动删除，且删除后不可恢复。

   • 云盒Bucket已开启版本控制

     开启版本控制后，基本设置与清理碎片区域涉及的配置项，与未开启版本控制的配置方法相同。以下表格仅介绍与未开启版本控制相比，开启版本控制后配置项存在的差异。

     区域	配置项	说明
     当前版本	清理对象删除标记	开启版本控制后，清除策略中增加了清理对象删除标记选项，其他选项与未开启版本控制时相同。 选择此选项后，如果当前Object仅有一个版本且为删除标记时，则OSS将删除过期Object的删除标记。如果当前Object有多个版本，且Object的最新版本为删除标记时，则OSS将保留该删除标记。关于删除标记的更多信息，请参见删除标记。
     历史版本	文件时间策略	设置历史版本文件的过期策略，可选择过期天数和不启用。当选择不启用时，文件过期策略不生效。
     	删除文件	设定一个过期天数N，历史版本的Object会在其被转换为历史版本的N天后过期，并在过期的第二天执行删除操作。例如设置为30，则在2021年09月01日被转为历史版本的Object会在2021年10月01日被删除。 重要 您可以通过Object下一个版本的最后一次修改时间确定Object被转为历史版本的时间。

仅支持通过Java SDK设置生命周期规则，Java SDK要求3.15.0及以上版本。

import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.LifecycleRule;
import com.aliyun.oss.model.SetBucketLifecycleRequest;
import java.util.List;
import com.aliyun.oss.common.auth.DefaultCredentialProvider;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.ClientBuilderConfiguration;
import com.aliyun.oss.common.auth.CredentialsProviderFactory;
import com.aliyun.oss.common.auth.EnvironmentVariableCredentialsProvider;

public class Demo {

    public static void main(String[] args) throws Exception {
        // 填写云盒Bucket的数据域名。
        String endpoint = "https://cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox.aliyuncs.com";
        // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 填写云盒Bucket名称，例如examplebucket。
        String bucketName = "examplebucket";
    // 填写云盒Bucket所在地域。
    String region = "cn-hangzhou";
    // 填写云盒ID。
        String cloudBoxId = "cb-f8z7yvzgwfkl9q0h****";

        // 创建OSSClient实例。
        ClientBuilderConfiguration conf = new ClientBuilderConfiguration();
        conf.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(new DefaultCredentialProvider(credentialsProvider.getCredentials()))
                .clientConfiguration(conf)
                .build();

        try {
            // 创建SetBucketLifecycleRequest。
            SetBucketLifecycleRequest request = new SetBucketLifecycleRequest(bucketName);

            // 设置规则ID。
            String ruleId0 = "rule0";
            // 如果文件匹配前缀设置为空，则表示此规则适用于Bucket中的所有Object。
            String matchPrefix0 = null;

            // 距最后修改时间3天后过期。
            LifecycleRule rule = new LifecycleRule(ruleId0, matchPrefix0, LifecycleRule.RuleStatus.Enabled, 3);
            request.AddLifecycleRule(rule);

            // 发起设置生命周期规则请求。
            ossClient.setBucketLifecycle(request);

            // 查看生命周期规则。
            List<LifecycleRule> listRules = ossClient.getBucketLifecycle(bucketName);
            for(LifecycleRule rules : listRules){
                System.out.println("ruleId="+rules.getId()+", matchPrefix="+rules.getPrefix()+", expirationDays="+rules.getExpirationDays());
            }
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}