创建生命周期
接口描述
在当前公司的云备份周期下创建一个数据保留策略容器（生命周期），用于定义设备云备份数据的保留天数和容量上限。
请求说明
| 接口ID |
协议 |
方法 |
PATH |
| 70 |
HTTPS |
POST |
/openapi/v1/cbs/user/pools/current/lifecycles |
PATH参数
无
URL参数
| 参数 |
类型 |
必填 |
说明 |
| accesskey_id |
string |
是 |
参见签名认证 |
| expires |
int |
是 |
参见签名认证 |
| signature |
string |
是 |
参见签名认证 |
HTTP请求头
| 字段 |
值 |
| Content-Type |
application/json |
请求参数
请求参数以Json格式放置于Body中，字段如下：
| 参数 |
类型 |
必填 |
说明 |
| name |
string |
是 |
生命周期名称（1-64 字符），同一周期下名称不可重复，首尾空白会被去除 |
| retention_days |
int |
是 |
数据保留天数（1-365） |
| capacity_limit |
int |
否 |
容量上限（字节），0 表示不限，默认为 0 |
请求示例
POST https://open.vzicloud.com/openapi/v1/cbs/user/pools/current/lifecycles?accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D HTTP/1.1
Host: open.vzicloud.com
Content-Type: application/json
{
"name": "默认生命周期",
"retention_days": 30,
"capacity_limit": 5368709120
}
返回说明
返回参数
| 参数 |
类型 |
说明 |
| id |
int |
生命周期 ID |
| name |
string |
生命周期名称 |
| retention_days |
int |
数据保留天数 |
| capacity_limit |
int |
容量上限（字节） |
| create_time |
string |
创建时间 |
| update_time |
string |
更新时间 |
返回示例
{
"id": 2001,
"name": "默认生命周期",
"retention_days": 30,
"capacity_limit": 5368709120,
"create_time": "2026-06-24 10:00:00",
"update_time": "2026-06-24 10:00:00"
}