RestoreToExistedInstance--云数据库 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` 传入一个即可。

返回参数

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

请求示例

通过时间点恢复数据库

通过备库 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"
    }]
}

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****",
    "BackupId": "94fe801db98d41848197266ecaec****",
    "Databases":[{
        "DBName":"tets1",
        "NewDBName":"tjy3"
    }]
}

返回示例

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

错误码

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