调用DescribeFlowNodeInstance接口,查询节点实例(工作流节点实例和作业运行节点实例)详情。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeFlowNodeInstance

系统规定参数。取值:DescribeFlowNodeInstance

ProjectId String FP-7A1018ADE917****

项目ID

Id String FNI-FE4BD156E939****

节点实例ID。

RegionId String cn-hangzhou

地域ID。

返回数据

名称 类型 示例值 描述
Status String OK

实例的执行状态,取值如下:

  • PREP(等待启动)
  • SUBMITTING(提交中)
  • RUNNING(运行中)
  • DONE(已完成)
  • OK(执行成功)
  • FAILED(执行失败)
  • KILLED(已终止)
  • KILL_FAILED(终止失败)
  • START_RETRY(开始重试)
Type String JOB

节点类型,取值如下:

  • JOB:作业
  • CLUSTER:集群
  • START:开始
  • END:结束
EnvConf String {"key":"value"}

环境变量。

ProjectId String FP-7A1018ADE917****

项目ID。

RetryInterval String 15

重试间隔,单位s。

JobType String HIVE_SQL

作业类型。

Mode String YARN

模型模式。支持:YARN和LOCAL YARN。将作业包装成一个 launcher提交至YARN中执行LOCAL。作业直接在主机上以进程方式运行。

ExternalInfo String empty

外部信息。例如运行作业的错误诊断信息。

GmtModified Long 1540796247000

修改时间。

ExternalChildIds String application_1541559535023_34028

任务的application列表。

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"}]}

监控配置,只有SPARK_STREAMING类型作业支持。

ExternalStatus String SUCCESS

实例对应的Container的状态,取值如下:

  • SUBMITTED(已提交)
  • RUNNING(运行中)
  • SUCCESS(执行成功)
  • FAIL(执行失败)
  • KILL_FAIL(终止失败)
  • KILL_SUCCESS(终止成功)
RequestId String 1549175a-6d14-4c8a-89f9-5e28300f6d7e

请求ID。

JobName String myJob

作业名称。

RetryPolicy String

重试策略。

Adhoc Boolean true

是否临时查询。

ExternalId String application_1541559535023_34027

启动器的application的ID。

Pending Boolean true

是否结束。

ClusterId String C-F32FB31D8295****

集群ID。

MaxRetry String 0

最大重试次数。

FailAct String STOP

失败策略,取值如下:

  • STOP(终止工作流)
  • CONTINUE(跳过)
JobParams String ls -l

作业内容。

FlowInstanceId String FI-7CAF9709CD32****

工作流实例ID。

ParamConf String {"date":"${yyyy-MM-dd}"}

参数配置。

HostName String emr-header-1.cluster-12345

节点实例运行所在主机的名称。您可以登录主机使用hostname命令查看主机名称。

FlowId String F-35683D0E4573****

工作流ID。

Retries Integer 0

重试次数。

EndTime Long 1540796248000

运行结束时间。

StartTime Long 1540796237000

运行开始时间。

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

运行配置,取值如下:

  • priority:优先级。
  • userName:用于提交作业Linux用户。
  • memory:内存单位为MB。
  • cores: 核数。
ExternalSubId String container_1541559535023_34027_01_000001

启动器container的ID。

NodeName String 812589f5

节点名称。

JobId String FJ-A23BD131A862****

作业ID。

ClusterName String myCluster

集群名称。

GmtCreate Long 1540796236000

创建时间。

Duration Long 600

运行持续时间。

Id String FNI-FE4BD156E939****

