基于最后一次访问时间的生命周期规则介绍

使用OSS控制台

1. 登录OSS管理控制台。
2. 单击Bucket列表，然后单击目标Bucket名称。
3. 在左侧导航栏， 选择数据管理 > 生命周期。
4. 在生命周期页面，打开启用访问追踪开关，然后单击创建规则。
5. 在创建生命周期规则面板，按如下说明配置生命周期规则。
   • 存储空间未开启版本控制

     区域	配置项	说明
     基础设置	状态	设置生命周期规则的状态，可选择启动或禁用。
     	策略	选择生命周期规则作用的Object。您可以选择按前缀匹配或配置到整个Bucket。
     	是否允许前缀重叠	OSS默认会检查各个生命周期规则的前缀是否重叠。例如，您设置了以下两条包含重叠前缀的生命周期规则： 规则1 指定该Bucket内所有前缀为dir1/的Object在距离最后一次修改时间180天后删除。 规则2 指定该Bucket内所有前缀为dir1/dir2/的Object在距离最后一次修改时间30天后转低频访问类型，60天后删除。 在未选中该选项的情况下，因后台检测到dir1/dir2/目录下的Object同时匹配两条删除规则，因此会拒绝设置以上两条生命周期规则，并报错Overlap for same action type Expiration.。 在选中该选项的情况下，dir1/dir2/下的Object会在30天后转低频访问类型，60天后删除。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选项后，不支持设置碎片过期策略。
     文件执行策略设置	文件过期策略	选择Object过期策略，可选择过期天数和不启用。选择不启用时，文件过期策略不生效。
     	生命周期管理规则	配置转换Object存储类型或者删除过期Object的规则。 当您选择了最后一次访问时间策略，然后将过期天数设置为30，并指定数据在超出指定过期天数后将自动转换为低频存储类型（数据被访问后，依旧保留在低频档），则最后访问日期为2021年09月01日的Object会在2021年10月01日被转换为指定的存储类型。 说明 当您选择基于最后一次访问时间的生命周期管理规则时，允许指定该规则仅对大于64 KB的文件生效，也可以指定为对所有文件生效。
     碎片执行策略设置	碎片过期策略	设置对过期碎片执行的操作。如果选中了标签，则无法配置该选项。您可以选择碎片过期策略的过期天数或过期日期，也可以选择不启用碎片过期策略。当选择不启用时，碎片过期策略不生效。 重要 生命周期规则至少包含文件过期策略或碎片过期策略。
     	碎片规则	根据碎片过期策略选择的过期天数或过期日期设定碎片何时过期，碎片过期后会被自动删除，且删除后不可恢复。

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

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

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

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

使用阿里云SDK

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

package main

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

func main() {
    // 创建OSSClient实例。
    // yourEndpoint填写Bucket对应的Endpoint，以华东1（杭州）为例，填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
    // 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
    client, err := oss.New("yourEndpoint", "yourAccessKeyId", "yourAccessKeySecret")
    if err != nil {
        fmt.Println("Error:", err)
        os.Exit(-1)
    }
    // 填写Bucket名称，例如examplebucket。
    bucketName := "examplebucket"

    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请求。直接发起REST API请求需要手动编写代码计算签名。更多信息，请参见PutBucketLifecycle。