- 文档首页
缓存数据库 Redis 版
开发参考(控制面)
API 参考
备份恢复
StartContinuousBackup
备份恢复
StartContinuousBackup
StartContinuousBackup
调用 StartContinuousBackup 接口开启目标 Redis 实例的数据闪回功能。
请求类型
同步请求。
注意事项
- 仅主备实例(即 InstanceClass 为 PrimarySecondary )支持调用该接口,单节点实例(即 InstanceClass 取值为 Standalone )不支持备份恢复相关操作,不支持调用该接口。关于两种类型实例的功能特性差异详情,请参见功能特性差异。
- 开启闪回功能后,系统需要一些时间进行一次全量备份,备份所需时长与数据量有关。建议开启数据闪回功能后,先等一段时间待全量备份完成后再使用按时间点恢复功能。
- 可恢复的时间点范围在数据闪回功能开启的时间点和当前时间点之间,最早可恢复至距离当前时间点 7 天前的时间。
- 若当前时间点为 2024-01-18 06:00:00,数据闪回功能开启的时间点为 2024-01-10 10:00:00 ,那么可恢复的时间点范围为 2024-01-11 06:00:00 ~ 2024-01-18 06:00:00。
- 若当前时间点为 2024-01-18 06:00:00,数据闪回功能开启的时间点为 2024-01-12 10:00:00,那么可恢复的时间点范围为 2024-01-12 10:00:00 ~ 2024-01-18 06:00:00。
- 开启数据闪回后,执行部分操作时会对数据闪回功能带来一定影响,其中:
- 执行变更实例配置、修改可用区或系统维护相关操作(如升级内核版本、机器软硬件、网络等)操作,会导致数据闪回功能自动关闭。数据闪回功能关闭后,之前的闪回时间点不再保留。
缓存数据库 Redis 版提供了事件中心功能,支持通过计划内事件对指定实例所在的机器进行软硬件或网络升级等系统维护相关操作,来保障数据库云服务的稳定性和可持续性。更多详情,请参见事件中心。 - 缓存数据库 Redis 版支持通过 appendonly-switch 参数设置 AOF 持久化功能,但 AOF 持久化功能和数据闪回功能存在约束关系,其中:
- 当参数 appendonly-switch 取值为 off 时,不允许开启数据闪回功能。
- 当数据闪回功能开启时,不允许将 appendonly-switch 取值调整为 off。
- 关于 appendonly-switch 参数的更多详情,请参见参数支持。
调试
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
请求参数
返回参数
示例
请求示例
POST https://redis.cn-beijing.volcengineapi.com/?Action=StartContinuousBackup&Version=2020-12-07 HTTP/1.1
Host: redis.cn-beijing.volcengineapi.com
Content-Type: application/json; charset=utf-8
X-Date: 20201103T104027Z
Authorization: HMAC-SHA256 Credential=AK****/20201103/cn-beijing/Redis/request,SignedHeaders=content-type;host;x-date,Signature=****
"InstanceId":"redis-cn0212gzmh2xsh2xs"
返回示例
"RequestId": "2022112411414201022514515203F703F7",
"Action": "StartContinuousBackup",
"Version": "2020-12-07",
错误码
最近更新时间:2026.09.21 14:23:31