用 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 版支持通过 appendonly-switch 参数设置 AOF 持久化功能，但 AOF 持久化功能和数据闪回功能存在约束关系，其中：

  • 当参数 appendonly-switch 取值为 off 时，不允许开启数据闪回功能。
  • 当数据闪回功能开启时，不允许将 appendonly-switch 取值调整为 off 。

  关于 appendonly-switch 参数的更多详情，请参见参数支持。

请求参数

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

示例

请求示例

POST https://redis.volcengineapi.com/?Action=StartContinuousBackup&Version=2020-12-07 HTTP/1.1
Host: redis.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-cn0212gzmh2xs****"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2022112411414201022514515203F7****",
        "Action": "StartContinuousBackup",
        "Version": "2020-12-07",
        "Service": "Redis",
        "Region": "cn-beijing"
    },
    "Result": null
}

错误码

更多详情，请参见错误码。