使用GetInstance擷取執行個體的詳情-巨量資料開發治理平台 DataWorks-阿里雲

調用GetInstance介面，擷取執行個體的詳細資料。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

dataworks:*

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
InstanceId	integer	是	執行個體的 ID。您可以調用 ListInstances 擷取。	1234
ProjectEnv	string	是	工作空間的環境，包括 PROD（生產環境）和 DEV（開發環境）。	PROD

返回參數

名稱	類型	描述	樣本值
	object	返回實體。
HttpStatusCode	integer	HTTP 狀態代碼。	200
RequestId	string	請求的 ID。用於定位日誌，排查問題。	E6F0DBDD-5AD****
ErrorMessage	string	調度執行個體失敗時的異常資訊。	test
Success	boolean	調用是否成功。	true
ErrorCode	string	錯誤碼。	0
Data	object	執行個體的詳細資料。
Status	string	任務的狀態，取值如下： NOT_RUN(1)：未運行 WAIT_TIME(2)：等待時間。等待定時時間到來 WAIT_RESOURCE(3)：等待資源。已經下發到執行引擎，在等待資源排隊調度執行 RUNNING(4)：運行中 CHECKING(7)：校正中。執行完畢，下發給資料品質進行資料校檢 CHECKING_CONDITION(8)：條件檢測中。執行完畢，正在做分支條件校正 WAIT_TRIGGER(9)：等待觸發。觸發式節點會在等待時間後變成等待觸發 FAILURE(5)：運行失敗 SUCCESS(6)：運行成功	NOT_RUN
CycTime	integer	執行個體的定時時間。	1590422400000
BeginRunningTime	integer	執行個體開始啟動並執行時間。	1590416703313
FinishTime	integer	執行個體啟動並執行結束時間。	1590416703313
CreateTime	integer	執行個體的建立時間。	1590416703313
DagId	integer	工作流程的 ID。	338450167
Priority	integer	執行個體運行優先順序，取值分為 1、3、5、7 和 8。取值越大，優先順序越高。預設優先順序為 1。	1
TaskType	string	執行個體的調度類型，取值如下： NORMAL(0)：正常調度任務。該任務被日常調度。 MANUAL(1)：手動任務。該任務不會被日常調度。 PAUSE(2)：凍結任務。該任務被日常調度，但啟動調度時直接被置為失敗狀態。 SKIP(3)：空跑任務。該任務被日常調度，但啟動調度時直接被置為成功狀態。 SKIP_UNCHOOSE(4)：臨時工作流程中未選擇的任務，僅存在於臨時工作流程中，啟動調度時直接被置為成功狀態。 SKIP_CYCLE(5)：未到運行周期的周或月任務。該任務被日常調度，但啟動調度時直接被置為成功狀態。 CONDITION_UNCHOOSE(6)：上遊執行個體中有分支（IF）節點，但是該下遊節點未被分支節點選中，直接置為空白跑任務。 REALTIME_DEPRECATED(7)：即時產生的已經到期的周期執行個體，該類型的任務直接被置為成功狀態。	NORMAL(0)
ParamValues	string	參數資訊。	bizdate=$bizdate tbods=$tbods tbdw=$tbdw tbpmic=$tbpmic tbpidx=$tbpidx tbptcif=$tbptcif
Connection	string	串連串。	odps_source
BaselineId	integer	基準 ID。	123123
DqcType	integer	資料品質 DQC 類型，取值如下： 0 表示有關聯 dqc。 1 表示沒有關聯 dqc。	1
DagType	string	工作流程的類型，取值如下： DAILY(0)：日常調度工作流程 MANUAL(1)：手動任務工作流程 SMOKE_TEST(2)：煙霧測試 (Smoke Test)工作流程 SUPPLY_DATA(3)：補資料工作流程 MANUAL_FLOW(4)：手動啟動並執行 dataflow pai 商務程序等（如 IDE 上點擊運行商務程序） BUSINESS_PROCESS_DAG(5)：手動商務程序工作流程	DAILY
BusinessId	integer	商務程序 ID。	123
TaskRerunTime	integer	執行個體還可以啟動並執行次數。取值可以為空白、以及大於等於 0 的整數。取值為空白，表示該執行個體對應的節點沒有設定自動重跑次數。取值為 0，表示該執行個體不能再重跑。取值為大於 0 的整數（假設為 n），表示該執行個體可重跑次數為 n。例如，該參數取值為 1，則剩餘重跑次數為 1，取值為 2，則剩餘重跑次數為 2，以此類推。初始值為對應節點定義的自動重跑次數+1。	0
PeriodNumber	integer	周期序號。表示任務執行個體處於當天的第幾輪周期。	1
ModifyTime	integer	執行個體的最新修改時間。	1590416703313
Repeatability	boolean	執行個體是否可以重複執行。	true
RepeatInterval	integer	調度任務運行出錯後，重新調整調度頻率，單位為毫秒（ms）。	60000
InstanceId	integer	執行個體的 ID。	11713307578
BeginWaitResTime	integer	執行個體開始等待資源的時間。	1590416703313
RelatedFlowId	integer	關聯的商務程序 ID。	123123
Bizdate	integer	業務日期。通常為該任務已耗用時間的前一天。	1590336000000
NodeName	string	節點的名稱。	kzh
BeginWaitTimeTime	integer	執行個體開始等待調度的時間。	1590416703313
DqcDescription	string	DQC 分區規則串。	[{"projectName":"ztjy_dim","tableName":"dim_user_agent_manage_area_a","partition":"ds\u003d$[yyyy-mm-dd-1]"}]
NodeId	integer	節點的 ID。	33115
CreateUser	string	執行個體建立人。	111
Owner	string	執行個體責任人。	111

樣本

正常返回樣本

JSON格式

{
  "HttpStatusCode": 200,
  "RequestId": "E6F0DBDD-5AD****",
  "ErrorMessage": "test",
  "Success": true,
  "ErrorCode": "0",
  "Data": {
    "Status": "NOT_RUN",
    "CycTime": 1590422400000,
    "BeginRunningTime": 1590416703313,
    "FinishTime": 1590416703313,
    "CreateTime": 1590416703313,
    "DagId": 338450167,
    "Priority": 1,
    "TaskType": "NORMAL(0)",
    "ParamValues": "bizdate=$bizdate tbods=$tbods tbdw=$tbdw tbpmic=$tbpmic tbpidx=$tbpidx tbptcif=$tbptcif",
    "Connection": "odps_source",
    "BaselineId": 123123,
    "DqcType": 1,
    "DagType": "DAILY",
    "BusinessId": 123,
    "TaskRerunTime": 0,
    "PeriodNumber": 1,
    "ModifyTime": 1590416703313,
    "Repeatability": true,
    "RepeatInterval": 60000,
    "InstanceId": 11713307578,
    "BeginWaitResTime": 1590416703313,
    "RelatedFlowId": 123123,
    "Bizdate": 1590336000000,
    "NodeName": "kzh",
    "BeginWaitTimeTime": 1590416703313,
    "DqcDescription": "[{\"projectName\":\"ztjy_dim\",\"tableName\":\"dim_user_agent_manage_area_a\",\"partition\":\"ds\\u003d$[yyyy-mm-dd-1]\"}]",
    "NodeId": 33115,
    "CreateUser": "111",
    "Owner": "111"
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。