調用RestoreTable介面恢複RDS執行個體的某個資料庫或表到原執行個體上。

RDS for MySQL支援單庫和單表的資料恢複，可以通過備份指定恢複誤刪的資料庫或表，快速恢複MySQL的資料。詳情請參見單庫單表備份。

調用該介面時，執行個體必須滿足以下條件，否則將操作失敗：

  • 執行個體版本為MySQL 5.7 高可用版（本地SSD盤）或MySQL 5.6高可用版；
  • 執行個體狀態為運行中；
  • 執行個體當前沒有正在執行的遷移任務；
  • 如果需要按時間點恢複，執行個體必須開啟記錄備份；
  • 執行個體已開啟單庫單表備份，並且開啟後已建立新的備份；
  • 恢複後的表名在執行個體中不存在。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱 類型 是否必選 樣本值 描述
Action String 是 RestoreTable

系統規定參數，取值：RestoreTable。

DBInstanceId String 是 rm-uf6wjk5xxxxxxxxxx

執行個體ID。
BackupId String 否 9026262

備份組ID。

您可以通過DescribeBackups介面擷取備份組列表。

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

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

说明 BackupId和RestoreTime兩者至少傳入一個。
TableMeta String 否 [{"type":"db","name":"testdb1","newname":"testdb1_new","tables":[{"type":"table","name":"testdb1table1","newname":"testdb1table1_new"}]}]

進行庫表恢複時，指定恢複的庫表資訊。格式：

[{"type":"db","name":"<資料庫1名稱>","newname":"<新資料庫1名稱>","tables":[{"type":"table","name":"<資料庫1內的表1名稱>","newname":"<新的表1名稱>"},{"type":"table","name":"<資料庫1內的表2名稱>","newname":"<新的表2名稱>"}]},{"type":"db","name":"<資料庫1名稱>","newname":"<新資料庫2名稱>","tables":[{"type":"table","name":"<資料庫2內的表3名稱>","newname":"<新的表3名稱>"},{"type":"table","name":"<資料庫2內的表4名稱>","newname":"<新的表4名稱>"}]}]
AccessKeyId String 否 LTAIfCxxxxxxx

阿里雲頒發給使用者的訪問服務所用的密鑰ID。
ClientToken String 否 ETnLKlblzczshOTUbOCzxxxxxxxxxx

用於保證請求的等冪性，防止重複提交請求。由用戶端產生該參數值，要保證在不同請求間唯一，最大值不超過64個ASCII字元，且該參數值中不能包含非ASCII字元。

返回資料

名稱 類型 樣本值 描述
RequestId String EA2D4F34-01A7-46EB-A339-D80882135206

請求ID。

樣本

請求樣本


http(s)://rds.aliyuncs.com/?Action=RestoreTable
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&RestoreTime=2019-08-20T16:00:00Z
&TableMeta=[{"type":"db","name":"dtstestdata","newname":"dtstestdata","tables":[{"type":"table","name":"customer_old","newname":"customer_old123"},{"type":"table","name":"order","newname":"order123"}]}]
&<公用請求參數>

正常返回樣本

XML 格式 

<RestoreTableResponse>
  <RequestId>EA2D4F34-01A7-46EB-A339-D80882135206</RequestId>
</RestoreTableResponse>

JSON 格式 

{
	"RequestId":"EA2D4F34-01A7-46EB-A339-D80882135206"
}

錯誤碼

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