更新时间：2026-09-16 GMT+08:00

延迟库只读恢复库到主实例 - RestoreLogReplayDatabase

功能介绍

延迟库只读恢复库到主实例。

调用接口前，您需要了解API认证鉴权。
调用接口前，您需要了解请求Header参数说明。

调试

您可以在API Explorer中调试该接口。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
rds:instance:switchLogReplay	-	-	g:EnterpriseProjectId g:ResourceTag/<tag-key>	-	-

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

rds:instance:switchLogReplay

g:EnterpriseProjectId

g:ResourceTag/<tag-key>

接口约束

如果您需要使用该功能，请联系客服开通。
该接口支持RDS for PostgreSQL 12及以上版本的只读实例。

URI

URI格式
 POST /v3/{project_id}/instances/{instance_id}/log-replay/database

参数说明

表1 参数说明
名称	是否必选	说明
project_id	是	参数解释：租户在某一region下的project ID。获取方法请参见获取项目ID。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
instance_id	是	参数解释：要恢复库到主实例的只读实例ID。可调用查询数据库实例列表接口，通过表9中的“id”获取。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

请求参数

表2 参数说明
名称	是否必选	参数类型	说明
databases	是	Array of objects	参数解释：需要恢复的库名列表。详情请参见表3。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

表3 databases字段数据结构说明
名称	是否必选	参数类型	说明
old_name	是	String	参数解释：需恢复的原库名称。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
new_name	是	String	参数解释：恢复后的新库名称。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

请求示例

延迟库只读恢复库到主实例。

POST https://rds.cn-north-4.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/794c38e5309344818f4b33b86ebce9b4in03/log-replay/database 
{ 
  "databases" : [ { 
    "old_name" : "old", 
    "new_name" : "new" 
  } ] 
}

响应消息

正常响应要素说明

表4 要素说明

名称

参数类型

说明

job_id

String

参数解释：

任务流ID。

取值范围：

不涉及。

表4 要素说明
名称	参数类型	说明
job_id	String	参数解释：任务流ID。取值范围：不涉及。

正常响应样例

{ 
  "job_id" : "8465d1fb-20a8-48e6-9c9b-3d1958ecbb9e"
}

异常响应
 请参见异常响应结果。

状态码

正常
 200
异常
 请参见状态码。

错误码

请参见错误码。

父主题： 配置只读延迟库（PostgreSQL）