調用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參數為可選。

说明 BackupId和RestoreTime兩者至少傳入一個。
RestoreTime String 否 2011-06-11T16:00:00Z

備份保留周期內的任意時間點。格式：yyyy-MM-ddTHH:mm:ssZ（UTC時間）。

指定此參數時，DBInstanceId參數為必須。

说明 BackupId和RestoreTime兩者至少傳入一個。
VPCId String 否 vpc-xxxxxxxxxxx

VPC ID。
VSwitchId String 否 vsw-xxxxxxxxxxx

VSwitch ID，多個值用英文逗號（,）隔開。
PrivateIpAddress String 否 vpc-xxxxxxxxxxx

設定執行個體的內網IP，需要在指定交換器的IP位址範圍內。系統預設通過VPCId和VSwitchId自動分配。

Period String 否 Prepaid

指定預付費執行個體為包年或者包月類型，取值：

  • Year：包年；
  • Month：包月。
说明 若付費類型為Prepaid則該參數必須傳入。
UsedTime String 否 Prepaid

指定購買時間長度，取值：

  • 當參數Period為Year時，UsedTime取值為1~3；
  • 當參數Period為Month時，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"
}

錯誤碼

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