この操作を呼び出して、ワークフローインスタンスを照会することができます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この API は、OpenAPI Explorerで呼び出すことを推奨します。 OpenAPI Explorer は、各種 SDK に用意されている API のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須/任意 説明
Action String 必須 DescribeFlowInstance

実行する操作。 値を DescribeFlowInstance に設定します。

Id String 必須 FI-7CAF9709CD32****

ワークフローインスタンスの ID。

ProjectId String 必須 FP-7A1018ADE917****

プロジェクトの ID。

RegionId String 必須 cn-hangzhou

プロジェクトが属するリージョンの ID。

レスポンスパラメーター

パラメーター データ型 説明
ClusterId String C-F32FB31D8295****

クラスターの ID。

CronExpression String * * * * * ?

ワークフローを時間ベースでスケジューリングするための CRON 式。

DependencyFlowList

ワークフローの親ワークフローのリスト。

ParentFlow

ワークフローの親ワークフロー。

BizDate Long 1540796248000

親ワークフローインスタンスの実行時間。

DependencyFlowId String F-96853646C4559D42

親ワークフローの ID。

DependencyInstanceId String FI-96853646C4559D42

親ワークフローインスタンスの ID。

FlowId String F-96853646C4559D49

ワークフローの ID。

FlowInstanceId String FI-96853646C4559D49

ワークフローインスタンスの ID。

ProjectId String FP-96853646C4559D49

プロジェクトの ID。

ScheduleKey String 20191212

ワークフローのスケジュール時間のキー。

Duration Long 12000

ワークフローインスタンスの実行期間。 単位:ミリ秒

EndTime Long 1540796248000

ワークフローインスタスが停止した時間。

FlowId String F-35683D0E4573****

ワークフローの ID。

FlowName String flow-hive

ワークフローの名前。

GmtCreate Long 1540796248000

クラスターの作成時刻です。

GmtModified Long 1540796248000

ワークフローの変更時刻。

Graph String {"nodes":[{"shape":"startControlNode","size":"80*34","spmAnchorId":"0.0.0.i0.766645eb2cmNtQ","x":500,"y":250,"index":0,"id":"48d474ea","attribute":{"type":"START"},"type":"node"},{"shape":"hiveSQLJobNode","size":"170*34","spmAnchorId":"5176.8250060.0.i11.499128d0KWdQvq","x":515,"y":334.5,"index":1,"id":"2f089966","label":"hive-test","attribute":{"jobId":"FJ-C6C794219DE652B9","type":"JOB","jobType":"HIVE_SQL"},"type":"node","config":{"hostName":"","clusterId":""}},{"shape":"endControlNode","size":"80*34","spmAnchorId":"5176.8250060.0.i15.499128d0KWdQvq","x":532,"y":453.5,"index":2,"id":"ac092a54","attribute":{"type":"END"},"type":"node"}],"edges":[{"sourceAnchor":0,"targetAnchor":0,"index":3,"source":"48d474ea","id":"77e6117c","target":"2f089966"},{"sourceAnchor":1,"targetAnchor":0,"index":4,"source":"2f089966","id":"95ba3716","target":"ac092a54"}]}

ワークフローの有向非循環グラフ (DAG) の情報。

HasNodeFailed Boolean false

このパラメーターは使用できません。

Id String FI-7CAF9709CD32****

ワークフローインスタンスの ID。

NodeInstance

ワークフローインスタンスのノードインスタンス。

NodeInstance

ノードインスタンスの情報。

ClusterId String C-F32FB31D82954C64

クラスターの ID。

Duration Long 11000

ノードインスタンスの実行時間。

EndTime Long 1540796248000

ノードインスタスが停止した時刻。

ExternalId String application_1540362938289_1858

ノードインスタンスの外部 ID (ランチャーアプリケーションのID など)。

ExternalInfo String empty

ノードインスタンスの外部情報 (エラー診断情報など)。

ExternalStatus String SUCCESS

ノードインスタンスの外部ステータス。 有効な値:

  • SUBMITTED:ノードインスタンスが送信された。
  • RUNNING:ノードインスタンスが実行中。
  • SUCCESS:ノードインスタンスの実行が成功した。
  • FAIL:ノードインスタンスの実行が失敗した。
  • KILL_FAIL:ノードインスタンスの強制終了が失敗した。
  • KILL_SUCCESS:ノードインスタンスの強制終了が成功した。
FailAct String STOP

ノードインスタンスが失敗した場合に実行する操作。 有効な値:

  • STOP:ワークフローインスタンスを停止する。
  • CONTINUE:ノードインスタンスをスキップする。
