# 表级时间点恢复（PostgreSQL） - BatchRestorePostgreSqlTables #### 功能介绍 表级时间点恢复。 - 调用接口前，您需要了解API[认证鉴权](https://support.huaweicloud.com/api-rds/rds_03_0001.html)。 - 调用接口前，您需要了解[请求Header参数说明](https://support.huaweicloud.com/api-rds/rds_03_0005.html#rds_03_0005__section479119143310)。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/RDS/doc?api=BatchRestorePostgreSqlTables)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-rds/rds_10_0005.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI - URI格式 POST /v3/{project_id}/instances/batch/restore/tables - 参数说明 表1参数说明 | 名称 | 是否必选 | 说明 | |:---|:---|:---| | project_id | 是 | **参数解释：** 租户在某一region下的project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-rds/rds_03_0002.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | #### 请求消息 - 参数说明 表2参数说明 | 名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | instances | 否 | Array of objects | **参数解释：** 表信息。详细说明请参见[表3]。 **约束限制**： 不涉及。 | 表3instances字段数据结构说明 | 名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | restore_time | 否 | Long | **参数解释：** 恢复时间。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | instance_id | 否 | String | **参数解释：** 实例ID。 **约束限制**： 不涉及。 **取值范围**： 该参数值可调用[查询指定时间点可恢复的表](https://support.huaweicloud.com/api-rds/rds_09_0023.html)接口，通过[表4](https://support.huaweicloud.com/api-rds/rds_09_0023.html#rds_09_0023__zh-cn_topic_0000001691629937_table395145715268)中的"id"获取。 **默认取值**： 不涉及。 | | databases | 否 | Array of objects | **参数解释：** 数据库信息。详细说明请参见[表4]。 **约束限制**： 不涉及。 | 表4databases字段数据结构说明 | 名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | database | 否 | String | **参数解释：** 数据库名。 **约束限制**： 不涉及。 **取值范围**： 该参数值可调用[查询指定时间点可恢复的表](https://support.huaweicloud.com/api-rds/rds_09_0023.html)接口，通过[表5](https://support.huaweicloud.com/api-rds/rds_09_0023.html#rds_09_0023__zh-cn_topic_0000001691629937_table46601532182710)中的"name"获取。 **默认取值**： 不涉及。 | | schemas | 否 | Array of objects | **参数解释：** 模式信息。详细说明请参见[表5]。 **约束限制**： 不涉及。 | 表5schemas字段数据结构说明 | 名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | schema | 否 | String | **参数解释：** 模式信息。 **约束限制**： 不涉及。 **取值范围**： 该参数值可调用[查询指定时间点可恢复的表](https://support.huaweicloud.com/api-rds/rds_09_0023.html)接口，通过[表6](https://support.huaweicloud.com/api-rds/rds_09_0023.html#rds_09_0023__zh-cn_topic_0000001691629937_table173961924132919)中的"name"获取。 **默认取值**： 不涉及。 | | tables | 否 | Array of objects | **参数解释：** 表信息。详细说明请参见[表6]。 **约束限制**： 不涉及。 | 表6tables字段数据结构说明 | 名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | old_name | 否 | String | **参数解释：** 恢复前表名。 **约束限制**： 不涉及。 **取值范围**： 该参数值可调用[查询指定时间点可恢复的表](https://support.huaweicloud.com/api-rds/rds_09_0023.html)接口，通过[表7](https://support.huaweicloud.com/api-rds/rds_09_0023.html#rds_09_0023__zh-cn_topic_0000001691629937_table1099494593012)中的"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]。 | 表8restore_result字段数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | instance_id | String | **参数解释：** 实例ID。 **取值范围**： 不涉及。 | | job_id | String | **参数解释：** 工作流ID。 **取值范围**： 不涉及。 | - 正常响应样例 ``` { "restore_result" : [ { "instance_id" : "df29b535eec64ee1b286bd2c62871a9cin03", "job_id" : "749d6254-f4f0-4f72-aa32-876e220d2496" } ] } ``` - 异常响应 请参见[异常响应结果](https://support.huaweicloud.com/api-rds/rds_01_0010.html)。 #### 状态码 - 正常 200 - 异常 请参见[状态码](https://support.huaweicloud.com/api-rds/rds_10_0200.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-rds/rds_10_0201.html)。