文档

worm(合规保留策略)

更新时间:

OSS保留策略具有WORM(Write Once Read Many)特性,满足用户以不可删除、不可篡改的方式保存和使用数据。如果您希望指定时间内任何用户(包括资源拥有者)均不能修改和删除OSS某个Bucket中的Object,您需要通过worm命令为Bucket配置保留策略。在保留策略指定的Object保留时间到期之前,仅支持在Bucket中上传和读取Object。Object保留时间到期后,才可以修改或删除Object。

注意事项

  • 要创建合规保留策略,您必须具有oss:InitiateBucketWorm权限;要锁定合规保留策略,您必须具有oss:CompleteBucketWorm权限;要延长保留天数,您必须具有oss:ExtendBucketWorm权限;要获取合规保留策略,您必须具有oss:GetBucketWorm权限;要删除未锁定的合规保留策略,您必须具有oss:AbortBucketWorm权限。具体操作,请参见为RAM用户授权自定义的权限策略

  • 本文各命令行示例均基于Linux 64位系统,其他系统请将命令开头的./ossutil64替换成对应的Binary名称。更多信息,请参见命令行工具ossutil命令参考

  • 关于合规保留策略的更多信息,请参见合规保留策略

创建并锁定合规保留策略

若您希望使用合规保留策略保护您Bucket中的文件,您需要为Bucket创建一条合规保留策略,然后锁定该策略。

  1. 创建合规保留策略

    • 命令格式

      ./ossutil64 worm init oss://BucketName days

      参数说明:

      参数

      说明

      BucketName

      配置合规保留策略的目标Bucket名称。

      days

      指定合规保留策略的保留周期。在保留周期内,您无法对目标Bucket中的Object进行任何修改和删除操作。

      • 单位:天

      • 取值范围:1~25550

    • 使用示例

      为examplebucket创建合规保留策略,并指定其保留周期为180天。

      ./ossutil64 worm init oss://examplebucket 180

      以下输出结果表明已成功创建合规保留策略。

      init success,worm id is 581D8A7FFA064C80827CAB4076A93A78
  2. 锁定合规保留策略

    • 命令格式

      ./ossutil64 worm complete oss://BucketName WormId

      参数说明:

      参数

      说明

      BucketName

      指定要锁定合规保留策略的目标Bucket名称。

      WormId

      填写创建合规保留策略时返回的策略ID。

    • 使用示例

      锁定examplebucket的合规保留策略。

      ./ossutil64 worm complete oss://examplebucket 581D8A7FFA064C80827CAB4076A93A78

      以下输出结果表明已锁定合规保留策略。

      0.073810(s) elapsed

延长保留周期

合规保留策略锁定后,在保留周期未到期之前,任何人都无法修改和删除Bucket中的Object。若当前的保留周期无法满足数据保护的需求,您可以通过以下命令延长保留周期。

  • 命令格式

    ./ossutil64 worm extend oss://BucketName days WormId
  • 使用示例

    将examplebucket的合规保留策略的保留周期延长到360天。

    ./ossutil64 worm extend oss://examplebucket 360 581D8A7FFA064C80827CAB4076A93A78

    以下输出结果表明保留周期已延长到360天。

    0.067810(s) elapsed

查询合规保留策略配置

对于已创建的合规保留策略,您可以通过以下命令查询配置参数。

  • 命令格式

    ./ossutil64 worm get oss://BucketName
  • 使用示例

    查询examplebucket的合规保留策略。

    ./ossutil64 worm get oss://examplebucket

    以下输出结果表明已查询到合规保留策略的配置参数,结果中包含策略ID、状态、保留天数、策略创建时间。

    <WormConfiguration>
          <WormId>581D8A7FFA064C80827CAB4076A93A78</WormId>
          <State>Locked</State>
          <RetentionPeriodInDays>360</RetentionPeriodInDays>
          <CreationDate>2021-01-19T03:36:53.000Z</CreationDate>
      </WormConfiguration>

删除合规保留策略

在合规保留策略未锁定前,您可以删除该策略。

  • 命令格式

    ./ossutil64 worm abort oss://BucketName
  • 使用示例

    删除为examplebucket配置的合规保留策略。

    ./ossutil64 worm abort oss://examplebucket

    以下输出结果表明策略已删除。

    0.067810(s) elapsed

通用选项

当您需要通过命令行工具ossutil切换至另一个地域的Bucket时,可以通过-e选项指定该Bucket所属的Endpoint。当您需要通过命令行工具ossutil切换至另一个阿里云账号下的Bucket时,可以通过-i选项指定该账号的AccessKey ID,并通过-k选项指定该账号的AccessKey Secret。

例如您需要为另一个阿里云账号下,华东1(杭州)名为test的Bucket创建合规保留策略,命令如下:

./ossutil64 worm init oss://test -e oss-cn-hangzhou.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA****  -k 67DLVBkH7EamOjy2W5RVAHUY9H****

关于此命令的其他通用选项的更多信息,请参见通用选项

  • 本页导读 (1)
文档反馈