GmtCreate Long 1540796236000

ジョブの作成時刻。

GmtModified Long 1540796247000

ジョブの変更時刻。

HostName String emr-header-1.cluster-12345

ノードインスタンスが実行されているホストの名前。 ホストはマスターホストまたはゲートウェイホストです。 ホスト名の書式は emr-header-1.cluster-12345 です。 hostname コマンドを実行すると、このパラメーターの値を確認することができます。

Id String FNI-9D14A7CCF2687B84

ノードインスタンスの ID。

JobId String FJ-C6C794219DE652B9

対応するジョブの ID。

JobName String hive-test

対応するジョブの名前。

JobType String HIVE_SQL

対応するジョブのタイプ。

MaxRetry String 0

ノードインスタンスの実行の再試行回数。

NodeName String 2f089966

ノード名。

Pending Boolean true

ノードインスタンスの実行が終了したかどうかを示します。

ProjectId String FP-7A1018ADE9179EE1

プロジェクトの ID。

Retries Integer 0

ノードインスタンスの実行の再試行回数。

RetryInterval String 15

ノードインスタンスの実行を連続して再試行する間隔。 単位:秒。

StartTime Long 1540796237000

ノードインスタスが実行を開始した時刻。

Status String OK

ノードインスタンスのステータス。 有効な値: PREP、SUBMITTING、RUNNING、DONE、OK、FAILED、KILLED、KILL_FAILED、および START_RETRY 。 PREP は、ノードインスタンスが準備中であることを示します。 SUBMITTING は、ノードインスタンスが送信中であることを示します。 RUNNING は、ノードインスタンスが実行中であることを示します。 DONE は、ノードインスタンスの実行が完了したことを示します。 OK は、ノードインスタンスの実行が成功したことを示します。 FAILED は、ノードインスタンスの実行に失敗したことを示します。 KILLEDは、ノードインスタンスが強制終了したことを示します。 KILL_FAILED は、ノードインスタンスの強制終了に失敗したことを示します。 START_RETRY は、ノードインスタンスが再起動中であることを示します。

Type String JOB

ノードの種類。 有効な値: JOB、CLUSTER、START、および END。 これらの値は、それぞれジョブノード、クラスターノード、開始ノード、および終了ノードを示します。

ProjectId String FP-7A1018ADE917****

プロジェクトの ID。

RequestId String EDF99BA3-F7AF-49B2-ABA1-36430A31F482

リクエストの ID。

ScheduleTime Long 1540796236000

クラスターのスケジューリングされた時刻。

StartTime Long 1540796236000

ワークフローインスタスが実行を開始した時刻。

Status String SUCCEEDED

ワークフローインスタンスのステータス。 有効な値:

  • PREP:ワークフローインスタンスの準備中。
  • RUNNING:ワークフローインスタンスが実行中。
  • SUCCEEDED:ワークフローインスタンスの実行に成功した。
  • FAILED:ワークフローインスタンスの実行に失敗した。
  • Terminated:ワークフローインスタンスが強制終了された。
  • SUSPENDED:ワークフローインスタンスが一時停止中。

リクエストの例


http(s)://[Endpoint]/? Action=DescribeFlowInstance
&Id=FI-7CAF9709CD32****
&ProjectId=FP-7A1018ADE917****
&RegionId=cn-hangzhou
&<共通リクエストパラメーター>

通常のレスポンス例

XML 形式

