对象存储 OSS：基于最后一次访问时间的生命周期规则

1. 登录OSS管理控制台。

2. 单击Bucket 列表，然后单击目标Bucket名称。

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

4. 在生命周期页面，打开启用访问跟踪开关，然后单击创建规则。

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

   • 存储空间未开启版本控制

     区域	配置项	说明
     基础设置	状态	设置生命周期规则的状态，可选择启动或禁用。 启动生命周期规则后，将按照配置的生命周期规则转换数据存储类型。 禁用生命周期规则后，将中断生命周期任务。
     	策略	选择生命周期规则作用的Object。您可以选择按前缀匹配或配置到整个Bucket。
     	是否允许前缀重叠	OSS默认会检查各个生命周期规则的前缀是否重叠。例如，您设置了以下两条包含重叠前缀的生命周期规则： 规则1 指定该Bucket内所有前缀为dir1/的Object在距离最后一次访问时间180天后转为低频访问类型。 规则2 指定该Bucket内所有前缀为dir1/dir2/的Object在距离最后一次访问时间30天后转归档存储类型。 在未选中该选项的情况下，因后台检测到dir1/dir2/目录下的Object同时匹配两条转换规则，因此会拒绝设置以上两条生命周期规则。 在选中该选项的情况下，dir1/dir2/下的Object会在30天后转归档存储类型。dir1/下的其他Object会在180天后转为低频访问类型。
     	前缀	输入规则要匹配的Object名称的前缀。 前缀设置为img，表示匹配名称以img开头的所有Object，例如imgtest.png、img/example.jpg等。 前缀设置为img/，表示匹配名称以img/开头的所有Object，例如img/example.jpg、img/test.jpg等。
     	标签	生命周期规则仅针对拥有指定标签Object生效。例如选择了按前缀匹配，设置前缀为img，并设置标签的key为a，value为1。则该规则将匹配所有名称以img开头，标签为a=1的Object。关于对象标签的更多信息，请参见对象标签。
     	NOT	NOT选项用于设置生命周期规则对指定前缀和标签的Object不生效。 重要 开启NOT选项时，前缀和标签必须至少存在一项，即同时设置前缀和标签或者只设置前缀或标签。 NOT语义定义标签中的key不支持与标签配置项中定义的key相同。 开启NOT选项后，不支持设置碎片过期策略。
     	文件大小	指定生命周期规则生效的文件大小。 指定最小文件：生命周期规则对大于该值的文件大小生效。取值大于0 B，小于5 TB。 指定最大文件：生命周期规则对小于该值的文件大小生效。取值大于0 B，小于等于5 TB。 重要 如果在同一条生命周期中，同时配置了指定最小文件和指定最大文件： 确保指定最大文件的值大于指定最小文件的值。 不支持配置碎片执行策略。 不支持配置清除删除标记策略。
     文件执行策略设置	文件时间策略	选择Object过期策略，可选择指定天数、指定日期和不启用。选择不启用时，文件过期策略不生效。
     	生命周期管理规则	配置转换Object存储类型的规则，数据可以转换为如下类型： 低频存储类型（数据被访问后，依旧保留在低频档） 低频存储类型（数据一旦被访问，回到标准档） 归档存储 冷归档存储 深度冷归档存储 例如：当您选择了最后一次访问时间策略，然后将过期天数设置为30，并指定数据在超出指定过期天数后将自动转换为低频存储类型（数据被访问后，依旧保留在低频档），则最后访问日期为2021年09月01日的Object会在2021年10月01日被转换为指定的存储类型。
     碎片执行策略设置	碎片过期策略	设置对过期碎片执行的操作。如果选中了标签，则无法配置该选项。您可以选择碎片过期策略的指定天数或指定日期，也可以选择不启用碎片过期策略。当选择不启用时，碎片过期策略不生效。 重要 生命周期规则至少包含文件过期策略或碎片过期策略。
     	碎片规则	根据碎片过期策略选择的过期天数或过期日期设定碎片何时过期，碎片过期后会被自动删除，且删除后不可恢复。

   • 存储空间已开启版本控制

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

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

