恢复到已有实例或当前实例

功能介绍

该章节介绍如何将数据库恢复到已有实例或当前实例。

• 调用接口前，您需要了解API 认证鉴权。
• 调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

接口约束

• 恢复SQL Server单个数据库到已有实例时，支持批量执行。
• 该接口不支持PostgreSQL数据库实例。

URI

• URI格式

  POST https://{Endpoint}/v3/{project_id}/instances/recovery

• URI样例

  https://{Endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/recovery

• 参数说明

  表1 参数说明

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

请求消息

• 参数说明

  表2 参数说明

  名称	是否必选	参数类型	说明
  source	是	Object	恢复数据源对象。 详情请参见表3。
  target	是	Object	恢复目标对象。 详情请参见表4。

  表3 source字段数据结构说明

  名称	是否必选	参数类型	说明
  instance_id	是	String	实例ID。
  type	否	String	表示恢复方式，枚举值： “backup”，表示使用备份文件恢复，按照此方式恢复时，“type”字段为非必选，“backup_id”必选。 “timestamp”，表示按时间点恢复，按照此方式恢复时，“type”字段必选，“restore_time”必选。
  backup_id	否	String	用于恢复的备份ID。当使用备份文件恢复时需要指定该参数。
  restore_time	否	Integer	恢复数据的时间点，格式为UNIX时间戳，单位是毫秒，时区为UTC。

  表4 target字段数据结构说明

  名称	是否必选	参数类型	说明
  instance_id	是	String	恢复目标实例ID。

• 请求样例

  使用备份文件恢复：

  {
  	"source": {
  		"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01",
  		"type": "backup",
  		"backup_id": "2f4ddb93-b901-4b08-93d8-1d2e472f30fe"
  	},
  	"target": {
  		"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01"
  	}
  }

  按时间点恢复：

  {
  	"source": {
  		"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01",
  		"type": "timestamp",
  		"restore_time": 1532001446987
  	},
  	"target": {
  		"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01"
  	}
  }

响应消息

• 正常响应要素说明

  表5 要素说明

  名称	参数类型	说明
  job_id	String	本次任务的ID。

• 正常响应样例

  {
  	"job_id": "ff80808157127d9301571bf8160c001d"
  }

• 异常响应

  请参见异常请求结果。

状态码

请参见状态码。

错误码

请参见错误码。