<DescribeFlowInstanceResponse>
	  <data>
		    <Status>SUCCEEDED</Status>
		    <RequestId>EDF99BA3-F7AF-49B2-ABA1-36430A31F482</RequestId>
		    <EndTime>1540796248000</EndTime>
		    <ClusterId>C-F32FB31D8295****</ClusterId>
		    <GmtModified>1540796247000</GmtModified>
		    <StartTime>1540796236000</StartTime>
		    <ProjectId>FP-7A1018ADE917****</ProjectId>
		    <Duration>12000</Duration>
		    <FlowId>F-35683D0E4573****</FlowId>
		    <GmtCreate>1540796235000</GmtCreate>
		    <Graph>
			      <nodes>
				        <shape>startControlNode</shape>
				        <size>80*34</size>
				        <spmAnchorId>0.0.0.i0.766645eb2c****</spmAnchorId>
				        <x>500</x>
				        <y>250</y>
				        <index>0</index>
				        <id>48d4****</id>
				        <attribute>
					          <type>START</type>
				        </attribute>
				        <type>node</type>
			      </nodes>
			      <nodes>
				        <shape>hiveSQLJobNode</shape>
				        <size>170*34</size>
				        <spmAnchorId>5176.8250060.0.i11.499128d0KW****</spmAnchorId>
				        <x>515</x>
				        <y>334.5</y>
				        <index>1</index>
				        <id>2f089966</id>
				        <label>hive-test</label>
				        <attribute>
					          <jobId>FJ-C6C794219DE6****</jobId>
					          <type>JOB</type>
					          <jobType>HIVE_SQL</jobType>
				        </attribute>
				        <type>node</type>
				        <config>
					          <hostName></hostName>
					          <clusterId></clusterId>
				        </config>
			      </nodes>
			      <nodes>
				        <shape>endControlNode</shape>
				        <size>80*34</size>
				        <spmAnchorId>5176.8250060.0.i15.499128d0KW****</spmAnchorId>
				        <x>532</x>
				        <y>453.5</y>
				        <index>2</index>
				        <id>ac09****</id>
				        <attribute>
					          <type>END</type>
				        </attribute>
				        <type>node</type>
			      </nodes>
			      <edges>
				        <sourceAnchor>0</sourceAnchor>
				        <targetAnchor>0</targetAnchor>
				        <index>3</index>
				        <source>48d474ea</source>
				        <id>77e6****</id>
				        <target>2f089966</target>
			      </edges>
			      <edges>
				        <sourceAnchor>1</sourceAnchor>
				        <targetAnchor>0</targetAnchor>
				        <index>4</index>
				        <source>2f089966</source>
				        <id>95ba****</id>
				        <target>ac092a54</target>
			      </edges>
		    </Graph>
		    <FlowName>flow-hive</FlowName>
		    <Id>FI-7CAF9709CD328EBE</Id>
		    <NodeInstance>
			      <NodeInstance>
				        <FailAct>STOP</FailAct>
				        <Status>OK</Status>
				        <EndTime>1540796236000</EndTime>
				        <ClusterId>C-F32FB31D8295****</ClusterId>
				        <NodeName>:start:</NodeName>
				        <GmtModified>1540796236000</GmtModified>
				        <StartTime>1540796236000</StartTime>
				        <ProjectId>FP-7A1018ADE917****</ProjectId>
				        <Duration>0</Duration>
				        <MaxRetry>0</MaxRetry>
				        <Type>START</Type>
				        <GmtCreate>1540796236000</GmtCreate>
				        <Retries>0</Retries>
				        <Id>FNI-1286C1ED46C4****</Id>
				        <HostName></HostName>
				        <Pending>false</Pending>
			      </NodeInstance>
			      <NodeInstance>
				        <FailAct>STOP</FailAct>
				        <Status>OK</Status>
				        <EndTime>1540796248000</EndTime>
				        <ClusterId>C-F32FB31D8295****</ClusterId>
				        <NodeName>2f089966</NodeName>
				        <ExternalId>application_1540362938289_1858</ExternalId>
				        <JobName>hive-test</JobName>
				        <GmtModified>1540796247000</GmtModified>
				        <StartTime>1540796237000</StartTime>
				        <ProjectId>FP-7A1018ADE917****</ProjectId>
				        <Duration>11000</Duration>
				        <MaxRetry>0</MaxRetry>
				        <ExternalStatus>SUCCESS</ExternalStatus>
				        <Type>JOB</Type>
				        <GmtCreate>1540796236000</GmtCreate>
				        <JobType>HIVE_SQL</JobType>
				        <ExternalInfo></ExternalInfo>
				        <Retries>0</Retries>
				        <RetryInterval>15</RetryInterval>
				        <Id>FNI-9D14A7CCF268****</Id>
				        <HostName>emr-header-1.cluster-500159692</HostName>
				        <JobId>FJ-C6C794219DE6****</JobId>
				        <Pending>false</Pending>
			      </NodeInstance>
			      <NodeInstance>
				        <FailAct>STOP</FailAct>
				        <Status>OK</Status>
				        <EndTime>1540796248000</EndTime>
				        <ClusterId>C-F32FB31D8295****</ClusterId>
				        <NodeName>ac092a54</NodeName>
				        <GmtModified>1540796247000</GmtModified>
				        <StartTime>1540796248000</StartTime>
				        <ProjectId>FP-7A1018ADE917****</ProjectId>
				        <Duration>0</Duration>
				        <MaxRetry>0</MaxRetry>
				        <Type>END</Type>
				        <GmtCreate>1540796247000</GmtCreate>
				        <Retries>0</Retries>
				        <Id>FNI-14C14E312AF9****</Id>
				        <HostName></HostName>
				        <Pending>false</Pending>
			      </NodeInstance>
		    </NodeInstance>
	  </data>
	  <requestId>EDF99BA3-F7AF-49B2-ABA1-36430A31F482</requestId>
