获取存储空间的合规保留策略信息

您可以通过API级命令获取存储空间的合规保留策略信息。

注意事项

  • 要获取存储空间的合规保留策略信息,您必须有oss:GetBucketWorm权限。具体操作,请参见为RAM用户授权自定义的权限策略

  • 对象存储OSS支持WORM(Write Once Read Many)特性,允许您以不可删除、不可篡改的方式保存和使用数据。OSS允许针对Bucket设置基于时间的合规保留策略,保护周期为1天到70年。

  • 当合规保留策略锁定后,您可以在Bucket中上传和读取文件(Object),但是在Object的保留时间到期之前,不允许删除Object及合规保留策略。Object的保留时间到期后,才可以删除Object。

命令格式

ossutil api get-bucket-worm --bucket value [flags]

参数

类型

说明

--bucket

string

Bucket名称。

说明

关于支持的全局命令行选项,请参见支持的全局命令行选项

使用示例

  • 获取存储空间examplebucket的合规保留策略信息。

    ossutil api get-bucket-worm --bucket examplebucket
  • 获取存储空间examplebucket的合规保留策略信息,以JSON格式显示。

    ossutil api get-bucket-worm --bucket examplebucket --output-format json
  • 获取存储空间examplebucket的合规保留策略信息,以YAML格式显示。

    ossutil api get-bucket-worm --bucket examplebucket --output-format yaml