对象存储

产品文档

对象存储

PUT Object retention

描述

该操作可设置文件的保留周期。

请求

语法


PUT /<object-key>?retention HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Date: date
Authorization: authorization string
 
<Retention>
    <Mode><value></Mode>
    <RetainUntilDate><value></RetainUntilDate>
</Retention>

请求参数

无请求参数

请求元素

名称 描述 必须
Retention Mode和RetainUntilDate容器
类型:Container
Mode 保留周期模式
有效值:GOVERNANCE、COMPLIANCE
类型:String
父标签:Retention
RetainUntilDate 保留到期日
类型:dateTime(形如2019-06-16T10:00:00.000Z)
父标签:Retention
有Mode时才会存在

示例

请求示例


PUT /<object-key>?retention HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Content-Length: 643
Date: Thu, 12 Apr 2018 21:37:21 GMT
Authorization: authorization string

<Retention>
    <Mode>GOVERNANCE</Mode>
    <RetainUntilDate>2019-06-16T10:00:00.000Z</RetainUntilDate>
</Retention>

响应示例


HTTP/1.1 200 OK
x-amz-request-id: 7F26D08072A8EF2Z
x-amz-date: Thu, 12 Apr 2018 21:37:21 GMT
Content-Length: 0
Server: JDCloudOSS
更新时间:2020-01-06 17:22:40