文档

设置数据时效

更新时间:
一键部署

设置数据时效

请求路径和方法

请求路径 请求方法 描述
/api/ttl POST 设置 TTL

请求内容

名称 类型 是否必需 描述 举例
val Integer 设置 ttl 的值,以秒为单位,大于等于1,小于等于2147483647(Integer.MAX_VALUE)

高可用版本中允许设置的最小值为3600,设置小于3600的值会报错; 允许设置的最大值为2147483647,表示的含义为”无数据时效”,设置超过2147483647的值仍然会被视作2147483647.
7776000

请求 JSON 示例

任务:设置数据时效为 90 天

请求: POST/api/ttl

请求体:

  1. { "val": 7776000 }

响应说明

200 表示成功,其他返回码表示失败,错误信息参见公共响应状态码

数据时效说明

  1. 此处设置的数据时效的计算不是对数据自身带入的时间戳为基准进行计算,而是基于数据实际写入到数据库的时间为基准进行计算。
  2. 数据在数据库中的时间超过设置的数据时效后并不会立刻失效,而是会由数据库后台慢慢自行清理。
  3. 数据失效时,数据所属的时间线并不会随之失效。对于早已不活跃的时间线可能需要主动调用删除接口进行清理。

 

获取数据时效

请求路径和方法

请求路径 请求方法 描述
/api/ttl GET 查询数据时效

请求内容

无需请求实体

响应说明

200 表示成功,其他返回码表示失败,错误信息参见公共响应状态码

返回 JSON 举例:

  1. { "val": 7776000 }

val 的值即为 ttl 的值,秒为单位。