RestoreToExistedInstance--云数据库 MySQL 版-火山引擎

文档中心

立即注册

导航

RestoreToExistedInstance

最近更新时间：2024.11.05 16:00:07首次发布时间：2023.02.02 17:41:22

调用 RestoreToExistedInstance 接口将数据恢复到一个已有数据库实例。

请求类型

异步请求。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数	类型	是否必选	示例值	描述
SourceDBInstanceId	String	是	mysql-e7fda57b****	备份数据所属的源实例的 ID。
BackupId	String	否	effc1de81b8a4c8e886fef2c3e06****	备份文件 ID。通过调用 DescribeBackups 可查询 BackupID。说明该参数与 RestoreTime 参数二者必选其一。仅支持通过物理备份恢复到原实例。
RestoreTime	String	否	2022-01-01T10:10:10Z	源实例备份保留周期内的任意时间点，格式为yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。通过调用 DescribeRecoverableTime 可查询该时间点是否支持还原。说明该参数与 BackupId 参数二者必选其一。
RestoreType	String	否	TABLE_LEVEL	表示恢复的类型。可选值：`TABLE_LEVEL`，库表级恢复。
TableMeta	Object[]	否	[ { "DBName" : "db", "NewDBName" : "db_new", "Table": [ { "TableName" : "table", "NewTableName" : "table_new" } ] } ]	进行库表恢复时，指定恢复的库表信息。当 RestoreType 为 `TABLE_LEVEL` 时，该参数必选。

返回参数

null

示例

请求示例

POST /?Action=RestoreToExistedInstance&Version=2022-01-01 HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: rds.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****
{
    "SourceDBInstanceId": "mysql-c8cfcccd****",
    "BackupId": "effc1de81b8a4c8e886fef2c3e06****",
    "RestoreType": "TABLE_LEVEL",
    "TableMeta": [
        {
            "DBName": "db",
            "NewDBName": "db_new",
            "Table": []
        }
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2023120412152879A7CDBA12D1A212B90D",
        "Action": "RestoreToExistedInstance",
        "Version": "2022-01-01",
        "Service": "rds_mysql",
        "Region": "cn-beijing"
    },
    "Result": null
}

错误码

更多详情，请参见错误码。