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

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

调试

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

请求参数

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

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

DBClusterId String 是 am-bp2590j****

集群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"}]

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

说明
  • Field表示需要排序的字段名，支持的字段为：State、CreateTime、DBName、ProcessID、UpdateTime、JobName和ProcessRows。
  • 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-bp2590j****

集群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-bp2590j****
&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>
    <PageSize>30</PageSize>
    <RequestId>C60B05DB-2B77-421A-98E9-92C20E******</RequestId>
    <PageNumber>1</PageNumber>
    <DBClusterId>am-bp2590j****</DBClusterId>
    <LoadTasksRecords>
        <Sql>insert overwrite into courses_external_table\nselect * from courses</Sql>
        <State>FINISH</State>
        <CreateTime>2021-05-18 18:47:27.0</CreateTime>
        <DBName>adb_demo</DBName>
        <ProcessID>2021051818472717201616624903453******</ProcessID>
        <UpdateTime>2021-05-18 18:47:31.0</UpdateTime>
        <JobName>2021051818472717201616624903453******</JobName>
        <ProcessRows>6</ProcessRows>
    </LoadTasksRecords>
</DescribeLoadTasksRecordsResponse>

JSON格式 

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

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

错误码

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

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