InitiateBucketWorm

注意事项

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

• 当基于时间的合规保留策略创建24小时后未提交锁定，则该策略自动失效。当合规保留策略锁定后，您可以在Bucket中上传和读取文件（Object），但是在Object的保留时间到期之前，不允许删除Object及合规保留策略。Object的保留时间到期后，才可以删除Object。关于合规保留策略的更多信息，请参见保留策略。

• 同一个Bucket中，版本控制和合规保留策略无法同时配置。如果Bucket已开启版本控制功能，则无法再配置保留策略。关于版本控制功能更多信息，请参见版本控制概述。

请求元素

SDK

此接口所对应的各语言SDK如下：

• Java

• python

• Go V2

• Node.js

• C++

• PHP

命令行工具ossutil

InitiateBucketWorm接口所对应的ossutil命令，请参见initiate-bucket-worm。

示例

• 请求示例

  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 qn6q**************:77Dv****************
  
  <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