调用DescribeSqlFlashbackTaskList接口查看SQL闪回任务的列表。

调试

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

请求参数

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

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

RegionId String 是 cn-hangzhou

实例所在地域。
PolardbxInstanceId String 是 pxc-**********

PolarDB-X实例ID。

返回数据

名称 类型 示例值 描述
RequestId String 9B2F3840-5C98-475C-B269-2D5C3A31797C

请求ID。
Message String OK

请求结果描述信息。
Success Boolean true

当前API是否请求成功。
Data Object

请求结果数据内容。
SqlFlashbackTasks Array of SqlFlashbackTasks

闪回任务返回对象。
GmtModified String 1568611469000

闪回任务在数据库的最后更新时间（单位：ms）。
SearchEndTime String 1568609597000

提交SQL闪回时输入的结束时间（单位：ms）。
RecallStatus String 1

数据召回任务状态：

  • 1：进行中；
  • 2：已完成。
SqlPk String id

SQL涉及的主键值。
RecallRestoreType String 0

SQL闪回恢复类型：

  • 1：镜像恢复；
  • 2：逆向恢复。
TableName String test

数据所属的表。
GmtCreate String 1568611408000

闪回任务在数据库的创建时间（单位：ms）。
InstId String pxc-********

PolarDB-X实例ID。
SearchStartTime String 1568609597000

提交SQL闪回时输入的开始时间（单位：ms）。
RecallType String 0

回溯类型：

  • 0：精确查找；
  • 1：模糊查找。
TraceId String 13ed05705f801000

SQL的trace_id。
DbName String test

执行闪回任务的数据库名称。
SqlType String INSERT,UPDATE

SQL的类型，取值范围为INSERT、UPDATE、DELETE，多种类型间用英文逗号（,）分隔。
Id String 111

主键ID。
ExpireTime String 1569216270000

下载地址过期时间（单位：ms）。
SqlCounter String 100

恢复的数据行数。
RecallProgress String 10

闪回任务执行进度（取值范围1～100）。
DownloadUrl String http://...

结果文件下载地址。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeSqlFlashbackTaskList
&RegionId=cn-hangzhou
&PolardbxInstanceId=pxc-**********
&公共请求参数

正常返回示例

XML格式 

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

<DescribeSqlFlashbackTaskListResponse>
    <RequestId>9B2F3840-5C98-475C-B269-2D5C3A31797C</RequestId>
    <Message>OK</Message>
    <Success>true</Success>
    <Data>
        <SqlFlashbackTasks>
            <GmtModified>1568611469000</GmtModified>
            <SearchEndTime>1568609597000</SearchEndTime>
            <RecallStatus>1</RecallStatus>
            <SqlPk>id</SqlPk>
            <RecallRestoreType>0</RecallRestoreType>
            <TableName>test</TableName>
            <GmtCreate>1568611408000</GmtCreate>
            <InstId>pxc-********</InstId>
            <SearchStartTime>1568609597000</SearchStartTime>
            <RecallType>0</RecallType>
            <TraceId>13ed05705f801000</TraceId>
            <DbName>test</DbName>
            <SqlType>INSERT,UPDATE</SqlType>
            <Id>111</Id>
            <ExpireTime>1569216270000</ExpireTime>
            <SqlCounter>100</SqlCounter>
            <RecallProgress>10</RecallProgress>
            <DownloadUrl>http://...</DownloadUrl>
        </SqlFlashbackTasks>
    </Data>
</DescribeSqlFlashbackTaskListResponse>

JSON格式 

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

{
  "RequestId" : "9B2F3840-5C98-475C-B269-2D5C3A31797C",
  "Message" : "OK",
  "Success" : true,
  "Data" : {
    "SqlFlashbackTasks" : [ {
      "GmtModified" : "1568611469000",
      "SearchEndTime" : "1568609597000",
      "RecallStatus" : "1",
      "SqlPk" : "id",
      "RecallRestoreType" : "0",
      "TableName" : "test",
      "GmtCreate" : "1568611408000",
      "InstId" : "pxc-********",
      "SearchStartTime" : "1568609597000",
      "RecallType" : "0",
      "TraceId" : "13ed05705f801000",
      "DbName" : "test",
      "SqlType" : "INSERT,UPDATE",
      "Id" : "111",
      "ExpireTime" : "1569216270000",
      "SqlCounter" : "100",
      "RecallProgress" : "10",
      "DownloadUrl" : "http://..."
    } ]
  }
}

错误码

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