设置生命周期

最近更新时间:2023-02-03 11:05:11

接口描述

  • 接口名称: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=