全部文档
当前文档
最近更新时间：2026-04-28 18:16:31
GetBucketWorm用于获取指定存储空间（Bucket）的合规保留策略信息。 使用此接口，您需要是Bucket的所有者或者具有ks3:GetBucketWorm权限。
对象存储KS3支持WORM（Write Once Read Many）特性，允许您以不可删除、不可篡改的方式保存和使用数据。KS3允许针对Bucket设置基于时间的合规保留策略，保护周期为1天到100年。
当合规保留策略锁定后，您可以在Bucket中上传和读取文件（Object），但是在Object的保留时间到期之前，不允许删除Object及合规保留策略。Object的保留时间到期后，才可以删除Object。
GET /?worm HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}注意：
该接口不使用请求参数。
该接口只使用常用请求头部。获取更多信息，请点击常用请求头部
该接口可以使用所有常用响应头部。获取更多信息，请点击常用响应头部。
返回XML中的参数如下所示：
名称 | 类型 | 描述 |
WormConfiguration | 容器 | 根节点。 子节点：WormId、State、RetentionPeriodInDays、CreationDate |
WormId | 字符串 | 合规保留策略的ID。 |
State | 字符串 | 合规保留策略所处的状态。 可选值：
|
RetentionPeriodInDays | 正整数 | Object的指定保留天数。 |
CreationDate | 字符串 | 合规保留策略的创建时间。 |
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
Date: Fri, 16 Oct 2020 11:18:32 GMT
Content-Type: application/xml
Content-Length: length
x-kss-request-id: 54a47bda18ac4e6e91de369add54218***
<WormConfiguration>
<WormId>1666E2CFB2B3418****</WormId>
<State>Locked</State>
<RetentionPeriodInDays>1</RetentionPeriodInDays>
<CreationDate>2026-10-15T15:50:32</CreationDate>
</WormConfiguration>错误码 | HTTP状态码 | 描述 |
NoSuchWORMConfiguration | 404 | 保留策略不存在 |
纯净模式