调用DescribeLoadTasksRecords接口查看异步导入导出任务的详情。

更多关于异步提交导入导出任务的详情,请参见异步提交导入导出任务

调试

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

请求参数

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

系统规定参数。取值为DescribeLoadTasksRecords

DBClusterId String am-bp**********

集群ID。

说明 您可以调用DescribeDBClusters接口查看目标地域下所有AnalyticDB MySQL集群的详情,包括集群ID。
StartTime String 2021-05-18T06:00:00Z

查询开始时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

说明 建议查询开始时间设置为30天内的任意时间点。
EndTime String 2021-05-18T06:30:00Z

查询结束时间,需晚于查询开始时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

DBName String adb_demo

导入导出任务所涉及的数据库名称。

PageSize Integer 30

每页记录数,取值范围如下:

  • 30(默认值)。
  • 50
  • 100
PageNumber Integer 1

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

Order String [{"Field":"CreateTime", "Type":"desc"}]

按指定字段对任务进行升序或降序排列。参数值需为JOSN字符串类型,例如:[{"Field":"CreateTime", "Type":"desc"}]

说明
  • Field表示需要排序的字段名,支持的字段为:StateCreateTimeDBNameProcessIDUpdateTimeJobNameProcessRows
  • Type表示排序类型,取值范围为Desc(降序)或Asc(升序),取值不区分大小写。
State String FINISH

需要查询的异步导入或导出任务的状态,取值范围如下:

  • INIT:任务初始化。
  • RUNNING:任务进行中。
  • FINISH:任务执行成功。
  • FAILED:任务执行失败。

返回数据

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

任务总数。

PageSize String 30

本页记录数。

RequestId String C60B05DB-2B77-421A-98E9-92C20E******

请求ID。

PageNumber String 1

页码。

DBClusterId String am-bp**********

集群ID。

LoadTasksRecords Array of LoadTaskRecord

任务信息列表。

Sql String insert overwrite into courses_external_table\nselect * from courses

异步导入导出任务中使用的SQL语句详情。

State String FINISH

任务状态。

CreateTime String 2021-05-18 18:47:27.0

任务开始时间,精确到毫秒,格式为yyyy-MM-ddTHH:mm:ss.SSSZ

DBName String adb_demo

导入导出任务涉及的数据库名称。

ProcessID String 2021051818472717201616624903453******

进程ID。

UpdateTime String 2021-05-18 18:47:31.0

任务状态的更新时间,精确到毫秒,格式为yyyy-MM-ddTHH:mm:ss.SSSZ

JobName String 2021051818472717201616624903453******

任务ID。

ProcessRows Long 6

异步导入导出任务所处理的数据行数。

示例

请求示例

http(s)://adb.aliyuncs.com/?&Action=DescribeLoadTasksRecords
&DBClusterId=am-bp**********
&StartTime=2021-05-18T06:00:00Z
&EndTime=2021-05-18T06:30:00Z
&公共请求参数

正常返回示例

XML格式

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

<DescribeLoadTasksRecordsResponse>
    <TotalCount>1</TotalCount>
    <LoadTasksRecords>
        <ProcessRows>6</ProcessRows>
        <State>FINISH</State>
        <CreateTime>2021-05-18 18:47:27.0</CreateTime>
        <JobName>2021051818472717201616624903453******</JobName>
        <UpdateTime>2021-05-18 18:47:31.0</UpdateTime>
        <DBName>adb_demo</DBName>
        <ProcessID>2021051818473117201616624903453******</ProcessID>
        <Sql> insert overwrite into courses_external_table
select * from courses</Sql>
    </LoadTasksRecords>
    <RequestId>C60B05DB-2B77-421A-98E9-92C20E******</RequestId>
    <PageSize>30</PageSize>
    <PageNumber>1</PageNumber>
    <DBClusterId>am-bp**********</DBClusterId>
</DescribeLoadTasksRecordsResponse>

JSON格式

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

{
  "TotalCount" : 1,
  "LoadTasksRecords" : [ {
    "ProcessRows" : 6,
    "State" : "FINISH",
    "CreateTime" : "2021-05-18 18:47:27.0",
    "JobName" : "2021051818472717201616624903453******",
    "UpdateTime" : "2021-05-18 18:47:31.0",
    "DBName" : "adb_demo",
    "ProcessID" : "2021051818473117201616624903453******",
    "Sql" : " insert overwrite into courses_external_table\nselect * from courses"
  } ],
  "RequestId" : "C60B05DB-2B77-421A-98E9-92C20E******",
  "PageSize" : 30,
  "PageNumber" : 1,
  "DBClusterId" : "am-bp**********"
}

错误码

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

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