文档中心

云数据库 veDB MySQL 版

备份恢复

DescribeRecoverableTables - 查询可恢复库表

调用 DescribeRecoverableTables 接口查询实例可恢复的库和表。

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	vedbm-6jvx8d7w****	实例 ID。说明您可以调用 DescribeDBInstances 接口查询实例 ID。
BackupId	String	否	snap-63f4****-8dff	备份文件 ID。通过调用 DescribeBackups 接口可查询 BackupID。说明该参数与 RestoreTime参数二者必选其一。
RestoreTime	String	否	2023-05-09T15:07:25Z	实例备份保留周期内的任意时间点，格式为 yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。通过调用 DescribeRecoverableTime 可查询实例备份可恢复的时间范围。说明该参数与 BackupId参数二者必选其一。
DBName	String	否	db_test	数据库名称。若传入该参数，则返回指定数据库下可恢复的所有表。若不传入该参数，则返回可恢复的数据库列表。
PageSize	Integer	是	1000	每页记录数。取值范围 1~1000。
PageNumber	Integer	是	1	页码，取值大于等于 1，且不超过 Integer 的最大值。

返回参数

参数	类型	示例值	描述
DBTableInfos	Array of DBTableInfoObject	请参见返回示例。	实例可恢复的库表信息。

DBTableInfoObject

参数	类型	示例值	描述
Database	String	test_db	数据库名称。
Tables	Array of String	["table1","table2","table3"]	指定数据库下的表信息。
DatabaseRecoverable	Boolean	true	是否整库可恢复，取值： true：表示整库可恢复。 false：表示目标库中至少有一个表不可恢复。
TablesInfo	JSON Map	{"table6": {"TableRecoverable": false}，"table7": {"TableRecoverable": false}}	目标数据库下不可恢复的表信息。说明当 DatabaseRecoverable 参数取值为 false时，会返回该参数。

TablesInfo

参数	类型	示例值	描述
TableRecoverable	Boolean	false	目标表是否可恢复，取值固定为 false，表示该表的状态为不可恢复。

示例

请求示例 1

POST /?Action=DescribeRecoverableTables&Version=2022-01-01 HTTP/1.1​
Content-Type: application/json​
Host: vedbm.cn-beijing.volcengineapi.com​
X-Date: 20230828T084117Z​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkOD******/20230828/cn-beijing/vedbm/request,SignedHeaders=x-date, Signature=6a593bf5f59e7c1109fb205c739d1cff4c672fe2d251963f4d48c87******​
{​
    "InstanceId":"vedbm-dfaa2zic****",​
    "RestoreTime":"2023-09-25T08:18:10Z",​
    "PageSize":1000,​
    "PageNumber":1,​
    "DBName":"testdb1"​
}​

返回示例 1

指定 DBName 参数

{​
    "ResponseMetadata": {​
        "RequestId": "2023092516270861B6A9D5989B6B1DA2E8",​
        "Action": "DescribeRecoverableTables",​
        "Version": "2022-01-01",​
        "Service": "vedbm",​
        "Region": "cn-beijing"​
    },​
    "Result": {​
        "DBTableInfos": [​
            {​
                "Database": "testdb3",​
                "DatabaseRecoverable": false,​
                "Tables": [​
                    "table1",​
                    "table2",​
                    "table3",​
                    "table4",​
                    "table5"​
                ],​
                "TablesInfo": {​
                    "table6": {​
                        "TableRecoverable": false​
                    },​
                    "table7": {​
                        "TableRecoverable": false​
                    },​
                    "table8": {​
                        "TableRecoverable": false​
                    }​
                }​
            }​
        ]​
    }​
}​

请求示例 2

POST /?Action=DescribeRecoverableTables&Version=2022-01-01 HTTP/1.1​
Content-Type: application/json​
Host: vedbm.cn-beijing.volcengineapi.com​
X-Date: 20220101T101010Z​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20220101/cn-beijing/vedbm/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645****​
{​
    "InstanceId":"vedbm-dfaa2zic****",​
    "RestoreTime":"2023-09-25T08:18:10Z",​
    "PageSize":1000,​
    "PageNumber":1,​
    "DBName":"testdb1"​
}​

返回示例 2

不指定 DBName 参数

{​
    "ResponseMetadata": {​
        "RequestId": "2023092516262161B6A9D5989B6B1D87DC",​
        "Action": "DescribeRecoverableTables",​
        "Version": "2022-01-01",​
        "Service": "vedbm",​
        "Region": "cn-beijing"​
    },​
    "Result": {​
        "DBTableInfos": [​
            {​
                "Database": "testdb1",​
                "DatabaseRecoverable": true​
            },​
            {​
                "Database": "testdb2",​
                          "DatabaseRecoverable": true​
            }​
        ]​
    }​
}​

错误码

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

最近更新时间：2026.02.28 11:26:55

这个页面对您有帮助吗？

有用

无用