Use GetInstance to query instance information - DataWorks - Alibaba Cloud - DataWorks

Retrieves the details of an instance.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

dataworks:*

get

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
InstanceId	integer	Yes	The instance ID. You can call the ListInstances operation to query the ID.	1234
ProjectEnv	string	Yes	The environment of the workspace. Valid values: PROD and DEV.	PROD

Response elements

Element	Type	Description	Example
	object	The response parameters.
HttpStatusCode	integer	The HTTP status code.	200
RequestId	string	The request ID.	E6F0DBDD-5AD****
ErrorMessage	string	The error message returned when the instance fails to be scheduled.	test
Success	boolean	Indicates whether the request was successful.	true
ErrorCode	string	The error code.	0
Data	object	The details of the instance.
Status	string	The status of the node that generates the instance. Valid values: NOT_RUN: The node is not run. WAIT_TIME: The node is waiting for its scheduling time to arrive. WAIT_RESOURCE: The node is waiting for resources. RUNNING: The node is running. CHECKING: Data quality is being checked for the node. CHECKING_CONDITION: Branch conditions are being checked for the node. FAILURE: The node fails to run. SUCCESS: The node is successfully run.	NOT_RUN
CycTime	integer	The scheduling time of the instance.	1590422400000
BeginRunningTime	integer	The time when the instance started to run.	1590416703313
FinishTime	integer	The time when the instance finished running.	1590416703313
CreateTime	integer	The time when the instance was generated.	1590416703313
DagId	integer	The workflow ID.	338450167
Priority	integer	The priority of the instance. Valid values: 1, 3, 5, 7, and 8. A greater value indicates a higher priority. Default value: 1.	1
TaskType	string	The scheduling type of the node that generates the instance. Valid values: NORMAL(0): An auto triggered node. Runs on a regular schedule. MANUAL(1): A manually triggered node. Does not run on a regular schedule. PAUSE(2): A frozen node. Runs on schedule but is automatically set to failed. SKIP(3): A dry-run node. Runs on schedule but is automatically set to successful. SKIP_UNCHOOSE(4): An unselected node in a temporary workflow. Automatically set to successful at execution time. SKIP_CYCLE(5): A weekly or monthly scheduled node waiting for its scheduling time. Runs on schedule but is automatically set to successful. CONDITION_UNCHOOSE(6): Not selected by the ancestor branch node. Runs as a dry-run node. REALTIME_DEPRECATED(7): A deprecated real-time node. Automatically set to successful.	NORMAL(0)
ParamValues	string	The parameters related to the node.	bizdate=$bizdate tbods=$tbods tbdw=$tbdw tbpmic=$tbpmic tbpidx=$tbpidx tbptcif=$tbptcif
Connection	string	The connection string.	odps_first
BaselineId	integer	The baseline ID.	123123
DqcType	integer	Whether the instance is associated with a Data Quality monitoring rule. Valid values: 0: Associated with a Data Quality monitoring rule. 1: Not associated with a Data Quality monitoring rule.	1
DagType	string	The type of the workflow. Valid values: DAILY: Runs auto triggered nodes. MANUAL: Runs manually triggered nodes. SMOKE_TEST: Performs smoke testing. SUPPLY_DATA: Backfills data.	DAILY
BusinessId	integer	The workflow ID.	123
TaskRerunTime	integer	The remaining rerun count. Can be empty or a non-negative integer. If the value of this parameter is empty, the rerun count is unspecified. If the value of this parameter is 0, the node cannot be rerun. If the value is a positive integer n, the node can be rerun n more times.	0
PeriodNumber	integer	The sequence number of the instance's scheduling cycle on the current day.	1
ModifyTime	integer	The time when the instance was last modified.	1590416703313
Repeatability	boolean	Indicates whether the node that generates the instance can be rerun.	true
RepeatInterval	integer	The rerun interval after a failure, in milliseconds.	60000
InstanceId	integer	The instance ID.	11713307578
BeginWaitResTime	integer	The time when the instance started to wait for resources.	1590416703313
RelatedFlowId	integer	The ID of the workflow to which the node belongs.	123123
Bizdate	integer	The data timestamp of the instance. Typically one day before the instance run time.	1590336000000
NodeName	string	The name of the node.	kzh
BeginWaitTimeTime	integer	The time when the instance started to wait to be scheduled.	1590416703313
DqcDescription	string	The table and partition filter expression in Data Quality associated with the node.	[{"projectName":"ztjy_dim","tableName":"dim_user_agent_manage_area_a","partition":"ds\u003d$[yyyy-mm-dd-1]"}]
NodeId	integer	The node ID.	33115
CreateUser	string	The creator of the instance.	111
Owner	string	The owner of the instance.	111

Examples

Success response

JSON format

{
  "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_first",
    "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"
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.