You can call this operation to query a job.

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 DescribeFlowJob

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

Id String Yes FJ-BCCAE48B90CCB37B

The ID of the job.

ProjectId String Yes FP-257A173659F59685

The ID of the project.

RegionId String Yes cn-hangzhou

The ID of the region where your project resides.

Response parameters

Parameter Type Example Description
Adhoc String true

Indicates whether the job is a temporary query job.

AlertConf String "{\"items\":[{\"enable\":true,\"eventId\":\"EMR-210401001\",\"alertUserGroupIdList\":[\"AUG-52dabfbbca654b52aae05ac5acd9a0f0\"],\"alertDingDingGroupList\":[\"ADG-2c411c452e6b467b9a59fadf21d195ad\"]}]}"

The alert settings for the job instance.

CategoryId String FC-5BD9575E34623940

The directory ID of the job.

CustomVariables String "{\"scope\":\"PROJECT\",\"entityId\":\"FP-80C2FDDBF35D9CC5\",\"variables\":[{\"name\":\"v1\",\"value\":\"1\",\"properties\":{\"password\":true}}]}"

The custom variables configured for the job.

Description String This is the description of a job

The description of the job.

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 1538017814000

The creation time of the job.

GmtModified Long 1538017814000

The modification time of the job.

Id String FJ-BCCAE48B90CCB37B

The ID of the job.

LastInstanceId String FJI-ACCAE48B90CCB37B

The ID of the last executed job instance.

MaxRetry Integer 5

The maximum number of retries of running the node instance when a failure occurs.

  • Valid values: 0 to 5.
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"}]}

The monitoring configurations of the job. This parameter only applies to SPARK_STREAMING jobs.

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

The resources configured for the job.

Resource

The resource configured for the job.

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 interval between successive retries of running the node instance. Valid values: 0 to 300. Unit: seconds.

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: MR, SPARK, HIVE_SQL, HIVE, PIG, SQOOP, SPARK_SQL, SPARK_STREAMING, and SHELL.

mode String YARN

The submission mode of the job. Valid values: YARN and LOCAL.

Examples

Sample requests


http(s)://[Endpoint]/? Action=DescribeFlowJob
&Id=FJ-BCCAE48B90CCB37B
&ProjectId=FP-257A173659F59685
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

<DescribeFlowJobResponse>
  <FailAct>STOP</FailAct>
	  <CategoryId>FC-F2495319DA05CEE5</CategoryId>
	  <Description>shell</Description>
	  <RequestId>7D2B1B2E-8D89-49C1-8D31-097C83879D20</RequestId>
	  <GmtCreate>1538017814000</GmtCreate>
	  <GmtModified>1538017814000</GmtModified>
	  <Params>ls -l</Params>
	  <MaxRetry>0</MaxRetry>
	  <Name>shell_copy</Name>
	  <Type>SHELL</Type>
	  <ResourceList></ResourceList>
	  <RetryInterval>15</RetryInterval>
	  <Id>FJ-C7FB9F1075C7****</Id>
	
</DescribeFlowJobResponse>

JSON format

{
	"FailAct":"STOP",
	"Description":"shell",
	"Type":"SHELL",
	"GmtCreate":1538017814000,
	"GmtModified":1538017814000,
	"Name":"shell_copy",
	"MaxRetry":0,
	"CategoryId":"FC-F2495319DA05CEE5",
	"RetryInterval":15,
	"ResourceList":{
		"Resource":[]
	},
	"RequestId":"7D2B1B2E-8D89-49C1-8D31-097C83879D20",
	"Params":"ls -l",
	"Id":"FJ-C7FB9F1075C7****"
}

Error codes

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