调用RecoveryDBInstance接口恢复数据库。

恢复数据库,分为恢复到已有实例和恢复到新实例两种业务场景。

  • 恢复到已有实例:支持将原实例中的部分库,恢复到已有实例中(可以是原实例或者同地域其他实例),若库名重复则必须要用新库名,即不支持覆盖性恢复原库。
  • 恢复到新实例:先创建一个新实例,再在新实例上恢复原实例中的全部或者部分数据库。
    • 若指定数据库名,则新实例只恢复对应的数据库(部分恢复)。
    • 若不指定数据库名,则新实例会恢复原实例上的所有数据库。
说明 该接口暂时仅适用于SQL Server 2012及以上版本的实例。

调试

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

请求参数

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

系统规定参数,取值为:RecoveryDBInstance

DbNames String {sourceDbName1":"targetDbName1"}

数据库名,若指定多个数据库,按如下格式:{"原库名1":"新库名1","原库名2":"新库名2"}

说明 恢复到已有实例该参数必须传入。
TargetDBInstanceId String rm-uf6wjk5xxxxxxx

目标实例ID。

DBInstanceClass String rds.mysql.s2.large

新实例规格,详见实例规格

DBInstanceStorage Integer 5

新实例存储容量。

PayType String Postpaid

新实例付费类型:

  • Postpaid:后付费(按量付费);
  • Prepaid:预付费,(包年包月)。
InstanceNetworkType String VPC

新实例网络类型:

  • Classic:经典网络;
  • VPC:专有网络。

默认与主实例网络类型一致。

DBInstanceId String rm-xxxxxxxx1

原实例ID。

说明
  • 按备份集恢复(即指定BackupId参数)时,本参数不是必须。
  • 按时间点恢复(即指定RestoreTime参数)时,本参数为必须。
BackupId String 293044600

备份集ID,可通过查询备份列表接口DescribeBackups获取。

指定此参数时,DBInstanceId参数为可选。

说明 BackupIdRestoreTime两者至少传入一个。
RestoreTime String 2011-06-11T16:00:00Z

备份保留周期内的任意时间点。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

指定此参数时,DBInstanceId参数为必须。

说明 BackupIdRestoreTime两者至少传入一个。
VPCId String vpc-xxxxxxxxxxx

VPC ID。

VSwitchId String vsw-xxxxxxxxxxx

VSwitch ID,多个值用英文逗号(,)隔开。

PrivateIpAddress String vpc-xxxxxxxxxxx

设置实例的内网IP,需要在指定交换机的IP地址范围内。系统默认通过VPCIdVSwitchId自动分配。

Period String Prepaid

指定预付费实例为包年或者包月类型,取值:

  • Year:包年;
  • Month:包月。
说明 若付费类型为Prepaid则该参数必须传入。
UsedTime String Prepaid

指定购买时长,取值:

  • 当参数PeriodYear时,UsedTime取值为1~3
  • 当参数PeriodMonth时,UsedTime取值为1~9
说明 若付费类型为Prepaid则该参数必须传入。

返回数据

名称 类型 示例值 描述
DBInstanceId String rm-xxxxxxx

实例名。

OrderId String 543254874

订单ID。

RequestId String EFB6083A-7699-489B-8278-C0CB4793A96E

请求ID。

示例

请求示例


http(s)://rds.aliyuncs.com/?Action=RecoveryDBInstance
&TargetDBInstanceId=rm-uf6wjk5xxxxxxx
&DbNames="sourceDbName":"targetDbName"
&BackupId=293044600
&<公共请求参数>

正常返回示例

XML 格式

<RecoveryDBInstanceResponse>
	  <RequestId>EFB6083A-7699-489B-8278-C0CB4793A96E</RequestId></RecoveryDBInstanceResponse>

JSON 格式

{
	"RequestId":"EFB6083A-7699-489B-8278-C0CB4793A96E"
}

错误码

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