You need to enable JavaScript to run this app.
导航
云数据库 veDB MySQL 版
  • 文档首页
    • /
  • 云数据库 veDB MySQL 版

DescribeRecoverableTables

最近更新时间：2024.03.14 11:22:35

首次发布时间：2023.11.30 10:27:54

我的收藏

调用 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

数据库名称。

  • 若传入该参数，则返回指定数据库下可恢复的所有表。
  • 若不传入该参数，则返回可恢复的数据库列表。
PageSizeInteger否1000每页记录数。取值范围 1~1000，默认值为 500。
PageNumberInteger否1页码，取值大于等于 1，且不超过 Integer 的最大值，默认值为 1。

返回参数

名称类型示例值描述
DBTableInfosArray of DBTableInfoObject请参见返回示例。可恢复的库表信息。关于 DBTableInfos 的详细信息，请参见DBTableInfoObject。

请求示例

POST /?Action=DescribeRecoverableTables&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: vedbm.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"
}

返回示例

  • 指定 DBName 参数

    {
    "ResponseMetadata": {
        "RequestId": "2023092516270861B6A9D5989B6B1DA2E8",
        "Action": "DescribeRecoverableTables",
        "Version": "2022-01-01",
        "Service": "vedbm",
        "Region": "cn-beijing"
    },
    "Result": {
        "DBTableInfos": [
            {
                "Database": "testdb1",
                "Tables": [
                    "auth_operation",
                    "auth_role",
                    "auth_role_operation",
                    "auth_user",
                    "i_article"
                ]
            }
        ]
    }
}

  • 不指定 DBName 参数

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

错误码

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