GetBucketWorm用于获取指定存储空间(Bucket)的合规保留策略信息。

说明 若指定用来获取Bucket的合规保留策略信息对应的WORM ID不存在,则返回404。

注意事项

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

当合规保留策略锁定后,您可以在Bucket中上传和读取文件(Object),但是在Object的保留时间到期之前,不允许删除Object及合规保留策略。Object的保留时间到期后,才可以删除Object。

响应元素

名称 类型 描述
WormConfiguration 容器 根节点

子节点:WormId、State、RetentionPeriodInDays、CreationDate

WormId 字符串 WORM的ID。
State 字符串 WORM所处的状态。

可选值: InProgress、Locked

RetentionPeriodInDays 正整数 Object的指定保留天数。
CreationDate 字符串 WORM的创建时间。

示例

  • 请求示例
    GET /?worm HTTP/1.1
    Date: GMT Date
    Host: BucketName.oss.aliyuncs.com
    Authorization: SignatureValue
  • 返回示例
    HTTP/1.1 200 OK
    x-oss-request-id: RequestId
    Date: Date
    Content-Type: application/xml
    Content-Length: length
    <WormConfiguration>
      <WormId>ID</WormId>
      <State>Locked</State>
      <RetentionPeriodInDays>1</RetentionPeriodInDays>
      <CreationDate>2018-08-14T15:50:32</CreationDate>
    </WormConfiguration>