文档首页/ 云数据库 RDS/ API参考/ API v3(推荐)/ 备份与恢复/ 表级时间点恢复(PostgreSQL) - BatchRestorePostgreSqlTables
更新时间:2026-01-19 GMT+08:00
分享

表级时间点恢复(PostgreSQL) - BatchRestorePostgreSqlTables

功能介绍

表级时间点恢复。

调试

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

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

  • URI格式

    POST /v3/{project_id}/instances/batch/restore/tables

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    参数解释:

    租户在某一region下的project ID。

    约束限制:

    非空。

    取值范围:

    获取方法请参见获取项目ID

    默认取值:

    不涉及。

请求消息

  • 参数说明
    表2 参数说明

    名称

    是否必选

    参数类型

    说明

    instances

    Array of objects

    参数解释:

    表信息。详细说明请参见表3

    约束限制

    不涉及。

    表3 instances字段数据结构说明

    名称

    是否必选

    参数类型

    说明

    restore_time

    Long

    参数解释:

    恢复时间。

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

    instance_id

    String

    参数解释:

    实例ID。

    约束限制

    不涉及。

    取值范围

    该参数值可调用查询指定时间点可恢复的表接口,通过表4中的“id”获取。

    默认取值

    不涉及。

    databases

    Array of objects

    参数解释:

    数据库信息。详细说明请参见表4

    约束限制

    不涉及。

    表4 databases字段数据结构说明

    名称

    是否必选

    参数类型

    说明

    database

    String

    参数解释:

    数据库名。

    约束限制

    不涉及。

    取值范围

    该参数值可调用查询指定时间点可恢复的表接口,通过表5中的“name”获取。

    默认取值

    不涉及。

    schemas

    Array of objects

    参数解释:

    模式信息。详细说明请参见表5

    约束限制

    不涉及。

    表5 schemas字段数据结构说明

    名称

    是否必选

    参数类型

    说明

    schema

    String

    参数解释:

    模式信息。

    约束限制

    不涉及。

    取值范围

    该参数值可调用查询指定时间点可恢复的表接口,通过表6中的“name”获取。

    默认取值

    不涉及。

    tables

    Array of objects

    参数解释:

    表信息。详细说明请参见表6

    约束限制

    不涉及。

    表6 tables字段数据结构说明

    名称

    是否必选

    参数类型

    说明

    old_name

    String

    参数解释:

    恢复前表名。

    约束限制

    不涉及。

    取值范围

    该参数值可调用查询指定时间点可恢复的表接口,通过表7中的“name”获取。

    默认取值

    不涉及。

    new_name

    String

    参数解释:

    恢复后表名。

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

  • 请求样例
    POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/batch/restore/tables 
    { 
            "instances": [{ 
                   "restore_time": 1688556737000, 
                   "instance_id": "df29b535eec64ee1b286bd2c62871a9cin03", 
                   "databases": [{ 
                          "database": "data1", 
                          "schemas": [{ 
                                 "schema": "schema1", 
                                 "tables": [{ 
                                        "old_name": "table1", 
                                        "new_name": "table1_1688556737000" 
                                 }] 
                          }], 
                   }] 
            }] 
     }

响应消息

  • 正常响应要素说明
    表7 要素说明

    名称

    参数类型

    说明

    restore_result

    Array of objects

    参数解释:

    表信息。详细说明请参见表8

    表8 restore_result字段数据结构说明

    参数

    参数类型

    描述

    instance_id

    String

    参数解释:

    实例ID。

    取值范围

    不涉及。

    job_id

    String

    参数解释:

    工作流ID。

    取值范围

    不涉及。

  • 正常响应样例
    {
      "restore_result" : [ { 
        "instance_id" : "df29b535eec64ee1b286bd2c62871a9cin03", 
        "job_id" : "749d6254-f4f0-4f72-aa32-876e220d2496" 
      } ] 
    }
  • 异常响应

    请参见异常请求结果

状态码

错误码

请参见错误码

相关文档