6. 单击确定。

   生命周期规则保存成功后，您可以在策略列表中查看已设置的生命周期规则。

仅Java SDK、Go SDK支持基于最后一次访问时间创建生命周期规则。创建基于最后一次访问时间的生命周期规则前，您需要为指定Bucket开启访问跟踪功能。关于基于最后一次访问时间的生命周期规则的代码示例，请参见SDK简介。

import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.*;
import java.util.ArrayList;
import java.util.List;

public class Demo {

    public static void main(String[] args) throws Exception {
        // Endpoint以华东1（杭州）为例，其它Region请按实际情况填写。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 填写Bucket名称，例如examplebucket。
        String bucketName = "examplebucket";

        // 创建OSSClient实例。
        OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider);

        try {
            ossClient.putBucketAccessMonitor(bucketName, AccessMonitor.AccessMonitorStatus.Enabled.toString());
            // 指定生命周期规则1。规则中指定前缀为logs，且小于等于64 KB的所有文件在距离最后一次访问时间30天后转为低频访问类型。且再次访问前缀为logs的文件时，这些文件仍保留为低频访问类型。
            LifecycleRule lifecycleRule = new LifecycleRule("rule1", "logs", LifecycleRule.RuleStatus.Enabled);
            List<LifecycleRule> lifecycleRuleList = new ArrayList<LifecycleRule>();
            SetBucketLifecycleRequest setBucketLifecycleRequest = new SetBucketLifecycleRequest(bucketName);

            LifecycleRule.StorageTransition storageTransition = new LifecycleRule.StorageTransition();
            storageTransition.setStorageClass(StorageClass.IA);
            storageTransition.setExpirationDays(30);
            storageTransition.setIsAccessTime(true);
            storageTransition.setReturnToStdWhenVisit(false);
            storageTransition.setAllowSmallFile(true);
            List<LifecycleRule.StorageTransition> storageTransitionList = new ArrayList<LifecycleRule.StorageTransition>();
            storageTransitionList.add(storageTransition);
            lifecycleRule.setStorageTransition(storageTransitionList);
            lifecycleRuleList.add(lifecycleRule);
            
            // 指定生命周期规则2。规则中指定前缀为dir，且大于64 KB的所有历史版本文件在距离最后一次访问时间10天后转为低频访问类型。且再次访问前缀为dir的文件时，这些文件将转为标准存储。
            LifecycleRule lifecycleRule2 = new LifecycleRule("rule2", "dir", LifecycleRule.RuleStatus.Enabled);
            LifecycleRule.NoncurrentVersionStorageTransition noncurrentVersionStorageTransition = new LifecycleRule.NoncurrentVersionStorageTransition();
            noncurrentVersionStorageTransition.setStorageClass(StorageClass.IA);
            noncurrentVersionStorageTransition.setNoncurrentDays(10);
            noncurrentVersionStorageTransition.setIsAccessTime(true);
            noncurrentVersionStorageTransition.setReturnToStdWhenVisit(true);
            noncurrentVersionStorageTransition.setAllowSmallFile(false);

            List<LifecycleRule.NoncurrentVersionStorageTransition> noncurrentVersionStorageTransitionList = new ArrayList<LifecycleRule.NoncurrentVersionStorageTransition>();
            noncurrentVersionStorageTransitionList.add(noncurrentVersionStorageTransition);
            lifecycleRule2.setNoncurrentVersionStorageTransitions(noncurrentVersionStorageTransitionList);
            lifecycleRuleList.add(lifecycleRule2);

            setBucketLifecycleRequest.setLifecycleRules(lifecycleRuleList);

            // 设置生命周期规则。
            ossClient.setBucketLifecycle(setBucketLifecycleRequest);
        } 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();
            }
        }
    }
}

# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
from oss2.models import LifecycleRule, BucketLifecycle, StorageTransition, NoncurrentVersionStorageTransition

# 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1（杭州）为例，Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。
# 填写Bucket名称，例如examplebucket。
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')

# 指定生命周期规则1。规则中指定前缀为logs，且大于64 KB的所有文件在距离最后一次访问时间30天后转为低频访问类型。且再次访问前缀为logs的文件时，这些文件仍保留为低频访问类型。
rule1 = LifecycleRule('rule1', 'logs', status=LifecycleRule.ENABLED)
rule1.storage_transitions = [StorageTransition(days=30, storage_class=oss2.BUCKET_STORAGE_CLASS_IA, is_access_time=True, return_to_std_when_visit=False, allow_small_file=True)]

# 指定生命周期规则2。规则中指定前缀为dir，且大于64 KB的所有历史版本文件在距离最后一次访问时间10天后转为低频访问类型。且再次访问前缀为dir的文件时，这些文件将转为标准存储。
rule2 = LifecycleRule('rule2', 'dir', status=LifecycleRule.ENABLED)
rule2.noncurrent_version_sotrage_transitions = [NoncurrentVersionStorageTransition(10, oss2.BUCKET_STORAGE_CLASS_IA, is_access_time=True, return_to_std_when_visit=True, allow_small_file=False)]

lifecycle = BucketLifecycle([rule1, rule2])

# 设置生命周期规则。
result = bucket.put_bucket_lifecycle(lifecycle)

print('设置生命周期成功，返回状态为：' + str(result.status))

package main

import (
	"fmt"
	"github.com/aliyun/aliyun-oss-go-sdk/oss"
	"os"
)

func main() {
	// yourBucketName填写Bucket名称。
	bucketName := "yourBucketName"

	// 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}

	// 创建OSSClient实例。
	// yourEndpoint填写Bucket对应的Endpoint，以华东1（杭州）为例，填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
	client, err := oss.New("yourEndpoint", "", "", oss.SetCredentialsProvider(&provider))
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}

	isTrue := true
	isFalse := false
	// 指定生命周期规则1。规则中指定前缀为logs，且小于等于64 KB的所有文件在距离最后一次访问时间30天后转为低频访问类型。且再次访问前缀为logs的文件时，这些文件仍保留为低频访问类型。
	rule1 := oss.LifecycleRule{
		ID:     "rule1",
		Prefix: "logs",
		Status: "Enabled",
		Transitions: []oss.LifecycleTransition{
			{
				Days:                 30,
				StorageClass:         oss.StorageIA,
				IsAccessTime:         &isTrue,
				ReturnToStdWhenVisit: &isFalse,
				AllowSmallFile:       &isTrue,
			},
		},
	}
	// 指定生命周期规则2。规则中指定前缀为dir，且大于64 KB的所有历史版本文件在距离最后一次访问时间10天后转为低频访问类型。且再次访问前缀为dir的文件时，这些文件将转为标准存储。
	rule2 := oss.LifecycleRule{
		ID:     "rule2",
		Prefix: "dir",
		Status: "Enabled",
		NonVersionTransitions: []oss.LifecycleVersionTransition{
			{
				NoncurrentDays:       10,
				StorageClass:         oss.StorageIA,
				IsAccessTime:         &isTrue,
				ReturnToStdWhenVisit: &isTrue,
				AllowSmallFile:       &isFalse,
			},
		},
	}
	// 设置生命周期规则。
	var rules = []oss.LifecycleRule{rule1, rule2}
	err = client.SetBucketLifecycle(bucketName, rules)
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}
	fmt.Printf("%s\n", "set bucket life cycle success")
}

如果您的程序自定义要求较高，您可以直接发起REST API请求。直接发起REST API请求需要手动编写代码计算签名。更多信息，请参见PutBucketLifecycle。