调用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. | 签名已经过期,请更新签名 |
访问错误中心查看更多错误码。