Viewing Job Instance Details
Function
This API is used to view job instance details, including the execution information about each node in a job instance.
URI
- Parameter description
Table 1 URI parameters Parameter
Mandatory
Type
Description
project_id
Yes
String
Project ID. For details about how to obtain a project ID, see Project ID and Account ID.
job_name
Yes
String
Job name
instance_id
Yes
string
Job instance ID. For details about how to obtain the ID, see the response parameters in Viewing a Job Instance List.
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
workspace |
No |
String |
Workspace ID.
|
Response Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
jobName |
Yes |
String |
Job name |
instanceId |
Yes |
Long |
Job instance ID |
status |
Yes |
String |
Job instance status.
|
planTime |
Yes |
Long |
Planned execution time of the job instance |
startTime |
Yes |
Long |
Actual execution start time of the job instance |
endTime |
No |
Long |
Actual execution end time of the job instance |
executeTime |
No |
Long |
Execution duration in milliseconds |
total |
Yes |
Integer |
Total number of node records |
nodes |
Yes |
List<Node> |
Node instance status. For details, see Table 4. |
instanceType |
Yes |
Integer |
Job scheduling modes.
|
forceSuccess |
No |
boolean |
Whether the job instance status is forcibly successful Default value: false |
ignoreSuccess |
No |
boolean |
Whether the job instance status is failure ignored Default value: false |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
nodeName |
Yes |
String |
Node name |
status |
Yes |
String |
Node status.
|
queue |
Yes |
String |
DLI resource queue name
NOTE:
Only the DLI SQL or DLI SPARK operator returns the DLI queue name in the response. |
planTime |
Yes |
Long |
Planned execution time of the job instance |
startTime |
Yes |
Long |
Actual execution start time of the node |
endTime |
No |
Long |
Actual execution end time of the node |
type |
Yes |
String |
Node type.
|
retryTimes |
No |
Integer |
Number of attempts upon a failure |
instanceId |
Yes |
Long |
Job instance ID |
inputRowCount |
No |
Long |
Rows of input data |
speed |
No |
number |
Write speed (row/second) |
logPath |
No |
String |
Path for storing node execution logs |
Example Request
GET /v1/b384b9e9ab9b4ee8994c8633aabc9505/jobs/job_batch/instances/34765
Example Response
- Success response
{ "jobName":"job_batch", "instanceId":34765, "instanceType": 2, "status":"fail", "planTime":1551425326540, "startTime":1551425327000, "endTime":1551425387000, "executeTime":1, "forceSuccess":false, "ignoreSuccess":false, "total":2, "nodes":[ { "endTime":1551671590000, "inputRowCount":0, "instanceId":34765, "nodeName":"Dummy_8556", "queue":"dlf_notdelete", "planTime":1551671580000, "retryTimes":0, "startTime":1551671584000, "status":"success", "type":"Dummy" }, { "endTime":1551671598000, "inputRowCount":0, "instanceId":34765, "logPath":"obs://dlf-test-log/job_batch/2019-03-04 11_53_00.000/error/error.job", "nodeName":"error", "planTime":1551671580000, "retryTimes":0, "startTime":1551671594000, "status":"success", "type":"DWS SQL" } ] }
- Failure response
{ "error_code":"DLF.0137", "error_msg":"Job instance does not exist." }
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot