You need to enable JavaScript to run this app.
导航
云数据库 MySQL 版
  • 文档首页
    • /
  • 云数据库 MySQL 版

RestoreToExistedInstance

最近更新时间：2023.12.04 18:15:33

首次发布时间：2023.02.02 17:41:22

我的收藏

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

请求类型

异步请求。

请求参数

名称类型是否必选示例值描述
SourceDBInstanceIdString是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 参数二者必选其一。

RestoreTypeString否TABEL_LEVEL表示恢复的类型。可选值：TABLE_LEVEL，库表级恢复。

TableMeta

Array of TableMetaObject

否

[
  {
    "DBName" : "db",
    "NewDBName" : "db_new",
    "Table":
      [
        {
          "TableName" : "table",
          "NewTableName" : "table_new"
        }
      ]
  }
]

进行库表恢复时，指定恢复的库表信息。
当 RestoreType 为 TABLE_LEVEL 时，该参数必选。
更多关于 TableMeta 的详细信息，请参见数据结构。

返回参数

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=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZjMzY/20211202/cn-beijing/rds_mysql/request, SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645aff88

{
    "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
}

错误码

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