Skip to main content

View ConsoleJob

Interface Summary

Querying async job detail inclusive of job description, sub-steps etc. to ascertain the status of operations such as task creation and task deletion

Interface Address

/cloudcanal/console/api/v1/openapi/consolejob/queryconsolejob

Request Manner

POST

Request Parameters

ParameterNameParameter DescriptionRequestTypeWhether RequiredDataType
consoleJobIdThe asynchronous job identifier, typically obtained from the created jobBodyTrueLong

Common Response Result

ParameterNameParameter DescriptionType(Java)NotNull
code1: Success
0: Failure
StringTrue
dataObjectFalse
msgStringFalse
requestIdStringTrue

Data Parameter Description

The data incorporates the entire overview of the asynchronous job in tandem with the status of each step.

Parameter NameParameter DescriptionType(Java)NotNull
idPrimary KeyLongTrue
gmtCreateCreatTimeStringTrue
gmtModifiedModifyTimeStringTrue
jobTokenAsynchronous task identifierStringTrue
labelAsynchronous task typeStringTrue
dataJobNameAsynchronous task related task nameStringFalse
dataJobDescAsynchronous task descriptionStringFalse
workerNameThe total number of machines operating normally within that clusterintFalse
workerDescThe aggregate number of anomalous/faulty machines within that clusterintFalse
dsInstanceIdOwner nameStringfalse
datasourceDescOwner nameStringfalse
taskStateTask state

WAIT_START
EXECUTE
SUCCESS
FAILED
CANCELED
SKIP
StringTrue
launcherTask operatorStringtrue
launchTimeTask activation timeStringfalse
finishTimeTask completion timeStringfalse
userRoleTypeTask performer role

SYSTEM
ORG_ADMIN
StringTrue
resourceTypeRelated resource type

DATA_JOB
CONSOLE_USER
WORKER
DATASOURCE
StringFalse
resourceIdRelated resource identifierLongFalse

taskVOList denotes the step list, which can be retried or disregarded (if possible) in the event of failure.

ParameterNameParameter DescriptionType(Java)NotNull
idPrimary KeyLongTrue
gmtCreateCreatTimeStringTrue
gmtModifiedModifyTimeStringTrue
jobIdAsynchronous task associated step identifierLongTrue
taskStateCurrent step state

WAIT_START
EXECUTE
SUCCESS
FAILED
CANCELED
SKIP
StringTrue
contextThe context pertaining to the associated stepStringTrue
hostAddress of the machine executing the stepStringTrue
executeOrderSequential execution orderIntTrue
executeTimeStep execution timeStringFalse
finishTimeThe timestamp for step completion.StringFalse
messageIn the event of anomalous step execution, the relevant exception information will be presented here.StringFalse
cancelableNon-ignorableBooleanTrue
stepNameThe step name with internationalization.StringTrue

Response Example

{
"requestId": "36e910a4-2b4e-11ec-8c7e-4d8116d1099b",
"code": "1",
"msg": "request success",
"data": {
"id": 1081,
"gmtCreate": "2021-10-08T05:15:05.000+0000",
"gmtModified": "2021-10-08T05:15:13.000+0000",
"jobToken": "b2a4424c-27f6-11ec-8a1c-e94c1c29eb93",
"label": "DATA_JOB_CREATE",
"dataJobName": "canalp417v2d81ir",
"dataJobDesc": "123",
"workerName": null,
"workerDesc": null,
"dsInstanceId": null,
"datasourceDesc": null,
"taskState": "SUCCESS",
"launcher": "liqiang",
"launchTime": "2021-10-08T05:15:06.000+0000",
"finishTime": "2021-10-08T05:15:14.000+0000",
"taskVOList": [
{
"id": 3409,
"gmtCreate": "2021-10-08T05:15:05.000+0000",
"gmtModified": "2021-10-08T05:15:13.000+0000",
"jobId": 1081,
"taskState": "SUCCESS",
"context": "{\"consoleJobId\":0,\"dataJobId\":511,\"resources\":[]}",
"host": "192.168.0.133",
"executeOrder": 0,
"executeTime": "2021-10-08T05:15:06.000+0000",
"finishTime": "2021-10-08T05:15:13.000+0000",
"message": null,
"cancelable": true,
"stepName": "\"MySQL->MySQL Data Migration\""
},
{
"id": 3410,
"gmtCreate": "2021-10-08T05:15:05.000+0000",
"gmtModified": "2021-10-08T05:15:13.000+0000",
"jobId": 1081,
"taskState": "SUCCESS",
"context": "{\"consoleJobId\":0,\"dataJobId\":511,\"resources\":[]}",
"host": "192.168.0.133",
"executeOrder": 1,
"executeTime": "2021-10-08T05:15:13.000+0000",
"finishTime": "2021-10-08T05:15:14.000+0000",
"message": null,
"cancelable": false,
"stepName": "\"Allocating task performing machines\""
},
{
"id": 3411,
"gmtCreate": "2021-10-08T05:15:05.000+0000",
"gmtModified": "2021-10-08T05:15:13.000+0000",
"jobId": 1081,
"taskState": "SUCCESS",
"context": "{\"consoleJobId\":0,\"dataJobId\":511,\"resources\":[]}",
"host": "192.168.0.133",
"executeOrder": 2,
"executeTime": "2021-10-08T05:15:14.000+0000",
"finishTime": "2021-10-08T05:15:14.000+0000",
"message": null,
"cancelable": false,
"stepName": "\"Instantiating the task state machine\""
},
{
"id": 3412,
"gmtCreate": "2021-10-08T05:15:05.000+0000",
"gmtModified": "2021-10-08T05:15:13.000+0000",
"jobId": 1081,
"taskState": "SUCCESS",
"context": "{\"consoleJobId\":0,\"dataJobId\":511,\"resources\":[]}",
"host": "192.168.0.133",
"executeOrder": 3,
"executeTime": "2021-10-08T05:15:14.000+0000",
"finishTime": "2021-10-08T05:15:14.000+0000",
"message": null,
"cancelable": false,
"stepName": "\"Task creation complete\""
}
],
"userRoleType": "SYSTEM",
"resourceType": "DATA_JOB",
"resourceId": 511
}
}