调用DescribeMetaList查询目标备份集中可恢复的库表信息。
在使用RestoreTable接口进行MySQL单库单表恢复之前，您可以通过本接口查询可恢复的库表信息。
说明 实例为MySQL 8.0、5.7、5.6高可用版（本地SSD盘）。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeMetaList |
系统规定参数。取值：DescribeMetaList。 |
| ClientToken | String | 否 | ETnLKlblzczshOTUbOCzxxxxxxxxxx |
用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过64个ASCII字符，且该参数值中不能包含非ASCII字符。 |
| DBInstanceId | String | 是 | rm-uf6wjk5xxxxxxx |
实例ID。可调用DescribeDBInstances获取。 |
| RestoreType | String | 否 | BackupSetID |
恢复方式，取值：
默认值：BackupSetID |
| BackupSetID | Integer | 否 | 14358 |
基于备份集查询时，使用的备份集的ID。可调用DescribeBackups获取。 |
| RestoreTime | String | 否 | 2019-05-30T03:29:10Z |
基于时间点查询时，使用的时间节点，需要早于当前时间。格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。可调用DescribeBackups获取。 |
| GetDbName | String | 否 | testdb1 |
要查询的数据库名。精确匹配，会返回具体的数据库名以及库内所有的表。 |
| Pattern | String | 否 | test |
要查询的数据库名。模糊匹配，只返回匹配的数据库名，不返回表名。 |
| PageSize | Integer | 否 | 1 |
每页记录数。默认值：1。 |
| PageIndex | Integer | 否 | 1 |
页码，取值：大于0且不超过Integer的最大值。默认值：1。 |
| ResourceGroupId | String | 否 | rg-acfmy***** |
资源组ID。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| DBInstanceName | String | rm-uf6wjk5xxxxxxx |
实例名称。 |
| TotalPageCount | Integer | 1 |
总页数。 |
| RequestId | String | 60F9A12A-16B8-4728-B099-4CA38D32C31C |
请求ID。 |
| PageRecordCount | Integer | 1 |
本页记录数。 |
| TotalRecordCount | Integer | 1 |
总记录数。 |
| PageNumber | Integer | 1 |
页码。 |
| Items | Array of Meta |
备份中的库表信息列表。 |
|
| Meta | |||
| Tables | String | test1 |
表名称。 |
| Database | String | testdb1 |
数据库名称。 |
| Size | String | 64 |
表的大小，单位：KB。 |
示例
请求示例
http(s)://rds.aliyuncs.com/?Action=DescribeMetaList
&DBInstanceId=rm-uf6wjk5xxxxxxx
&正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
1
1
1
60F9A12A-16B8-4728-B099-4CA38D32C31C
1
64
testdb1
test1
rm-uf6wjk5xxxxxxx
JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"TotalPageCount" : "1",
"TotalRecordCount" : "1",
"PageRecordCount" : "1",
"RequestId" : "60F9A12A-16B8-4728-B099-4CA38D32C31C",
"PageNumber" : "1",
"Items" : {
"Meta" : [ {
"Size" : "64",
"Database" : "testdb1",
"Tables" : "test1"
} ]
},
"DBInstanceName" : "rm-uf6wjk5xxxxxxx"
}错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidPageSize | The page size is invalid | pageSize值不合法，请输入数字。 |
| 400 | InvalidRestoreTime.Format | Specified restore time is not valid. | 操作失败，当前指定的恢复时间无效，请重新设置恢复时间。 |
| 403 | InvalidMeta.Empty | Meta information is empty. | 元信息是空的 |
| 403 | IncorrectDBInstanceType | Current DB instance type does not support this operation. | 操作失败，该实例状态下不支持此操作。 |
| 403 | IncorrectEngineVersion | Current engine version does not support operations. | 操作失败，当前数据库版本不支持此操作。 |
| 403 | InvalidBackupLogStatus | Current backup log enable status does not support this operation. | 操作失败，日志备份未开启，无法按时间点恢复。 |
| 404 | InvalidBackupSetID.NotFound | Specified backup set ID does not exist. | 备份集不存在。请查看已存在的备份集。 |
访问错误中心查看更多错误码。
内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家
阿里云企业补贴进行中： 马上申请
腾讯云限时活动1折起，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利:同意关联，立享优惠
转转请注明出处：https://www.yunxiaoer.com/154179.html