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: GMT Date
    Content-Length:ContentLength
    Content-Type: application/xml
    Host: BucketName.oss.aliyuncs.com
    Authorization: SignatureValue 
    
    <InitiateWormConfiguration>
      <RetentionPeriodInDays>365</RetentionPeriodInDays>
    </InitiateWormConfiguration>
  • 返回示例
    HTTP/1.1 200 OK
    x-oss-request-id: RequestId
    x-oss-worm-id: xxx
    Date: Date