调用DescribeMetaList接口查看支持恢复的库表信息详情。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeMetaList

系统规定参数。取值：DescribeMetaList。

RegionId String 否 cn-hangzhou

地域ID。

说明 您可以通过DescribeRegions接口查询地域信息详情。
DBClusterId String 是 pc-**************

集群ID。

说明 您可以通过DescribeDBClusters接口查询账号下所有集群的信息详情。
BackupId String 否 111111

备份集ID。

说明
  • 查询时，BackupId和RestoreTime参数必选其一传入。
  • 您可以通过DescribeBackups接口查看备份集ID。
RestoreTime String 否 2020-10-04T01:40:00Z

还原时间点，格式为YYYY-MM-DDThh:mmZ（UTC时间）。

说明 查询时，BackupId和RestoreTime参数必选其一传入。您可以通过DescribeBackups接口查看还原时间点。
GetDbName String 否 test_db

传入具体的数据库名称（如test_db）以获取目标数据库所有支持恢复的数据表名称。

说明
  • 每次仅支持传入一个数据库名称。
  • 若该参数留空，您可以查看当前备份集下所有支持恢复的数据库名称，但无法查看各数据库下对应的数据表名称。
PageSize Integer 否 30

每页记录数，取值范围如下：

  • 30
  • 50
  • 100

    默认值为30。

PageNumber Integer 否 1

页码，取值范围为大于0但不超过Integer最大值的整数，默认值为1。

返回数据

名称 类型 示例值 描述
TotalPageCount String 1

总页数。
TotalRecordCount String 2

总记录数。
PageSize String 30

本页记录数。
RequestId String AA815DE7-B576-4B22-B33C-3FB31A******

请求ID。
PageNumber String 1

页码。
Items Array of MetaItem

支持恢复的库表信息详情。
Database String test_db

支持恢复的数据库名称。
Tables Array of String test_tb1

支持恢复的表名称。
DBClusterId String pc-bp1s826a1up******

集群ID。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=DescribeMetaList
&DBClusterId=pc-**************
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeMetaListResponse>
<TotalRecordCount>2</TotalRecordCount>
<TotalPageCount>1</TotalPageCount>
<RequestId>AA815DE7-B576-4B22-B33C-3FB31A******</RequestId>
<PageSize>30</PageSize>
<PageNumber>1</PageNumber>
<Items>
    <Database>test_db</Database>
    <Tables>test_tb1</Tables>
    <Tables>test_tb2</Tables>
</Items>
</DescribeMetaListResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalRecordCount" : 2,
  "TotalPageCount" : 1,
  "RequestId" : "AA815DE7-B576-4B22-B33C-3FB31A******",
  "PageSize" : 30,
  "PageNumber" : 1,
  "Items" : [ {
    "Database" : "test_db",
    "Tables" : [ "test_tb1", "test_tb2" ]
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidRestoreType.Format Specified restore type is not valid. 操作失败，指定的还原类型无效。
400 InvalidRestoreTime.Format Specified restore time is not valid. 操作失败，指定的恢复时间无效。
400 InvalidBackupSetID.NotFound Specified backup set ID does not exist. 操作失败，指定的备份集ID不存在。
400 IncorrectBackupSetState Current backup set state does not support operations. 操作失败，当前备份集状态不支持操作。
400 InvalidDBName.Duplicate Specified DB name already exists in the This instance. 操作失败，此实例中已存在指定的数据库名称。
400 InvalidParameters.Format Specified parameters is not valid. 指定的参数无效。
400 InsufficientResourceCapacity There is insufficient capacity available for the requested instance. 操作失败，请求的实例没有足够的可用容量。
400 InvalidRestoreType.NotFound At least one of BackupId and RestoreTime is malformed. BackupId和RestoreTime中至少有一个格式不正
400 MissingUserID The request is missing a user_id parameter. 请求缺少user_id参数
400 MissingUID The request is missing a uid parameter. 请求缺少uid参数
404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records. 当前的记录中不存在提供的DBClusterId。
404 InvalidBackup.NotFound The available backup does not exist in recovery time. 操作失败，可用备份在恢复时间内不存在。

访问错误中心查看更多错误码。