调用DescribeDtsEtlJobVersionInfo接口查看ETL任务详情。

调试

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

请求参数

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

系统规定参数。取值:DescribeDtsEtlJobVersionInfo

PageSize Integer 20

分页查询时设置的每页行数,默认为20。

PageNumber Integer 1

当前实例状态列表的页码,默认为1。

DtsInstanceId String dtsggk12iwya1a****

DTS实例ID,您可以调用DescribeDtsJobs接口查询实例ID。

DtsJobId String l5512es7w15****

ETL任务ID,您可以调用DescribeDtsJobs接口查询任务ID。

RegionId String cn-hangzhou

DTS实例所属的地域ID。您可以调用DescribeRegions接口查询阿里云地域列表。

返回数据

名称 类型 示例值 描述
RequestId String 224DB9F7-3100-4899-AB9C-C938BCCB43E7

请求ID。

Success Boolean true

请求是否成功,如果失败则返回false。

ErrCode String InvalidJobId

传入的ETL任务ID错误,找不到对应的任务。

PageNumber Integer 1

当前实例状态列表的页码,默认为1。

PageRecordCount Integer 20

当前分页的记录数。

TotalRecordCount Integer 200

记录的总行数。

ErrMessage String The specified dts job id %s is not exists.

传入的ETL任务ID错误,找不到对应的任务(任务可能已删除)。

HttpStatusCode String 200

状态码。

DynamicCode String 403

与本次请求相关的动态错误码。

DynamicMessage String present environment is not support,so skip

与本次请求相关的动态错误信息。

DtsEtlJobVersionInfos Array of DtsEtlJobVersionInfo

返回ETL任务信息对象数组。

Status String INFO

日志等级,有ERROR、WARN、INFO、DEBUG4种等级。

DtsJobName String test_sql

ETL任务名称。

DtsJobId String l5512es7w15****

ETL任务ID。

Version Integer 9

ETL任务版本号。

DtsInstanceId String dtsg******gd

DTS实例ID。

CreateTime String 1637229315000

创建ETL任务的时间戳。

SafeCheckpoint String 1637230117000

安全检查点,即ETL任务的当前位点。

Creator String 10000000

创建者ID。

ModifyTime String 1637230117000

修改时间戳。

CreatorName String ***@****.com

创建者用户名。

示例

请求示例

http(s)://dts.aliyuncs.com/?Action=DescribeDtsEtlJobVersionInfo
&pageSize=20
&pageNumber=0
&dtsInstanceId=dtsggk12iwya1a****
&DtsJobId=l5512es7w15****
&RegionId=cn-hangzhou
&<必填参数>
&<公共请求参数>

正常返回示例

XML格式

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

<DescribeDtsEtlJobVersionInfoResponse>
<requestId>62E37CD4-586B-50A4-99AA-3E60D2485F6C</requestId>
<success>true</success>
<dtsEtlJobVersionInfos>
    <createTime>1637229315000</createTime>
    <creator>10000000</creator>
    <creatorName>***@****.com</creatorName>
    <dtsInstanceId>dtsggk12iwya1a****</dtsInstanceId>
    <dtsJobId>l5512es7w15****</dtsJobId>
    <dtsJobName>test_sql</dtsJobName>
    <modifyTime>1637230117000</modifyTime>
    <status>INFO</status>
    <version>9</version>
</dtsEtlJobVersionInfos>
<httpStatusCode>200</httpStatusCode>
</DescribeDtsEtlJobVersionInfoResponse>

JSON格式

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

{
  "requestId" : "62E37CD4-586B-50A4-99AA-3E60D2485F6C",
  "success" : true,
  "dtsEtlJobVersionInfos" : [ {
    "createTime" : 1637229315000,
    "creator" : "10000000",
    "creatorName" : "***@****.com",
    "dtsInstanceId" : "dtsggk12iwya1a****",
    "dtsJobId" : "l5512es7w15****",
    "dtsJobName" : "test_sql",
    "modifyTime" : 1637230117000,
    "status" : "INFO",
    "version" : 9
  } ],
  "httpStatusCode" : 200
}

错误码

HttpCode 错误码 错误信息 描述
400 Throttling.User Request was denied due to user flow control. 由于请求频次达到阈值,请求被拒绝,请稍后重试。
500 ServiceUnavailable The request has failed due to a temporary failure of the server. 由于服务端响应超时或者不可用导致请求失败,请重试,重试后仍失败请联系技术支持。
403 InvalidSecurityToken.Expired Specified SecurityToken is expired. 签名已经过期,请更新签名

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