更新时间:2022-03-10 GMT+08:00

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

功能介绍

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

接口约束

  • 恢复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"
    }
  • 异常响应

    请参见异常请求结果

状态码

请参见状态码

错误码

请参见错误码