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

文档中心

立即注册

导航

RestoreToExistedInstance

最近更新时间：2025.06.10 11:39:06首次发布时间：2025.06.05 17:21:56

调用 RestoreToExistedInstance 接口将数据恢复到现有实例。

请求类型

异步请求。

注意事项

当前仅支持通过逻辑备份将数据恢复到现有实例。

请求参数

参数	类型	是否必选	示例值	描述
BackupId	String	是	20250512-194554-792LD	用于恢复的备份 ID。
SourceDBInstanceId	String	是	postgres-a3e7eb2f****	备份所属的实例 ID。
TargetDBInstanceId	String	是	postgres-a3e7eb2f****	恢复的目标实例的 ID。说明 SourceDBInstanceId 与 TargetDBInstanceId 的值可相同。如 SourceDBInstanceId 与 TargetDBInstanceId 的值相同，则将数据恢复至原实例。
TargetDBInstanceAccount	String	是	Admin	目标实例中用于作为新恢复的数据库 Owner 的账号。说明仅支持选择未被禁用 DDL 权限的高权限账号。
Databases	Object[]	是	请参见返回示例。	待恢复的数据库信息。说明单次最多可选择 50 个库进行恢复。

返回参数

null

示例

请求示例

POST /?Action=RestoreToExistedInstance&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: rds-postgresql.cn-beijing.volcengineapi.com
X-Date: 20231002T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_postgresql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****
{
    "BackupId": "20250512-194554-792LD",
    "SourceDBInstanceId": "postgres-a3e7eb2f****",
    "TargetDBInstanceId": "postgres-a3e7eb2f****",
    "TargetDBInstanceAccount": "Admin",
    "Databases": [
        {
            "DBName": "DatabaseName",
            "NewDBName": "DatabaseName_restored"
        }
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202505122228285485938EED274336A199-20bd59",
        "Action": "RestoreToExistedInstance",
        "Version": "2022-01-01",
        "Service": "rds_postgresql",
        "Region": "cn-beijing"
    },
    "Result": null
}