調用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"}]}] |
進行庫表恢複時,指定恢複的庫表資訊。格式:
|
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"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。