全部文档
当前文档
最近更新时间：2026-04-28 18:34:50
ExtendBucketWorm用于延长已锁定的合规保留策略。 使用此接口，您需要是Bucket的所有者或者具有ks3:ExtendBucketWorm权限。
当基于时间的合规保留策略创建后，该策略默认处于InProgress状态，且该状态的有效期为24小时。在有效期24小时内，此策略对应的Bucket数据处于保护状态。
启动合规保留策略24小时内：若此策略未提交锁定，则Bucket所有者以及授权用户可以删除此策略；若该保留策略已提交锁定，则不允许删除此策略，且无法缩短策略保护周期，仅可以延长保护周期。
启动合规保留策略24小时后：若超过24小时该保留策略未提交锁定，则该策略自动失效。
若Bucket内有文件处于保护周期内，那么您将无法删除合规保留策略，同时也无法删除Bucket。当Bucket为空时，Bucket的所有者可以删除该Bucket，从而间接删除该Bucket的保留策略。
POST /?wormId=1666E2CFB2B3418****&wormExtend HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
<ExtendWormConfiguration>
<RetentionPeriodInDays>366</RetentionPeriodInDays>
</ExtendWormConfiguration>注意：
该接口只使用常用请求头部。获取更多信息，请点击常用请求头部。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
ExtendWormConfiguration | 容器 | 是 | 不涉及 | 根节点 子节点：RetentionPeriodInDays |
wormId | 字符串 | 是 | 1666E2CFB2B3418**** | 指定调用InitiateBucketWorm接口时自动生成的合规保留策略ID。 |
RetentionPeriodInDays | 正整数 | 是 | 365 | 指定Object的保留天数。 取值范围：1~36500。 |
该接口可以使用所有常用响应头部。获取更多信息，请点击常用响应头部。
该接口不返回响应内容。
GET /?worm HTTP/1.1
Date: Fri, 16 Oct 2020 11:18:32 GMT
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Authorization: SignatureValueHTTP/1.1 200 OK
Content-Length: 0
Connection: keep-alive
Date: Tue, 19 Jul 2017 09:14:23 GMT
Server: KS3
x-kss-request-id: 54a47bda18ac4e6e91de369add54218***错误码 | HTTP状态码 | 描述 |
NoSuchWORMConfiguration | 404 | 保留策略不存在 |
OperationNotAllowed | 403 | 操作不允许 |
InvalidRetentionPeriod | 400 | 保留期限无效 |
MalformedXML | 400 | 请求中提供的保留策略（WORM）配置XML结构不合法 |
纯净模式