全部文档
当前文档
最近更新时间：2026-04-28 18:16:31
调用InitiateBucketWorm接口新建一条合规保留策略。使用此接口用户，必须是该Bucket的所有者或具有ks3:InitiateBucketWorm 权限。
对象存储KS3支持WORM（Write Once Read Many）特性，允许以不可删除、不可篡改的方式保存和使用数据。KS3允许针对存储空间（Bucket）设置基于时间的合规保留策略，保护周期为1天到100年。
当基于时间的合规保留策略创建24小时后未提交锁定，则该策略自动失效。当合规保留策略锁定后，您可以在Bucket中上传和读取文件（Object），但是在Object的保留时间到期之前，不允许删除Object及合规保留策略。Object的保留时间到期后，才可以删除Object。关于合规保留策略的更多信息，请参见保留策略。
Bucket级别保留策略（BucketWorm）与回收站互斥，同一Bucket中仅能开启其中一种数据保护策略。
POST /?worm HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
<InitiateWormConfiguration>
<RetentionPeriodInDays>365</RetentionPeriodInDays>
</InitiateWormConfiguration>该请求消息中不使用消息参数
该请求使用公共消息头
请求元素
名称 | 类型 | 是否必须 | 描述 |
InitiateWormConfiguration | 容器 | 是 | 根节点 子节点：RetentionPeriodInDays |
RetentionPeriodInDays | 正整数 | 是 | 指定Object保留天数。 有效输入为：1~36500天（1天~100年） |
该接口只返回常用响应头部。
该接口不返回响应内容。
POST /?worm HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Wed, 14 May 2014 02:11:21 GMT
Content-MD5: xxx
Authorization: authorization string
Content-Length: yyy
Content-type: application/xml
<InitiateWormConfiguration>
<RetentionPeriodInDays>365</RetentionPeriodInDays>
</InitiateWormConfiguration>HTTP/1.1 200 OK
Content-Length: 0
Connection: keep-alive
Date: Tue, 19 Jul 2025 09:14:23 GMT
Server: KS3
x-kss-request-id: 54a47bda18ac4e6e91de369add54218***错误码 | HTTP状态码 | 描述 |
InvalidRetentionPeriod | 400 | 保留期限无效 |
MalformedXML | 400 | 请求中提供的保留策略（WORM）配置XML结构不合法 |
WORMConfigurationAlreadyExists | 409 | 保留策略已存在 |
WORMConflictsWithRetention | 409 | 尝试配置保留策略（WORM）的Bucket已开启回收站功能，不允许对同一个桶同时配置保留策略和回收站 |
纯净模式