调用RestoreInstance将备份文件中的数据恢复到当前Redis实例中,结合数据闪回更可实现将指定的Key恢复至某个秒级时间点。

说明
  • 当您的实例为内存型,且已开启了数据闪回,您可以调用本接口将指定Key的数据恢复至某个秒级时间点,其他的Key不受影响,可实现更精细化的数据恢复。
  • 内存型以外的实例,调用本接口会使用备份数据覆盖Redis实例的现有数据,存在较大风险,请务必谨慎操作。 推荐调用CreateInstance接口,将备份数据恢复至新实例中。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String RestoreInstance

系统规定参数。取值:RestoreInstance

InstanceId String r-bp1zxszhcgatnx****

实例ID。

BackupId String 78241****

备份文件ID。您可以调用DescribeBackups查询。

RestoreType String 1

恢复类型,取值:

  • 0:默认值,恢复指定的备份集。
  • 1:恢复至指定的时间点,仅当实例开启了数据闪回功能时,您才可以传入该值。传入为该值时,您还需要传入RestoreTime参数。
RestoreTime String 2021-07-06T07:25:57Z

要恢复的时间点,格式为yyyy-MM-ddTHH:mmZ(UTC时间)。

说明
  • 当实例开启了数据闪回后,您可以传入本参数和FilterKey参数实现将指定Key的数据恢复至某个时间点(秒级),其他的Key不受影响,可实现更精细化的数据恢复。
  • 传入本参数时,要求RestoreType参数传入的值为1
FilterKey String key:00000007198*

指定要恢复的Key,支持正则表达式,多个值使用英文逗号(,)分隔。

说明
  • 例如正则表达式中,星号(*)表示匹配前面子表达式任意次,本参数传入h.*llo,系统将匹配hlloheeeello等字符串。
  • 传入本参数时,要求RestoreType参数传入的值为1

返回数据

名称 类型 示例值 描述
RequestId String 8D0C0AFC-E9CD-47A4-8395-5C31BF9B****

请求ID。

示例

请求示例

http(s)://r-kvstore.aliyuncs.com/?Action=RestoreInstance
&InstanceId=r-bp1zxszhcgatnx****
&RestoreType=1
&RestoreTime=2021-07-06T07:25:57Z
&FilterKey=key:00000007198*
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RestoreInstanceResponse>
    <RequestId>8D0C0AFC-E9CD-47A4-8395-5C31BF9B****</RequestId>
</RestoreInstanceResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "8D0C0AFC-E9CD-47A4-8395-5C31BF9B****"
}

错误码

访问错误中心查看更多错误码。