节点实例ID

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeFlowNodeInstance
&ProjectId=FP-7A1018ADE917****
&Id=FNI-FE4BD156E939****
&RegionId=cn-hangzhou
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeFlowNodeInstanceResponse>
    <Status>OK</Status>
    <Type>JOB</Type>
    <EnvConf>{"key":"value"}</EnvConf>
    <ProjectId>FP-7A1018ADE917****</ProjectId>
    <RetryInterval>15</RetryInterval>
    <JobType>HIVE_SQL</JobType>
    <Mode>YARN</Mode>
    <ExternalInfo>empty</ExternalInfo>
    <GmtModified>1540796247000</GmtModified>
    <ExternalChildIds>application_1541559535023_34028</ExternalChildIds>
    <MonitorConf>{"inputs":[{"type":"KAFKA","clusterId":"C-1234567","topics":"kafka_topic","consumer.group":"kafka_consumer_group"}],"outputs":[{"type":"KAFKA","clusterId":"C-1234567","topics":"kafka_topic"}]}</MonitorConf>
    <ExternalStatus>SUCCESS</ExternalStatus>
    <RequestId>1549175a-6d14-4c8a-89f9-5e28300f6d7e</RequestId>
    <JobName>myJob</JobName>
    <RetryPolicy>无</RetryPolicy>
    <Adhoc>true</Adhoc>
    <ExternalId>application_1541559535023_34027</ExternalId>
    <Pending>true</Pending>
    <ClusterId>C-F32FB31D8295****</ClusterId>
    <MaxRetry>0</MaxRetry>
    <FailAct>STOP</FailAct>
    <JobParams>ls -l</JobParams>
    <FlowInstanceId>FI-7CAF9709CD32****</FlowInstanceId>
    <ParamConf>{"date":"${yyyy-MM-dd}"}</ParamConf>
    <HostName>emr-header-1.cluster-12345</HostName>
    <FlowId>F-35683D0E4573****</FlowId>
    <Retries>0</Retries>
    <EndTime>1540796248000</EndTime>
    <StartTime>1540796237000</StartTime>
    <RunConf>{"priority":1,"userName":"hadoop","memory":2048,"cores":1}</RunConf>
    <ExternalSubId>container_1541559535023_34027_01_000001</ExternalSubId>
    <NodeName>812589f5</NodeName>
    <JobId>FJ-A23BD131A862****</JobId>
    <ClusterName>myCluster</ClusterName>
    <GmtCreate>1540796236000</GmtCreate>
    <Duration>600</Duration>
    <Id>FNI-FE4BD156E939****</Id>
</DescribeFlowNodeInstanceResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Status" : "OK",
  "Type" : "JOB",
  "EnvConf" : "{\"key\":\"value\"}",
  "ProjectId" : "FP-7A1018ADE917****",
  "RetryInterval" : "15",
  "JobType" : "HIVE_SQL",
  "Mode" : "YARN",
  "ExternalInfo" : "empty",
  "GmtModified" : 1540796247000,
  "ExternalChildIds" : "application_1541559535023_34028",
  "MonitorConf" : "{\"inputs\":[{\"type\":\"KAFKA\",\"clusterId\":\"C-1234567\",\"topics\":\"kafka_topic\",\"consumer.group\":\"kafka_consumer_group\"}],\"outputs\":[{\"type\":\"KAFKA\",\"clusterId\":\"C-1234567\",\"topics\":\"kafka_topic\"}]}",
  "ExternalStatus" : "SUCCESS",
  "RequestId" : "1549175a-6d14-4c8a-89f9-5e28300f6d7e",
  "JobName" : "myJob",
  "RetryPolicy" : "无",
  "Adhoc" : true,
  "ExternalId" : "application_1541559535023_34027",
  "Pending" : true,
  "ClusterId" : "C-F32FB31D8295****",
  "MaxRetry" : "0",
  "FailAct" : "STOP",
  "JobParams" : "ls -l",
  "FlowInstanceId" : "FI-7CAF9709CD32****",
  "ParamConf" : "{\"date\":\"${yyyy-MM-dd}\"}",
  "HostName" : "emr-header-1.cluster-12345",
  "FlowId" : "F-35683D0E4573****",
  "Retries" : 0,
  "EndTime" : 1540796248000,
  "StartTime" : 1540796237000,
  "RunConf" : "{\"priority\":1,\"userName\":\"hadoop\",\"memory\":2048,\"cores\":1}",
  "ExternalSubId" : "container_1541559535023_34027_01_000001",
  "NodeName" : "812589f5",
  "JobId" : "FJ-A23BD131A862****",
  "ClusterName" : "myCluster",
  "GmtCreate" : 1540796236000,
  "Duration" : 600,
  "Id" : "FNI-FE4BD156E939****"
}

错误码

访问错误中心查看更多错误码。

访问错误中心查看更多错误码。