All Products
Search
Document Center

DataWorks:ListInnerNodes

Last Updated:Nov 21, 2024

Queries information about inner nodes. For example, you can call this operation to query the inner nodes of a node group or a do-while node. You cannot call this operation to query the inner nodes of a PAI node.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
ProgramTypestringNo

The type of the node to which the inner nodes belong.

Valid values: 6 (Shell), 10 (ODPS SQL), 11 (ODPS MR), 23 (Data Integration), 24 (ODPS Script), 97 (PAI), 98 (node group), 99 (zero load), 221 (PyODPS 2), 225 (ODPS Spark), 227 (EMR Hive), 228 (EMR Spark), 229 (EMR Spark SQL), 230 (EMR MR), 239 (OSS object inspection), 257 (EMR Shell), 258 (EMR Spark Shell), 259 (EMR Presto), 260 (EMR Impala), 900 (real-time synchronization), 1002 (PAI inner node), 1089 (cross-tenant collaboration), 1091 (Hologres development), 1093 (Hologres SQL), 1100 (assignment), 1106 (for-each), and 1221 (PyODPS 3). You can call the ListNodes operation to query the type of the node.

ODPS_SQL
PageNumberintegerNo

The page number. Valid values: 1 to 100.

1
PageSizeintegerNo

The number of entries per page. Default value: 10. Maximum value: 100.

10
ProjectIdlongYes

The workspace ID.

1234
ProjectEnvstringNo

The environment in which the node is run. Valid values: DEV and PROD. Default value: PROD.

PROD
NodeNamestringNo

The name of the node to which the inner nodes belong.

liux_test_n****
OuterNodeIdlongYes

The ID of the node group to which the inner nodes belong.

1234

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

The request ID.

E6F0DBDD-5AD****
Successboolean

Indicates whether the request was successful.

true
Pagingobject

The pagination information.

PageNumberinteger

The page number.

1
PageSizeinteger

The number of entries per page. Default value: 10. Maximum value: 100.

10
TotalCountinteger

The total number of inner nodes returned.

100
Nodesarray<object>

The list of inner nodes.

Nodesobject
SchedulerTypestring

The scheduling type of the inner node. Valid values:

  • NORMAL: The inner node is an auto triggered node.
  • MANUAL: The inner node is a manually triggered node. The scheduling system does not run the node on a regular basis.
  • PAUSE: The inner node is a paused node.
  • SKIP: The inner node is a dry-run node. Dry-run nodes are started as scheduled, but the scheduling system sets the status of the nodes to successful when it starts to run them.
NORMAL
RepeatIntervallong

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

60
Repeatabilityboolean

Indicates whether the inner node can be rerun.

true
ProjectIdlong

The workspace ID.

123
ProgramTypestring

The type of the inner node.

ODPS_SQL
Priorityinteger

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

1
OwnerIdstring

The owner ID.

1933****36551
Connectionstring

The connection string.

odps_first
ParamValuesstring

The additional parameters.

a=b
DqcTypestring

Indicates whether the inner node is associated with a monitoring rule in Data Quality. Valid values: 0 and 1. The value 0 indicates that the inner node is associated with a monitoring rule in Data Quality. The value 1 indicates that the inner node is not associated with a monitoring rule in Data Quality.

1
BaselineIdlong

The baseline ID.

1234
Descriptionstring

The description of the inner node.

test
NodeNamestring

The name of the inner node.

liux_test_n****
ResGroupNamestring

The name of the resource group.

BusinessIdlong

The workflow ID.

123
DqcDescriptionstring

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

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

The CRON expression.

00 00 00 * * ?
NodeIdlong

The inner node ID.

12

Examples

Sample success responses

JSONformat

{
  "RequestId": "E6F0DBDD-5AD****",
  "Success": true,
  "Paging": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 100,
    "Nodes": [
      {
        "SchedulerType": "NORMAL",
        "RepeatInterval": 60,
        "Repeatability": true,
        "ProjectId": 123,
        "ProgramType": "ODPS_SQL",
        "Priority": 1,
        "OwnerId": "1933****36551",
        "Connection": "odps_first",
        "ParamValues": "a=b",
        "DqcType": "1",
        "BaselineId": 1234,
        "Description": "test",
        "NodeName": "liux_test_n****",
        "ResGroupName": "",
        "BusinessId": 123,
        "DqcDescription": "[{\"projectName\":\"ztjy_dim\",\"tableName\":\"dim_user_agent_manage_area_a\",\"partition\":\"ds\\u003d$[yyyy-mm-dd-1]\"}]",
        "CronExpress": "00 00 00 * * ?",
        "NodeId": 12
      }
    ]
  }
}

Error codes

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

Change history

Change timeSummary of changesOperation
No change history