对象存储

产品文档

对象存储

生命周期管理

生命周期概述

京东智联云对象存储通过Bucket规则设置,支持对象的生命周期(Lifecycle)管理功能。可自动删除过期的Object及分片,从而使Bucket在使用中便于维护且能降低成本。用户如果手工维护数据的生命周期,则费时费力;但如果不去维护,则会产生不菲的费用。生命周期管理可以帮助用户自动化完成数据生命周期管理,实现数据删除的自动流程,节约人力和金钱成本。

规则说明

规则定义

生命周期管理规则需基于Bucket定义,配置的规则仅在当前Bucket下生效。每条规则包含以下定义项:

支持操作

  • 对象过期(Expiration):设置Object的过期时间,OSS将在满足时间条件时删除指定Object。

  • 分片过期(AbortIncompleteMultipartUpload):设置正在进行中的分片上传任务在保持一段时间后终止,并删除分片;该操作仅针对未完成的分片上传。

支持资源

  • 前缀(Prefix):支持按前缀过滤资源,只有匹配该前缀的Object才适用这个规则。

  • 标签(Tag):支持按标签过滤资源,只有匹配标签的Object才适用这个规则。

支持时间条件

  • 日期(Date):可指定执行操作的绝对日期,到达该日期后会向相关Object执行相关操作;

  • 天数(Days):可指定相对天数,定义Object会在最后修改日期后多少天后执行相关操作。

  • 自初始化分片后天数(DaysAfterInitiation):仅针对于分片过期(AbortIncompleteMultipartUpload);可指定相对天数,在初始化分片上传多少天后终止未完成的分片上传,并删除分片。

规则示例

生命周期配置为XML格式,每个Bucket最多有1000条规则,举例如下:

<LifecycleConfiguration>
  <Rule>
    <ID>id1</ID>
    <Filter>
       <And>
          <Prefix>log1/</Prefix>
          <Tag>
             <Key>tagkey</Key>
             <Value>tagvalue</Value>
          </Tag>
       </And>
    </Filter>
    <Status>Enabled</Status>
    <Expiration>
       <Days>365</Days>
    </Expiration>
    <AbortIncompleteMultipartUpload>
       <DaysAfterInitiation>30</DaysAfterInitiation>
    </AbortIncompleteMultipartUpload>
  </Rule>
  <Rule>
    <ID>id2</ID>
    <Filter>
       <Prefix>log2/</Prefix>
    </Filter>
    <Status>Enabled</Status>
    <Expiration>
       <Date>2020-01-01T00:00:00.000Z</Date>
    </Expiration>
  </Rule>
  ...
</LifecycleConfiguration>

细节分析:

  • ID:当前生命周期规则名称,最多64个字符,不可与其他Rule中ID重叠;

  • Prefix:指定前缀过滤,该规则会匹配符合前缀条件的资源生效;

  • Tag:标签过滤,该规则会匹配符合标签条件的资源生效;

  • Status:指定该规则状态,Enabled为启用状态,该规则会一直匹配执行;Disabled为关闭状态,该规则将失效;

  • Days:可指定相对天数,定义Object会在最后修改日期后多少天后执行相关操作,Days必须为正整数;

  • Date:指定执行操作的绝对日期,该规则将会在指定日期的生效;该日期必须是UTC午夜零点,并符合ISO8601格式。

  • DaysAfterInitiation:仅针对于分片过期(AbortIncompleteMultipartUpload);可指定相对天数,在初始化分片上传多少天后终止未完成的分片上传,必须为正整数。

注意事项

前缀

  • 前缀的命名在UTF-8编码下不得超过1022个字节;

  • 当前缀和标签均为空时,表明该规则对Bucket中的所有资源生效,请谨慎配置前缀;

  • 所有规则前缀允许重叠,当时间条件满足后,所有满足前缀条件的资源均会执行过期操作。

标签

  • 只能填写字母、数字和空格以及+ - = . _ : / @

  • 标签键长度不超过128字符;标签值长度不超过256字符

  • 可以只指定标签键,不指定标签值。

  • 标签与前缀可以同时存在。

规则生效时间

  • 当时间条件设定为天数时,将Object最后更新时间(Last-Modified)加上天数,再取整到下一个UTC午夜零点,即为规则生效执行时间;若规则生效时间为早于当前时间,将于次日UTC零点生效执行。例如,一个Object的最后更新时间是UTC的2018年1月1日上午1点,相匹配的规则定义的天数是5天,那么过期时间为UTC 2018年1月7日0点整。

  • 当时间条件设定为日期时,在该日期的UTC零点将会生效执行;若设置了一个过去的日期,将会与次日UTC零点生效执行。基于日期的操作并非一次性操作,即使过了该日期后,只要规则状态为“启用”,OSS仍会继续应用该基于日期的操作,请您谨慎设置日期条件。

  • 在同一规则中不能同时指定天数和日期。

执行说明

  • 对于以任何时间条件的配置,OSS都会以生效日期的UTC(零时区)零点为准开始执行操作,由于是异步队列执行,且不排除有大批存量Object需要执行,所以实际删除成功的时间可能会延迟,您可以通过 GET 或 HEAD Object 操作来获取对象的当前状态。

  • OSS对于生命周期的执行效力不提供账单承诺,即对象资源的计费以实际删除成功的时间为准。

  • 资源过期删除是不可逆的,请根据您的需求合理配置生命周期时间计划。

配置生命周期

对象存储支持通过控制台配置设置管理生命周期规则,设置步骤请参考如下内容。如需使用API设置生命周期,请参考Put Bucket Lifecycle

  1. 登入控制台->对象存储->空间管理->进入某个Bucket->基础设置,导航至“生命周期管理”功能区域。使用该功能您可以查看当前Bucket生命周期规则列表,也可以创建和删除生命周期规则。
  2. 点击“创建规则”,可进入创建生命周期规则页面,在该页面可设置生命周期规则。

创建生命周期规则

细节说明:

  • 规则名称:当前生命周期规则名称,不可与当前Bucket下已有规则名称冲突;

  • 状态:默认为启用,可设置为禁用,禁用后,该规则不再生效,直至重新启用;

  • 影响资源:可选择指定前缀或标签配置的资源生效或指定整个存储桶生效;

  • 对象过期策略:支持天数及日期两种时间条件,不能同时指定两种时间条件;

  • 分片过期策略:支持天数时间条件;

  • 同一规则下,对象过期及分片过期至少设置一项,可两项均设置。

注:若需要设置的生命周期规则大于100条,推荐使用API或SDK进行设置。

更新时间:2020-12-16 12:09:53