</DescribeFlowInstanceResponse>

JSON 形式

{
	"requestId":"EDF99BA3-F7AF-49B2-ABA1-36430A31F482",
	"data":{
		"NodeInstance":{
			"NodeInstance":[
				{
					"FailAct":"STOP",
					"Retries":0,
					"Type":"START",
					"GmtCreate":1540796236000,
					"GmtModified":1540796236000,
					"HostName":"",
					"Status":"OK",
					"MaxRetry":0,
					"ClusterId":"C-F32FB31D8295****",
					"Duration":0,
					"Id":"FNI-1286C1ED46C4****",
					"EndTime":1540796236000,
					"StartTime":1540796236000,
					"Pending":false,
					"ProjectId":"FP-7A1018ADE917****",
					"NodeName":":start:"
				},
				{
					"FailAct":"STOP",
					"Retries":0,
					"Type":"JOB",
					"ExternalId":"application_1540362938289_1858",
					"JobName":"hive-test",
					"GmtCreate":1540796236000,
					"GmtModified":1540796247000,
					"HostName":"emr-header-1.cluster-500159692",
					"JobType":"HIVE_SQL",
					"Status":"OK",
					"MaxRetry":0,
					"RetryInterval":15,
					"ClusterId":"C-F32FB31D8295****",
					"JobId":"FJ-C6C794219DE6****",
					"Duration":11000,
					"Id":"FNI-9D14A7CCF268****",
					"EndTime":1540796248000,
					"ExternalInfo":"",
					"StartTime":1540796237000,
					"ExternalStatus":"SUCCESS",
					"Pending":false,
					"ProjectId":"FP-7A1018ADE917****",
					"NodeName":"2f089966"
				},
				{
					"FailAct":"STOP",
					"Retries":0,
					"Type":"END",
					"GmtCreate":1540796247000,
					"GmtModified":1540796247000,
					"HostName":"",
					"Status":"OK",
					"MaxRetry":0,
					"ClusterId":"C-F32FB31D8295****",
					"Duration":0,
					"Id":"FNI-14C14E312AF94FB8",
					"EndTime":1540796248000,
					"StartTime":1540796248000,
					"Pending":false,
					"ProjectId":"FP-7A1018ADE917****",
					"NodeName":"ac092a54"
				}
			]
		},
		"FlowId":"F-35683D0E4573****",
		"GmtCreate":1540796235000,
		"GmtModified":1540796247000,
		"Status":"SUCCEEDED",
		"ClusterId":"C-F32FB31D8295****",
		"FlowName":"flow-hive",
		"RequestId":"EDF99BA3-F7AF-49B2-ABA1-36430A31F482",
		"Duration":12000,
		"Graph":{
			"edges":[
				{
					"id":"77e6****",
					"index":3,
					"source":"48d474ea",
					"sourceAnchor":0,
					"target":"2f089966",
					"targetAnchor":0
				},
				{
					"id":"95ba****",
					"index":4,
					"source":"2f089966",
					"sourceAnchor":1,
					"target":"ac092a54",
					"targetAnchor":0
				}
			],
			"nodes":[
				{
					"id":"48d4****",
					"index":0,
					"spmAnchorId":"0.0.0.i0.766645eb2c****",
					"attribute":{
						"type":"START"
					},
					"shape":"startControlNode",
					"type":"node",
					"y":250,
					"x":500,
					"size":"80*34"
				},
				{
					"id":"2f089966",
					"index":1,
					"spmAnchorId":"5176.8250060.0.i11.499128d0KW****",
					"config":{
						"hostName":"",
						"clusterId":""
					},
					"attribute":{
						"jobType":"HIVE_SQL",
						"jobId":"FJ-C6C794219DE6****",
						"type":"JOB"
					},
					"label":"hive-test",
					"shape":"hiveSQLJobNode",
					"type":"node",
					"y":334.5,
					"x":515,
					"size":"170*34"
				},
				{
					"id":"ac09****",
					"index":2,
					"spmAnchorId":"5176.8250060.0.i15.499128d0KW****",
					"attribute":{
						"type":"END"
					},
					"shape":"endControlNode",
					"type":"node",
					"y":453.5,
					"x":532,
					"size":"80*34"
				}
			]
		},
		"EndTime":1540796248000,
		"Id":"FI-7CAF9709CD328EBE",
		"StartTime":1540796236000,
		"ProjectId":"FP-7A1018ADE917****"
	}
}

エラーコード

エラーコードについては、「API エラーセンター」をご参照ください。