全部产品
Search
文档中心

大数据开发治理平台 DataWorks:GetInstance

更新时间:Mar 08, 2024

调用GetInstance接口,获取实例的详细信息。

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String GetInstance

系统规定参数。取值:GetInstance

InstanceId Long 1234

实例的ID。您可以调用ListInstances获取。

ProjectEnv String PROD

工作空间的环境,包括PROD(生产环境)和DEV(开发环境)。

返回数据

名称

类型

示例值

描述

HttpStatusCode Integer 200

HTTP状态码。

RequestId String E6F0DBDD-5AD****

请求的ID。用于定位日志,排查问题。

ErrorMessage String test

调度实例失败时的异常信息。

Success Boolean true

调用是否成功。

ErrorCode String 0

错误码。

Data Object

实例的详细信息。

Status String NOT_RUN

任务的状态,取值如下:

  • NOT_RUN(未运行)
  • WAIT_TIME(等待定时时间dueTime或cycleTime到来)
  • WAIT_RESOURCE(等待资源)
  • RUNNING(运行中)
  • CHECKING(下发给数据质量进行数据校检)
  • CHECKING_CONDITION(正在进行分支条件校检)
  • FAILURE(执行失败)
  • SUCCESS(执行成功)
CycTime Long 1590422400000

实例的定时时间。

BeginRunningTime Long 1590416703313

实例开始运行的时间。

FinishTime Long 1590416703313

实例运行的结束时间。

CreateTime Long 1590416703313

实例的创建时间。

DagId Long 338450167

工作流的ID。

Priority Integer 1

实例运行优先级,取值分为1、3、5、7和8。取值越大,优先级越高。默认优先级为1。

TaskType String NORMAL(0)

实例的调度类型,取值如下:

  • NORMAL(0):正常调度任务。该任务被日常调度。
  • MANUAL(1):手动任务。该任务不会被日常调度。
  • PAUSE(2):冻结任务。该任务被日常调度,但启动调度时直接被置为失败状态。
  • SKIP(3):空跑任务。该任务被日常调度,但启动调度时直接被置为成功状态。
  • SKIP_UNCHOOSE(4):临时工作流中未选择的任务,仅存在于临时工作流中,启动调度时直接被置为成功状态。
  • SKIP_CYCLE(5):未到运行周期的周或月任务。该任务被日常调度,但启动调度时直接被置为成功状态。
  • CONDITION_UNCHOOSE(6):上游实例中有分支(IF)节点,但是该下游节点未被分支节点选中,直接置为空跑任务。
  • REALTIME_DEPRECATED(7):实时生成的已经过期的周期实例,该类型的任务直接被置为成功状态。
ParamValues String bizdate=$bizdate tbods=$tbods tbdw=$tbdw tbpmic=$tbpmic tbpidx=$tbpidx tbptcif=$tbptcif

参数信息。

Connection String odps_source

连接串。

BaselineId Long 123123

基线ID。

DqcType Integer 1

数据质量DQC类型,取值如下:

  • 0表示有关联dqc。
  • 1表示没有关联dqc。
DagType String DAILY

工作流的类型,取值如下:

  • DAILY(日常调度)
  • MANUAL(手动任务)
  • SMOKE_TEST(冒烟测试)
  • SUPPLY_DATA(补数据)
BusinessId Long 123

业务流程ID。

TaskRerunTime Integer 0

实例还可以重跑的次数。取值可以为空、以及大于等于0的整数。

  • 取值为空,表示该实例对应的节点没有设置重跑次数。
  • 取值为0,表示该实例对应的节点不能再重跑。
  • 取值为大于0的整数(假设为n),表示该实例对应的节点剩余重跑次数为n。例如,该参数取值为1,则剩余重跑次数为1,取值为2,则剩余重跑次数为2,以此类推。
ModifyTime Long 1590416703313

实例的最新修改时间。

Repeatability Boolean true

实例是否可以重复执行。

RepeatInterval Long 60000

调度任务运行出错后,重新调整调度频率,单位为毫秒(ms)。

InstanceId Long 11713307578

实例的ID。

BeginWaitResTime Long 1590416703313

实例开始等待资源的时间。

RelatedFlowId Long 123123

关联的业务流程ID。

Bizdate Long 1590336000000

业务日期。通常为该任务运行时间的前一天。

NodeName String kzh

节点的名称。

BeginWaitTimeTime Long 1590416703313

实例开始等待调度的时间。

DqcDescription String [{"projectName":"ztjy_dim","tableName":"dim_user_agent_manage_area_a","partition":"ds\u003d$[yyyy-mm-dd-1]"}]

DQC分区规则串。

NodeId Long 33115

节点的ID。

CreateUser String 111

实例创建人。

示例

请求示例

http(s)://[Endpoint]/?Action=GetInstance
&InstanceId=1234
&ProjectEnv=PROD
&公共请求参数

正常返回示例

XML格式

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

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

JSON格式

HTTP/1.1 200 OK
Content-Type:application/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,
    "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
  }
}

错误码

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