調用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"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。