设置数据时效
设置数据时效
请求路径和方法
请求路径 | 请求方法 | 描述 |
---|---|---|
/api/ttl | POST | 设置 TTL |
请求内容
名称 | 类型 | 是否必需 | 描述 | 举例 |
---|---|---|---|---|
val | Integer | 是 | 设置 ttl 的值,以秒为单位,大于等于1,小于等于2147483647(Integer.MAX_VALUE) 高可用版本中允许设置的最小值为3600,设置小于3600的值会报错; 允许设置的最大值为2147483647,表示的含义为”无数据时效”,设置超过2147483647的值仍然会被视作2147483647. |
7776000 |
请求 JSON 示例
任务:设置数据时效为 90 天
请求: POST/api/ttl
请求体:
{ "val": 7776000 }
响应说明
200 表示成功,其他返回码表示失败,错误信息参见公共响应状态码。
数据时效说明
- 此处设置的数据时效的计算不是对数据自身带入的时间戳为基准进行计算,而是基于数据实际写入到数据库的时间为基准进行计算。
- 数据在数据库中的时间超过设置的数据时效后并不会立刻失效,而是会由数据库后台慢慢自行清理。
- 数据失效时,数据所属的时间线并不会随之失效。对于早已不活跃的时间线可能需要主动调用删除接口进行清理。
获取数据时效
请求路径和方法
请求路径 | 请求方法 | 描述 |
---|---|---|
/api/ttl | GET | 查询数据时效 |
请求内容
无需请求实体
响应说明
200 表示成功,其他返回码表示失败,错误信息参见公共响应状态码。
返回 JSON 举例:
{ "val": 7776000 }
val 的值即为 ttl 的值,秒为单位。