InitiateBucketWorm用于新建一条合规保留策略。
注意事项
对象存储OSS支持WORM(Write Once Read Many)特性,允许您以不可删除、不可篡改的方式保存和使用数据。OSS允许针对存储空间(Bucket)设置基于时间的合规保留策略,保护周期为1天到70年。
当基于时间的合规保留策略创建24小时后未提交锁定,则该策略自动失效。当合规保留策略锁定后,您可以在Bucket中上传和读取文件(Object),但是在Object的保留时间到期之前,不允许删除Object及合规保留策略。Object的保留时间到期后,才可以删除Object。有关合规保留策略的详情,请参见合规保留策略。
请求元素
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
InitiateWormConfiguration | 容器 | 是 | 根节点
子节点:RetentionPeriodInDays |
RetentionPeriodInDays | 正整数 | 是 | 指定Object保留天数。 |
示例
- 请求示例
POST /?worm HTTP/1.1 Date: Thu, 15 May 2014 11:18:32 GMT Content-Length:556 Content-Type: application/xml Host: BucketName.oss.aliyuncs.com Authorization: OSS nxj7dtlhcyl5hp****:COS3OQkfQPnKmYZTEHYv2**** <InitiateWormConfiguration> <RetentionPeriodInDays>365</RetentionPeriodInDays> </InitiateWormConfiguration>
- 返回示例
HTTP/1.1 200 OK x-oss-request-id: 5374A2880232A65C2300**** x-oss-worm-id: 1666E2CFB2B3418**** Date: Thu, 15 May 2014 11:18:32 GMT