库级时间点恢复

功能介绍

库级时间点恢复。

• 调用接口前，您需要了解API 认证鉴权。

调试

您可以在API Explorer中调试该接口。

接口约束

• 该接口仅支持MySQL和PostgreSQL引擎。
• 不支持含Json虚拟列的表所在的库进行库级恢复。
• 不支持原库名含中文的库进行库级恢复。
• 存在XA事务，不支持极速恢复。

URI

• URI格式

  POST /v3/{project_id}/instances/batch/restore/databases

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	租户在某一Region下的项目ID。 获取方法请参见获取项目ID。

请求消息

请求示例

RDS for MySQL实例恢复指定库到指定时间点。

POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/batch/restore/databases
{
  "instances" : [ {  
     "instance_id" : "5d742eda6e574ff3a003191638ef8c51in01",  
     "restore_time" : 1699323939000,  
     "databases" : [ {  
       "old_name" : "dbtest",  
       "new_name" : "dbtest_restore"  
     } ]  
   } ]  
}

响应消息

• 正常响应要素说明

  表5 要素说明

  名称	参数类型	说明
  restore_result	Array of objects	库级时间点恢复任务信息。详细说明请参见表6。

  表6 restore_result字段数据结构说明

  参数	参数类型	描述
  instance_id	String	实例ID。
  job_id	String	工作流ID。

• 正常响应样例

  RDS for MySQL实例恢复指定库到指定时间点：

  {  
     "restore_result" : [ {  
       "instance_id" : " 5d742eda6e574ff3a003191638ef8c51in01",  
       "job_id" : "749d6254-f4f0-4f72-aa32-876e220d2496"  
     } ]  
   }

• 异常响应

  请参见异常请求结果。

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。