调用DescribeLoadTasksRecords接口返回异步导入导出任务信息。

调试

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

请求参数

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

系统规定参数。取值:DescribeLoadTasksRecords。

DBClusterId String am-bpxxxxxxxx47

实例ID。

StartTime String 2012-05-08T15:00Z

查询开始时间。格式:yyyy-MM-ddTHH:mmZ。

EndTime String 2012-06-18T15:00Z

查询结束时间。格式:yyyy-MM-ddTHH:mmZ。

DBName String test_db

数据库名称。

PageSize Integer 30

每页记录数,取值:

  • 30;
  • 50;
  • 100;

默认值:30。

PageNumber Integer 1

页码,取值为:大于0且不超过Integer数据类型的最大值,默认值为1。

Order String [ { "Field":"Name", "Type":"Asc" } ]

按指定字段排序,json格式:JSON数组,有序,按顺序输入排列字段和升降序类型,例如:

{ "Field":"Name", "Type":"Asc" }

其中Field表示需要排序的字段名,目前仅支持对"Name" 字段排序。Type表示排序类型,Desc为降序,Asc为升序,均不区分大小写。

Range String "Field":"QueryTime", "Min":"1000", "Max":"10000"

按指定指标的Min,Max进行范围过滤,格式为json格式,是一个JSON数组。

其中Field字段表示需要限制范围的字段,支持:

  • ScanSize(KB)
  • QueryTime(ms)
  • PeakMemoryUsage(KB)

Min表示查询范围最小值(左值),Max表示查询范围最大值(右值),数据类型都为String。

State String Init

加载任务状态。

返回数据

名称 类型 示例值 描述
TotalCount String 1234

总数。

PageSize String 30

每页记录数,取值:

  • 30;
  • 50;
  • 100;

默认值:30。

RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

请求ID。

PageNumber String 1

页码,取值为:大于0且不超过Integer数据类型的最大值,默认值为1。

DBClusterId String am-bpxxxxxxxx47

实例ID。

LoadTasksRecords Array of LoadTaskRecord

参数列表。

Sql String

加载任务相关的SQL语句。

State String Init

导入导出任务的状态。

CreateTime String 2012-06-18T15:00Z

加载任务开始时间。

DBName String test_db

数据库名。

ProcessID String xxxxx

进程ID。

UpdateTime String 2012-06-18T15:00Z

加载任务状态更新时间。

JobName String xxxxx

加载任务ID。

ProcessRows Long 298102

加载任务处理的行数。

示例

请求示例

http(s)://[Endpoint]/?AccessKeyId=******
&Action=DescribeLoadTasksRecords
&DBClusterId=am-bpxxxxxxxx47
&StartTime=2012-05-08T15:00Z
&EndTime=2012-06-18T15:00Z
&DBName=test_db
&PageSize=30
&PageNumber=1
&Order=[ { "Field":"Name", "Type":"Asc" } ]
&Range="Field":"QueryTime", "Min":"1000", "Max":"10000"
&State=Init
&公共请求参数

正常返回示例

XML格式

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

<TotalCount>1234</TotalCount>
<PageSize>30</PageSize>
<RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>
<PageNumber>1</PageNumber>
<DBClusterId>am-bpxxxxxxxx47</DBClusterId>
<LoadTasksRecords>
    <Sql>无</Sql>
    <State>Init</State>
    <CreateTime>2012-06-18T15:00Z</CreateTime>
    <DBName>test_db</DBName>
    <ProcessID>xxxxx</ProcessID>
    <UpdateTime>2012-06-18T15:00Z</UpdateTime>
    <JobName>xxxxx</JobName>
    <ProcessRows>298102</ProcessRows>
</LoadTasksRecords>

JSON格式

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

{
  "TotalCount" : "1234",
  "PageSize" : "30",
  "RequestId" : "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
  "PageNumber" : "1",
  "DBClusterId" : "am-bpxxxxxxxx47",
  "LoadTasksRecords" : [ {
    "Sql" : "无",
    "State" : "Init",
    "CreateTime" : "2012-06-18T15:00Z",
    "DBName" : "test_db",
    "ProcessID" : "xxxxx",
    "UpdateTime" : "2012-06-18T15:00Z",
    "JobName" : "xxxxx",
    "ProcessRows" : 298102
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records. 您指定的 DBClusterId 不存在,请确认 DBClusterId 值是否正确。

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