全部产品
Search
文档中心

云原生数据库 PolarDB:DescribeSqlFlashbackTaskList - 查看SQL闪回任务的列表

更新时间:Sep 10, 2026

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

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

polardbx:DescribeSqlFlashbackTaskList

none

*全部资源

*

请求参数

名称

类型

必填

描述

示例值

RegionId

string

实例所在地域。

cn-hangzhou

PolardbxInstanceId

string

PolarDB-X 实例 ID。

pxc-**********

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID。

9B2F3840-5C98-475C-B269-2D5C3A31797C

Message

string

请求结果描述信息。

OK

Success

boolean

当前 API 是否请求成功。

true

Data

object

请求结果数据内容。

SqlFlashbackTasks

array<object>

闪回任务返回对象。

object

闪回任务返回对象。

GmtModified

string

闪回任务在数据库的最后更新时间(单位:ms)。

1568611469000

SearchEndTime

string

提交 SQL 闪回时输入的结束时间(单位:ms)。

1568609597000

RecallStatus

string

数据召回任务状态:

  • 1:进行中;

  • 2:已完成。

1

SqlPk

string

SQL 涉及的主键值。

id

RecallRestoreType

string

SQL 闪回恢复类型:

  • 1:镜像恢复;

  • 2:逆向恢复。

0

TableName

string

数据所属的表。

test

GmtCreate

string

闪回任务在数据库的创建时间(单位:ms)。

1568611408000

InstId

string

PolarDB-X 实例 ID。

pxc-********

SearchStartTime

string

提交 SQL 闪回时输入的开始时间(单位:ms)。

1568609597000

RecallType

string

回溯类型:

  • 0:精确查找;

  • 1:模糊查找。

0

TraceId

string

SQL 的 trace_id。

13ed05705f801000

DbName

string

执行闪回任务的数据库名称。

test

SqlType

string

SQL 的类型,取值范围为 INSERT、UPDATE、DELETE,多种类型间用英文逗号(,)分隔。

INSERT,UPDATE

Id

string

主键 ID。

111

ExpireTime

string

下载地址过期时间(单位:ms)。

1569216270000

SqlCounter

string

恢复的数据行数。

100

RecallProgress

string

闪回任务执行进度(取值范围 1~100)。

10

DownloadUrl

string

结果文件下载地址。

http://...

示例

正常返回示例

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://..."
      }
    ]
  }
}

错误码

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

变更历史

更多信息,参考变更详情