全部产品
阿里云办公

生命周期管理

更新时间:2018-08-01 18:16:23

OSS为对象提供文件生命周期管理。您可以为某个存储空间定义生命周期配置,来为该存储空间的文件定义各种规则。目前,用户可以通过规则来删除相匹配的文件。每条规则都由如下几个部分组成:

  • 文件名称前缀,只有匹配该前缀的文件才适用这个规则。
  • 操作,用户希望对匹配的文件所执行的操作。
  • 日期或天数,用户期望在特定日期或者是在文件最后修改时间后多少天执行指定的操作。

设置生命周期

生命周期的配置规则由一段xml表示。

  1. <LifecycleConfiguration>
  2. <Rule>
  3. <ID>delete obsoleted files</ID>
  4. <Prefix>obsoleted/</Prefix>
  5. <Status>Enabled</Status>
  6. <Expiration>
  7. <Days>3</Days>
  8. </Expiration>
  9. </Rule>
  10. <Rule>
  11. <ID>delete temporary files</ID>
  12. <Prefix>temporary/</Prefix>
  13. <Status>Enabled</Status>
  14. <Expiration>
  15. <Date>2022-10-12T00:00:00.000Z</Date>
  16. </Expiration>
  17. </Rule>
  18. </LifecycleConfiguration>

一个生命周期的Config里面可以包含多个Rule(最多1000个)。

各字段解释:

  • ID字段是用来唯一表示本条规则。
  • Prefix指定对存储空间下的符合特定前缀的文件使用规则,不能重叠。
  • Status指定本条规则的状态,只有Enabled和Disabled,分别表示启用规则和禁用规则。
  • Expiration节点里面的Days表示大于文件最后修改时间指定的天数就删除文件,Date则表示到指定的绝对时间之后就删除文件(绝对时间服从ISO8601的格式)。

可以通过下面的代码,设置上述生命周期规则。

  1. using Aliyun.OSS;
  2. // 初始化OssClient
  3. var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
  4. var setBucketLifecycleRequest = new SetBucketLifecycleRequest(bucketName);
  5. // 创建第一条规则
  6. LifecycleRule lcr1 = new LifecycleRule()
  7. {
  8. ID = "delete obsoleted files",
  9. Prefix = "obsoleted/",
  10. Status = RuleStatus.Enabled,
  11. ExpriationDays = 3
  12. };
  13. //创建第二条规则
  14. //当ExpirationTime指定使用Date时,请注意此时的含义是:从这个时刻开始一直生效
  15. LifecycleRule lcr2 = new LifecycleRule()
  16. {
  17. ID = "delete temporary files",
  18. Prefix = "temporary/",
  19. Status = RuleStatus.Enabled,
  20. ExpirationTime = DateTime.Parse("2022-10-12T00:00:00.000Z")
  21. };
  22. setBucketLifecycleRequest.AddLifecycleRule(lcr1);
  23. setBucketLifecycleRequest.AddLifecycleRule(lcr2);
  24. client.SetBucketLifecycle(setBucketLifecycleRequest);

注意

  • 上面的规则一中ExpriationDays使用了Days,表示3天之后一直生效。
  • 上面的规则二中ExpriationDays使用了Date,表示2022-10-12T00:00:00.000Z之后一直生效。除非明确清楚使用Date时的含义,否则请慎重使用。

获取生命周期

可以通过下面的代码获取上述生命周期规则。

  1. using Aliyun.OSS;
  2. var rules = client.GetBucketLifecycle(bucketName);
  3. foreach (var rule in rules)
  4. {
  5. Console.WriteLine("ID: {0}", rule.ID);
  6. Console.WriteLine("Prefix: {0}", rule.Prefix);
  7. Console.WriteLine("Status: {0}", rule.Status);
  8. if (rule.ExpriationDays.HasValue)
  9. Console.WriteLine("ExpirationDays: {0}", rule.ExpriationDays);
  10. if (rule.ExpirationTime.HasValue)
  11. Console.WriteLine("ExpirationTime: {0}", FormatIso8601Date(rule.ExpirationTime.Value));
  12. }

提示:

清空生命周期

可以通过下面的代码清空存储空间中生命周期规则。

  1. using Aliyun.OSS;
  2. // 初始化OssClient
  3. var client = new OssClient(endpoint, accessKeyId, accessKeySecret);
  4. var LifecycleRequest = new SetBucketLifecycleRequest(bucketName);
  5. client.SetBucketLifecycle(LifecycleRequest);
本文导读目录