帮助文档 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
帮助文档 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 开发参考
  5. 常用工具
  6. 命令行工具ossutil 1.0
  7. 常用命令
  8. worm(合规保留策略)

worm(合规保留策略)

  • 常用命令
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

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用户授权自定义的权限策略。

  • 从ossutil 1.6.16版本开始,命令行中Binary名称支持直接使用ossutil,您无需根据系统刷新Binary名称。如果您的ossutil版本低于1.6.16,则需要根据系统刷新Binary名称。更多信息,请参见命令行工具ossutil命令参考。

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

创建并锁定合规保留策略

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

  1. 创建合规保留策略

    • 命令格式

      ossutil worm init oss://BucketName days

      参数说明:

      参数

      说明

      BucketName

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

      days

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

      • 单位:天

      • 取值范围:1~25550

    • 使用示例

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

      ossutil worm init oss://examplebucket 180

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

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

    • 命令格式

      ossutil worm complete oss://BucketName WormId

      参数说明:

      参数

      说明

      BucketName

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

      WormId

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

    • 使用示例

      锁定examplebucket的合规保留策略。

      ossutil worm complete oss://examplebucket 581D8A7FFA064C80827CAB4076A93A78

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

      0.073810(s) elapsed

延长保留周期

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

  • 命令格式

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

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

    ossutil worm extend oss://examplebucket 360 581D8A7FFA064C80827CAB4076A93A78

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

    0.067810(s) elapsed

查询合规保留策略配置

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

  • 命令格式

    ossutil worm get oss://BucketName
  • 使用示例

    查询examplebucket的合规保留策略。

    ossutil worm get oss://examplebucket

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

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

删除合规保留策略

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

  • 命令格式

    ossutil worm abort oss://BucketName
  • 使用示例

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

    ossutil worm abort oss://examplebucket

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

    0.067810(s) elapsed

通用选项

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

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

ossutil worm init oss://test -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

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

相关文章

access-monitor(访问跟踪) 2025-04-21 17:21

如果您希望配置基于最后一次访问时间(Last Access Time)策略的生命周期规则来自动监测Bucket中Object的访问模式并识别冷数据,然后将识别出来的冷数据进行存储类型转换,最终降低存储成本。您需要先通过access-monitor命令为Bucket开启访问跟踪。

appendfromfile(追加上传) 2025-04-21 17:21

appendfromfile命令用于在已上传的追加类型文件(Appendable Object)末尾直接追加内容。

bucket-cname(自定义域名) 2025-04-21 17:21

您可以通过bucket-cname命令创建域名所有权验证所需的CnameToken以及管理Cname配置。 注意事项

bucket-encryption(服务器端加密) 2025-04-21 17:21

配置服务器端加密(即Bucket加密)后,OSS对上传的文件(Object)进行加密,再将得到的加密文件持久化保存。下载文件时,OSS自动将加密文件解密后返回给用户。本文介绍如何通过 bucket-encryption命令添加、修改、查询和删除Bucket的加密配置。

bucket-policy(授权策略) 2025-04-21 17:21

Bucket Policy是基于资源的授权策略,Bucket拥有者可以通过Bucket Policy授权其他用户访问OSS指定资源。bucket-policy命令用于添加、修改、查询、删除Bucket授权策略(Bucket Policy)。

bucket-tagging(存储空间标签) 2025-04-21 17:21

您可以通过存储空间(Bucket)的标签功能, 对Bucket进行分类管理,例如对拥有指定标签的Bucket设置访问权限等。bucket-tagging命令用于添加、修改、查询、删除Bucket的标签配置。 注意事项

目录
Copyright © 2025 your company All Rights Reserved. Powered by 博智数字服务平台.
闽ICP备08105208号-1