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

RestoreToExistedInstance

最近更新时间：2023.12.28 15:27:52

首次发布时间：2023.08.25 11:59:39

我的收藏

调用 RestoreToExistedInstance 接口以数据库为单位，恢复数据到已有实例。

注意事项

根据实例兼容版本的不同，在数据恢复时存在以下限制：

  • 当原实例为 Web 版实例即 DBEngineVersion 取值为 SQLServer_2019_Web时，支持将实例还原至企业版、标准版或 Web 版实例即 DBEngineVersion 取值为 SQLServer_2019_Std、SQLServer_2019_Ent 或 SQLServer_2019_Web。

  • 当原实例为标准版实例即 DBEngineVersion 取值为 SQLServer_2019_Std 时，支持将实例还原至企业版、标准版实例即 DBEngineVersion 取值为 SQLServer_2019_Std 或 SQLServer_2019_Ent。

  • 当原实例为企业版实例即 DBEngineVersion 取值为 SQLServer_2019_Ent时，支持将实例还原至企业版实例即 DBEngineVersion 取值为 SQLServer_2019_Ent。

请求类型

异步请求。

请求参数

名称类型是否必选示例值描述

SourceDBInstanceId

String

是

mssql-bbe31c86****

源实例 ID。

说明

您可以调用 DescribeDBInstances 接口查询实例 ID。

TargetDBInstanceId

String

是

mssql-bbe31c86****

目标实例 ID。

说明

  • 您可以调用 DescribeDBInstances 接口查询实例 ID。

  • 若与源实例 ID 相同则为恢复到源实例。

Databases

Array of DatabasesObject

是

DatabasesObject

待恢复的数据库信息。

说明

最多可传入 100 个数据库信息。

BackupId

String

否

f569f53bf60a48d5b82c8685b7a8****

源实例备份集 ID。

说明

  • 按备份集恢复数据库时，您可以通过调用 DescribeBackups 查询BackupId。

  • BackupId 和 RestoreTime 传入一个即可。

RestoreTime

String

否

2023-08-23T08:04:59Z

按时间点恢复数据库，可以选择备份保留周期内的任意时间点。格式：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。

说明

BackupId 和 RestoreTime 传入一个即可。

返回参数

名称类型示例值描述
InstanceIdStringmssql-1be522b5****源实例 ID。

请求示例

POST /?Action=RestoreToExistedInstance&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: rds-mssql.volcengineapi.com
X-Date: 20230131T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mssql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****

{
    "SourceDBInstanceId":"mssql-1be522b5****",
    "TargetDBInstanceId":"mssql-1be522b5****",
    "RestoreTime":"2023-08-23T08:04:59Z",
    "Databases":[{
        "DBName":"tets1",
        "NewDBName":"tewy222"
    }]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2023082316124895D97DB6A9EC3C53E9EC",
        "Action": "RestoreToExistedInstance",
        "Version": "2022-01-01",
        "Service": "rds_mssql",
        "Region": "cn-beijing"
    },
    "Result": {
        "InstanceId": "mssql-1be522b5****"
    }
}

错误码

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