Queries the logs of extract, transform, and load (ETL) tasks.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeEtlJobLogs

The operation that you want to perform. Set the value to DescribeEtlJobLogs.

DtsJobId String Yes l5512es7w15****

The ID of the ETL task. You can call the DescribeDtsJobs operation to query the task ID.

RegionId String No cn-hangzhou

The ID of the region in which the Data Transmission Service (DTS) instance resides. You can call the DescribeRegions operation to query the available Alibaba Cloud regions.

Response parameters

Parameter Type Example Description
DynamicCode String 403

The dynamic error code.

DynamicMessage String present environment is not support,so skip.

The dynamic part in the error message.

ErrCode String InvalidJobId

The error code. This example indicates that the specified ETL task ID is invalid.

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

The error message. This example indicates that the specified ETL task ID does not exist. In this case, the ETL task may be deleted.

EtlRunningLogs Array of EtlRunningLog

The logs of ETL tasks.

Content String Starting DTS-ETL...

The state of the ETL task.

ContentKey String DTS-ETL

The module for which the logs are generated, such as the conversion module of ETL tasks.

EtlId String u**********5

The ID of the ETL task.

LogDatetime String 1637306503000

The time when the log was generated. This value is a UNIX timestamp representing the number of milliseconds that have elapsed since January 1, 1970, 00:00:00 UTC.

Status String INFO

The log level. Valid values: ERROR, WARN, INFO, and DEBUG.

UserId String 121323*******454512

The ID of the user.

HttpStatusCode Integer 200

The HTTP status code.

RequestId String 224DB9F7-3100-4899-AB9C-C938BCCB43E7

The ID of the request.

Success Boolean true

Indicates whether the call was successful. If the call failed, false is returned.

Examples

Sample requests

http(s)://dts.aliyuncs.com/?Action=DescribeEtlJobLogs
&DtsJobId=l5512es7w15****
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format 

<DescribeEtlJobLogsResponse>
  <requestId>62E37CD4-586B-50A4-99AA-3E60D2485F6C</requestId>
  <success>true</success>
  <etlRunningLogs>
        <content>Starting DTS-ETL...</content>
        <contentKey>DTS-ETL</contentKey>
        <etlId>u**********5</etlId>
        <gmtCreate>1637306505000</gmtCreate>
        <id>941</id>
        <logDatetime>1637306503000</logDatetime>
        <status>INFO</status>
  </etlRunningLogs>
  <httpStatusCode>200</httpStatusCode>
</DescribeEtlJobLogsResponse>

JSON format 

{
    "requestId": "62E37CD4-586B-50A4-99AA-3E60D2485F6C",
    "success": true,
    "etlRunningLogs": [
        {
            "content": "Starting DTS-ETL...",
            "contentKey": "DTS-ETL",
            "etlId": "u**********5",
            "gmtCreate": 1637306505000,
            "id": 941,
            "logDatetime": 1637306503000,
            "status": "INFO"
        }
    ],
    "httpStatusCode": 200
}

Error codes

For a list of error codes, visit the API Error Center.