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

对象存储(KS3)

查看更多结果

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

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

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

描述

该接口用于获取Bucket回收站配置规则，使用此接口的用户，必须是该Bucket的所有者或具有ks3:GetBucketRetention权限。

请求

请求语法

GET /?retention HTTP/1.1 
Host: {BucketName}.{endpoint} 
Date: {date} 
Authorization: {SignatureValue}

请求参数

该接口不使用请求参数。

请求头

该接口仅使用公共请求头。

请求体

该接口不使用请求体。

响应

响应头

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

响应体

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

名称	描述
RetentionConfiguration	包含回收站规则的容器。类型：Container 父节点：无子节点: Rule
Rule	包含一条回收站具体规则的容器。类型：Container 父节点：RetentionConfiguration
Status	回收站的开启状态。类型：String 父节点：Rule 子节点：无有效值：Enabled、Disabled。Enabled表示开启回收站，Disabled表示关闭回收站。关闭回收站之后再删除的Object将不再进入回收站，但关闭回收站之前已经存在回收站中的Object，将按照原来的规则执行。
Days	表示Object进入回收站多少天后彻底删除。类型：正整数父节点：Rule 子节点：无

示例

请求示例

GET /?retention HTTP/1.1 
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Fri, 26 Dec 2023 06:38:43 GMT
Authorization: authorization string

响应示例

HTTP/1.1 200 OK 
Content-Type: application/xml 
Content-Length: 312 
Date: Fri, 26 Dec 2023 06:38:43 GMT
Server: KS3
x-kss-request-id: 54a47bda18ac4e6e91de369add54218e

<RetentionConfiguration>  
	<Rule>      
		<Status>Enabled</Status>    
		<Days>90</Days>  
	</Rule> 
</RetentionConfiguration>

错误码

错误码(code)	HTTP状态码	描述
AccessDenied	403	没有操作权限。仅支持Bucket Owner和拥有`ks3:GetBucketRetention`权限的用户获取回收站规则
NoSuchBucket	404	不存在该Bucket

文档导读

上一篇：PUT Bucket Retention

下一篇：LIST Retention

纯净模式常规模式

纯净模式

点击可全屏预览文档内容