接口描述
- 接口名称：PutCofferLifecycle
- 接口功能：该接口用于为数据保险箱创建一个新的生命周期配置，以设置过期时间。如果该数据保险箱已配置生命周期，使用该接口创建新配置的同时则会覆盖原有配置。
请求
请求示例
PUT /<CofferName-APPID>?lifecycle HTTP/1.1
Host: service.cdcs.myqcloud.com
Content-Length: length
Date: GMT Date
Authorization: Auth String
Content-MD5: MD5说明：Authorization: Auth String 详情，请参见 请求签名 文档。
请求头
公共头部
该请求操作的实现使用公共请求头部，详情请参见 公共请求头部 文档。
非公共头部
注意：以下头部为必选头部。
该请求操作的实现使用如下必选头部：
| 名称 | 是否必选 | 类型 | 描述 |
|---|---|---|---|
| Content-MD5 | 是 | String | RFC 1864中定义的经过 Base64 编码的请求体内容 MD5 哈希值，用于完整性检查，验证请求体在传输过程中是否发生变化。 |
请求体
该 API 接口请求的请求体具体节点内容为：
{
"Rule": [{
"Expiration": {
"Days": 30
}
}]
}具体内容描述如下：
| 节点名称（关键字） | 是否必选 | 类型 | 描述 |
|---|---|---|---|
| Rule | 是 | Object | 规则描述。 |
| Expiration | 否 | Object | 规则过期属性。 |
| Days | 否 | Integer | 指明对象在上传后多少天删除：该字段有效值为正整数，最大支持3650天。 |
响应
响应头
此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。
响应体
该响应体返回为空。
错误码
以下描述此请求可能会发生的特殊且常见的错误情况，具体的错误原因可参考返回的 message 进行排查。获取更多关于数据保险箱的错误码信息，或者产品所有的错误列表，请参见 错误码 文档。
| 错误码 | HTTP 状态码 | 描述 |
|---|---|---|
| NoSuchCoffer | 404 Not Found | 访问的数据保险箱不存在。 |
| MalformedXML | 400 Bad Request | XML 格式不合法。 |
| InvalidArgument | 400 Bad Request | 请求参数不合法。 |
示例
请求
PUT /examplecoffer-1250000000?lifecycle HTTP/1.1
Host:service.cdcs.myqcloud.com
Date: Wed, 16 Aug 2017 11:59:33 GMT
Authorization: [Auth String]
Content-MD5: LcNUuow8OSZMrEDnvndw1Q==
Content-Length: 348
Content-Type: application/x-www-form-urlencoded
{
"Rule": [{
"Expiration": {
"Days": 10
}
}]
}响应
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 0
Date: Wed, 16 Aug 2017 11:59:33 GMT
Server: tencent-cdcs
x-cdcs-request-id: NTk5NDMzYTRfMjQ4OGY3Xzc3NGRfMWY=