You can call DescribeFlowJob operation to query the information of a job.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. You can use OpenAPI Explorer to search for API operations, call API operations, and dynamically generate SDK sample code.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeFlowJob

The operation that you want to perform. For API requests using the HTTP or HTTPS URL, this parameter is required. Set the value to DescribeFlowJob.

Id String Yes FJ-BCCAE48B90CC****

The ID of the job. You can call ListFlowJob View.

ProjectId String Yes FP-257A173659F5****

The ID of the project. You can call ListFlowProject View the project ID.

RegionId String Yes cn-hangzhou

The ID of the region. You can call DescribeRegions View the latest list of Alibaba Cloud regions.

Response parameters

Parameter Type Example Description
Adhoc String false

Indicates whether the query is an ad hoc query. Valid values:

  • true: Ad-hoc query.
  • false: The query is not an ad hoc query.
AlertConf String "{\"items\":[{\"enable\":true,\"eventId\":\"EMR-210401001\",\"alertUserGroupIdList\":[\"AUG-52dabfbbca654b52aae05ac5acd9a0f0\"],\"alertDingDingGroupList\":[\"ADG-2c411c452e6b467b9a59fadf21d195ad\"]}]}"

The alert settings for the job instance.
CategoryId String FC-5BD9575E3462****

The directory ID of the job.
CustomVariables String N/A

The custom variables configured for the job.
Description String This is the description of a job

The description of the job.
EditLockDetail String N/A

Retain parameters.
EnvConf String {"key":"value"}

The environment variables configured for the job.
FailAct String CONTINUE

The action to take upon an operation failure of the node instance. Valid values:

  • CONTINUE: skips the node instance
  • STOP: stops the workflow instance
GmtCreate Long 1538017813000

The time when the accelerated domain name was created.
GmtModified Long 1538017814000

The modification time of the job.
Id String FJ-BCCAE48B90CC****

The ID of the job.
LastInstanceId String FJI-0BA97D0BB8F3****

The ID of the last executed job instance.
MaxRetry Integer 5

The maximum number of retries. The value ranges from 0 to 5.
MaxRunningTimeSec Long 0

Retain parameters.
MonitorConf String {"inputs":[{"type":"KAFKA","clusterId":"C-1234567","topics":"kafka_topic","consumer.group":"kafka_consumer_group"}],"outputs":[{"type":"KAFKA","clusterId":"C-1234567","topics":"kafka_topic"}]}

Monitoring configuration, only SPARK_STREAMING Job type support.

Name String my_shell_job

The name of the job.
ParamConf String {"date":"${yyyy-MM-dd}"}

The configuration parameters of the job.
Params String ls -l

The content of the job.
RequestId String 1549175a-6d14-4c8a-89f9-5e28300f6d7e

The ID of the request.
ResourceList Array of Resource

The resources configured for the job.
Resource
Alias String demo.jar

The alias of the resource.
Path String oss://path/demo.jar

The storage path of the resource.
RetryInterval Long 200

The retry interval ranges from 0 to 300. Unit: seconds.
RetryPolicy String N/A

Retain parameters.
RunConf String {"priority":1,"userName":"hadoop","memory":2048,"cores":1}

The scheduling parameters configured for the job.

  • priority: the priority of the job.
  • userName: the name of the Linux user who submitted the job.
  • memory: The memory allocated to the job. Unit: MB.
  • cores: the number of vCPUs allocated to the job.
Type String SHELL

The type of the job. Valid values: SPARK_SQL, SPARK_STREAMING, MR, SQOOP, PIG, FLINK, STREAMING_SQL, IMPALA_SQL, PRESTO_SQL, SPARK, Hive_SQL, Hive, SHELL, and SPARK_SHELL.

mode String YARN

The model mode. Valid values: YARN and LOCAL.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeFlowJob
&Id=FJ-BCCAE48B90CC****
&ProjectId=FP-257A173659F5****
&RegionId=cn-hangzhou
&<common request parameters>

Sample success responses

XML format 

<FailAct>STOP</FailAct>
<CategoryId>FC-F2495319D****</CategoryId>
<Description>shell</Description>
<RequestId>7D2B1B2E-8D89-49C1-8D31-097C83879D20</RequestId>
<GmtCreate>1538017813000</GmtCreate>
<GmtModified>1538017814000</GmtModified>
<Params>ls -l</Params>
<ParamConf>{}</ParamConf>
<Adhoc>false</Adhoc>
<LastInstanceId>FJI-0BA97D0BB8F3****</LastInstanceId>
<MaxRetry>0</MaxRetry>
<MaxRunningTimeSec>0</MaxRunningTimeSec>
<Name>shell_copy</Name>
<Type>SHELL</Type>
<ResourceList>
</ResourceList>
<RetryInterval>15</RetryInterval>
<Id>FJ-C7FB9F1075C7****</Id>
<AlertConf>{}</AlertConf>

JSON 

{
    "FailAct": "STOP",
    "CategoryId": "FC-F2495319D****",
    "Description": "shell",
    "RequestId": "7D2B1B2E-8D89-49C1-8D31-097C83879D20",
    "GmtCreate": 1538017813000,
    "GmtModified": 1538017814000,
    "Params": "ls -l",
    "ParamConf": "{}",
    "Adhoc": false,
    "LastInstanceId": "FJI-0BA97D0BB8F3****",
    "MaxRetry": 0,
    "MaxRunningTimeSec": 0,
    "Name": "shell_copy",
    "Type": "SHELL",
    "ResourceList": {
        "Resource": []
    },
    "RetryInterval": 15,
    "Id": "FJ-C7FB9F1075C7****",
    "CustomVariables": [],
    "AlertConf": "{}"
}