GetBucketWorm用于获取指定存储空间（Bucket）的合规保留策略信息。
若指定用来获取Bucket的合规保留策略信息对应的WORM ID不存在，则返回404。
注意事项
对象存储OSS支持WORM（Write Once Read Many）特性，允许您以不可删除、不可篡改的方式保存和使用数据。OSS允许针对Bucket设置基于时间的合规保留策略，保护周期为1天到70年。
当合规保留策略锁定后，您可以在Bucket中上传和读取文件（Object），但是在Object的保留时间到期之前，不允许删除Object及合规保留策略。Object的保留时间到期后，才可以删除Object。
请求头
此接口仅涉及公共请求头，详情请参见公共请求头（Common Request Headers）。
响应头
此接口仅涉及公共响应头，详情请参见公共响应头（Common Response Headers）。
响应元素
名称 | 类型 | 描述 |
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: BucketName.oss.aliyuncs.com Authorization: SignatureValue返回示例
HTTP/1.1 200 OK x-oss-request-id: 5374A2880232A65C2300**** Date: Fri, 16 Oct 2020 11:18:32 GMT Content-Type: application/xml Content-Length: length <WormConfiguration> <WormId>1666E2CFB2B3418****</WormId> <State>Locked</State> <RetentionPeriodInDays>1</RetentionPeriodInDays> <CreationDate>2020-10-15T15:50:32</CreationDate> </WormConfiguration>
SDK
此接口所对应的各语言SDK如下：
Java
python
Go V2
Node.js
C++
PHP
命令行工具ossutil
GetBucketWorm接口所对应的ossutil命令，请参见get-bucket-worm。