PUT Object Retention

Recent Pages

PUT Object Retention

最后更新时间：2024-02-27 10:18:06

功能描述
该接口用于为对象设置锁定模式和保留期限。
请求
请求示例
PUT /<object-key>?retention HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String 
说明：
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com，其中 <BucketName-APPID> 为带 APPID 后缀的存储桶名字，例如 examplebucket-1250000000，可参阅 存储桶概览 > 基本信息 和 存储桶概述 > 存储桶命名规范 文档；<Region> 为 COS 的可用地域，可参阅 地域和访问域名 文档。
Authorization: Auth String（详情请参见 请求签名 文档）。
请求头
此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。
请求体
<Retention>
    <Mode>COMPLIANCE</Mode>
    <RetainUntilDate>timestamp</RetainUntilDate>
</Retention> 
具体数据描述如下：
节点名称（关键字）
父节点
描述
类型
是否必选
Retention
无
周期
Container
是
Mode
Retention
对象锁定模式，仅支持枚举值 COMPLIANCE
Enum
是
RetainUntilDate
Retention
具体到期日期
String  Date
是
响应
响应头
此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。
响应体
该请求的响应体为空。
错误码
此接口遵循统一的错误响应和错误码，详情请参见 错误码 文档。
实际案例
请求
PUT /temp.txt?retention HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Authorization: Auth String
﻿
<Retention>
    <Mode>COMPLIANCE</Mode>
    <RetainUntilDate>2022-12-10T08:34:48.000Z</RetainUntilDate>
</Retention>
响应
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 87
Connection: keep-alive
Date: Fri, 09 Dec 2022 08:35:49 GMT
Server: tencent-cos
x-cos-request-id: NjM5MmYzNjVfMjBkMDM4MGJfMWM2ND****
﻿
﻿

联系我们

联系我们，为您的业务提供专属服务。

技术支持

如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

7x24 电话支持

tencent cloud

Recent Pages

PUT Object Retention

功能描述

请求

请求示例

请求头

请求体

响应

响应头

响应体

错误码

实际案例

请求

响应

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？

节点名称（关键字）	父节点	描述	类型	是否必选
Retention	无	周期	Container	是
Mode	Retention	对象锁定模式，仅支持枚举值 `COMPLIANCE`	Enum	是
RetainUntilDate	Retention	具体到期日期	String Date	是

tencent cloud

注册

登录

Recent Pages

PUT Object Retention

功能描述

请求

请求示例

请求头

请求体

响应

响应头

响应体

错误码

实际案例

请求

响应

本页内容是否解决了您的问题？

本页内容是否解决了您的问题？