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

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

调试

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

请求参数

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

系统规定参数，取值：RestoreInstance。

InstanceId String 是 r-bp1zxszhcgatnx****

实例ID。
RegionId String 否 cn-hangzhou

实例所属地域的ID，您可以调用DescribeInstanceAttribute接口查询。

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，系统将匹配hllo或heeeello等字符串。
  • 传入本参数时，要求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格式 

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

JSON格式 

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

错误码

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