金山云-文档中心-PUT Bucket Retention

对象存储(KS3)

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

最近更新时间：2024-02-21 17:53:59

描述

该接口用于开通、关闭及设置Bucket回收站功能，使用此接口用户，必须是该Bucket的所有者或具有ks3:PutBucketRetention权限。

注：有关回收站规则描述的更多细节，请参见文档：回收站。

请求

请求语法

PUT /?retention HTTP/1.1 
Host: {BucketName}.{endpoint} 
Date: {date} 
Authorization: {SignatureValue} 
Content-length: {length} 
Content-MD5: {md5}

请求参数

该接口不使用请求参数。

请求头

除公共请求头外，该接口还需要以下请求头：

名称	描述	是否必选
Content-MD5	Body里Data的128位MD5 Digest，再用Base64编码。该请求头用于数据完整性校验，检查Body是否损坏。详见RFC-1864 类型：String 默认值：无	是

名称

描述

是否必选

Content-MD5

Body里Data的128位MD5 Digest，再用Base64编码。该请求头用于数据完整性校验，检查Body是否损坏。详见RFC-1864

类型：String
默认值：无

是

请求体

请求体为一段描述回收站规则（RetentionConfiguration）的XML，请求体中包含的元素有：

名称	描述	是否必填
RetentionConfiguration	包含回收站规则的容器。类型：Container 父节点：无子节点: Rule	是
Rule	包含一条回收站具体规则的容器。类型：Container 父节点：RetentionConfiguration	是
Status	回收站的开启状态，不区分大小写。类型：String 父节点：Rule 子节点：无有效值：Enabled、Disabled。Enabled表示开启回收站，Disabled表示关闭回收站	是
Days	指定Object进入回收站多少天后彻底删除。当不设置Days时，Object删除后将在回收站中永远保留。类型：正整数取值范围：1-365 父节点：Rule 子节点：无	否

响应

响应头

该接口仅返回公共响应头。

响应体

该接口不返回响应体。

示例

请求示例

PUT /?retention HTTP/1.1 
Host: ks3-example.ks3-cn-beijing.ksyun.com 
Date: Wed, 14 May 2021 02:11:21 GMT 
Content-MD5: 3A2M2Y4AsgTpgAmY8PhC****
Authorization: authorization string 
Content-Length: 1000 
Content-type: application/xml   
<RetentionConfiguration>  
	<Rule>      
		<Status>Enabled</Status>    
		<Days>90</Days>  
	</Rule> 
</RetentionConfiguration>

响应示例

HTTP/1.1 200 OK 
Content-Length: 1000 
Date: Fri, 26 Dec 2023 06:38:43 GMT
x-kss-request-id: 64a47bda18ac4e6e91de369add54218e
Server: KS3

注：如使用AWS签名，将同时返回x-amz-request-id和x-kss-request-id。

错误码

错误码	HTTP状态码	描述
MalformedXML	400	未填写必填项（XML格式不合法）。
InvalidArgument	400	设置回收站规则时，删除时间Days不正确，不是1-365的正整数。
AccessDenied	403	没有操作权限。仅支持Bucket Owner和拥有`ks3:PutBucketRetention`权限的用户设置回收站规则。
NoSuchBucket	404	指定设置回收站的Bucket不存在。

文档导读

上一篇：回收站（Retention）

下一篇：GET Bucket Retention

纯净模式常规模式

纯净模式

点击可全屏预览文档内容