All Products
Search
Document Center

DataWorks:GetNode

Last Updated:Sep 18, 2024

Queries the details of a node.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
NodeIdlongYes

The interval at which the node is rerun after the node fails to run.

1234
ProjectEnvstringYes

The priority of the node. Valid values: 1, 3, 5, 7, and 8.

Enumeration Value:
  • PROD
  • DEV
PROD

Response parameters

ParameterTypeDescriptionExample
object

The error code returned.

HttpStatusCodeinteger

The operation that you want to perform. Set the value to GetNode.

200
RequestIdstring

Other parameters.

E6F0DBDD-5AD****
ErrorMessagestring

The connection string.

The connection does not exist.
ErrorCodestring

The ID of the node. You can call the ListNodes operation to query the node ID.

Invalid.Tenant.ConnectionNotExists
Successboolean

The ID of the workflow.

true
Dataobject

The details of the node.

SchedulerTypestring

The ID of the workspace.

NORMAL
RepeatIntervallong

The ID of the workflow to which the node belongs.

60
Repeatabilitystring

The type of the node.

true
ProjectIdlong

Indicates whether the node can be rerun.

1234
ProgramTypestring

The ID of the owner of the node.

ODPS_SQL
Priorityinteger

The HTTP status code returned.

1
OwnerIdstring

The ID of the node.

17366294****
Connectionstring

The environment of the workspace. Valid values: PROD and DEV.

odps_first_dev
ParamValuesstring

The CRON expression returned.

a=b
RelatedFlowIdlong

Indicates whether the node is associated with Data Quality. Valid values: 0 and 1. A value of 0 indicates that the node is associated with Data Quality. A value of 1 indicates that the node is not associated with Data Quality.

123
DqcTypeinteger

The error message returned.

1
BaselineIdlong

The description of the node.

123456
Descriptionstring

The name of the resource group.

test
NodeNamestring

The scheduling type of the node. Valid values:

  • NORMAL: The node is an auto triggered node.
  • MANUAL: The node is a manually triggered node. Manually triggered nodes cannot be automatically triggered.
  • PAUSE: The node is a paused node.
  • SKIP: The node is a dry-run node. Dry-run nodes are started as scheduled but the system sets the status of the nodes to successful when it starts to run them.
The ID of the baseline.
ResGroupNamestring

The ID of the request. You can use the ID to locate logs and troubleshoot issues.

The table and partition filter expression in Data Quality that are associated with the node.
BusinessIdlong

The operation that you want to perform. Set the value to GetNode.

123
DqcDescriptionstring

The ID of the node. You can call the ListNodes operation to query the node ID.

[{"projectName":"test_0923001","tableName":"test_table_001","partition":"ds\u003d$[yyyymmdd]"},{"projectName":"test_0923001","tableName":"test_table_002","partition":"NOTAPARTITIONTABLE"}]
CronExpressstring

The environment of the workspace. Valid values: PROD and DEV.

00 00 00 * * ?
NodeIdlong

The HTTP status code returned.

1234

Examples

Sample success responses

JSONformat

{
  "HttpStatusCode": 200,
  "RequestId": "E6F0DBDD-5AD****",
  "ErrorMessage": "The connection does not exist.",
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Success": true,
  "Data": {
    "SchedulerType": "NORMAL",
    "RepeatInterval": 60,
    "Repeatability": "true",
    "ProjectId": 1234,
    "ProgramType": "ODPS_SQL",
    "Priority": 1,
    "OwnerId": "17366294****",
    "Connection": "odps_first_dev",
    "ParamValues": "a=b",
    "RelatedFlowId": 123,
    "DqcType": 1,
    "BaselineId": 123456,
    "Description": "test",
    "NodeName": "The ID of the baseline.\n",
    "ResGroupName": "The table and partition filter expression in Data Quality that are associated with the node.\n",
    "BusinessId": 123,
    "DqcDescription": "[{\"projectName\":\"test_0923001\",\"tableName\":\"test_table_001\",\"partition\":\"ds\\u003d$[yyyymmdd]\"},{\"projectName\":\"test_0923001\",\"tableName\":\"test_table_002\",\"partition\":\"NOTAPARTITIONTABLE\"}]",
    "CronExpress": "00 00 00 * * ?",
    "NodeId": 1234,
    "ResGroupIdentifier": "",
    "FileType": 0
  }
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2024-05-30The response structure of the API has changedView Change Details
2023-06-05The internal configuration of the API is changed, but the call is not affectedView Change Details