All Products
Search
Document Center

Platform For AI:ListPipelineRunsStatus

Last Updated:Sep 15, 2025

Queries the statuses of multiple pipeline jobs or nodes at a time.

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 syntax

PUT /api/v1/pipelineruns HTTP/1.1

Request parameters

ParameterTypeRequiredDescriptionExample
bodyobjectNo

The request parameters.

PipelineRunsarrayNo

The pipeline jobs that you want to query. You must configure PipelineRuns or Nodes. We recommend that you configure Nodes.

stringNo

The ID of the pipeline job. You can call ListPipelineRuns to obtain the ID of the pipeline job.

flow-hynm2bv8wqhp5esfxq
Nodesarray<object>No

The nodes that you want to query. You must configure PipelineRuns or Nodes. We recommend that you configure Nodes.

objectNo

The node that you want to query.

PipelineRunIdstringNo

The ID of the pipeline job. You can call ListPipelineRuns to obtain the ID of the pipeline job.

flow-hynm2bv8wqhp5esfxq
NodeIdstringNo

The ID of the pipeline node. You can call ListPipelineRuns to obtain the node ID.

node-hynm2bv8wqhp5esfx1
WorkspaceIdstringNo

The workspace ID. You can call ListWorkspaces to obtain the workspace ID.

948**
OutputTypestringNo

The output type of the pipeline node. Valid values:

  • Model
  • DataSet
  • Metrics
  • ModelEvaluation
DataSet

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

The request ID.

473469C7-****-****-****-A3DC0DE3C83E
PipelineRunsarray<object>

The pipeline jobs.

Runsobject

The pipeline job.

PipelineRunIdstring

The ID of the pipeline job.

flow-hynm2bv8wqhp5esfxq
Statusstring

The status of the pipeline job.

Running
Namestring

The name of the pipeline job.

myName
UserIdstring

The ID of the user to which the pipeline belongs.

1557702098194904
ParentUserIdstring

The ID of the Alibaba Cloud account to which the pipeline belongs.

1557702098194904
NodeIdstring

The node ID.

node-98odqfpcjzwdf3caq3
SourceIdstring

The ID of the pipeline job source.

lmi7d24h3kr0xczjlu
IsDeletedboolean

Indicates whether the pipeline job was deleted. Valid values:

  • true
  • false
false
Nodesarray<object>

The pipeline nodes.

Nodesobject

The pipeline node.

PipelineRunIdstring

The ID of the pipeline job.

flow-hynm2bv8wqhp5esfxq
NodeIdstring

The ID of the pipeline node.

node-hynm2bv8wqhp5esfx1
Statusstring

The status of the pipeline node.

Running
InputArtifactArchivedboolean

Indicates whether the input was saved.

  • true
  • false
true
OutputArtifactArchivedboolean

Indicates whether the output was saved.

  • true
  • false
true
StartedAtstring

The time when the pipeline node started to run, in UTC. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format.

2021-01-21T17:12:35.232Z
FinishedAtstring

The time when the pipeline node finished running, in UTC. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format.

2021-01-21T17:12:35.232Z
NodeNamestring

The name of the pipeline node.

dataSource
Outputsarray<object>

The outputs of the pipeline node.

Outputsobject

The output of the pipeline node.

Namestring

The name of the output for the pipeline node.

model_******
Typestring

The output type. Valid values:

  • Model
  • DataSet
  • Metrics
  • ModelEvaluation
DataSet
Metadataobject

The output metadata.

GmtCreateTimestring

The time when the output was created.

2021-01-30T12:51:33.028Z
Idstring

The output ID.

artifact-ty1xwv*******s8zf
Producerstring

The output producer.

id-3d25-************-77856
NodeIdstring

The ID of the pipeline node to which the output belongs.

node-obpzu*******418grb7
PipelineRunIdstring

The ID of the pipeline job to which the output belongs.

flow-dsjfk******jdskls
Valuestring

The output value.

{\"name\": \"model_flow_*********_node_**********_model\", \"location\": {\"name\": \"model_flow_**********_node_***********_model\", \"endpoint\": \"http://service.odps.aliyun.com/api\", \"project\": \"********\"}}
ExpandedArtifactIndexinteger

The expanded index number of the output, starting from 0.

0
ExpandableArtifactNamestring

The expandable name of the output.

inputArtifact

Examples

Sample success responses

JSONformat

{
  "RequestId": "473469C7-****-****-****-A3DC0DE3C83E",
  "PipelineRuns": [
    {
      "PipelineRunId": "flow-hynm2bv8wqhp5esfxq",
      "Status": "Running",
      "Name": "myName",
      "UserId": 1557702098194904,
      "ParentUserId": 1557702098194904,
      "NodeId": "node-98odqfpcjzwdf3caq3",
      "SourceId": "lmi7d24h3kr0xczjlu",
      "IsDeleted": false
    }
  ],
  "Nodes": [
    {
      "PipelineRunId": "flow-hynm2bv8wqhp5esfxq",
      "NodeId": "node-hynm2bv8wqhp5esfx1",
      "Status": "Running",
      "InputArtifactArchived": true,
      "OutputArtifactArchived": true,
      "StartedAt": "2021-01-21T17:12:35.232Z",
      "FinishedAt": "2021-01-21T17:12:35.232Z",
      "NodeName": "dataSource"
    }
  ],
  "Outputs": [
    {
      "Name": "model_******",
      "Type": "DataSet",
      "Metadata": {
        "test": "test",
        "test2": 1
      },
      "GmtCreateTime": "2021-01-30T12:51:33.028Z",
      "Id": "artifact-ty1xwv*******s8zf",
      "Producer": "id-3d25-************-77856",
      "NodeId": "node-obpzu*******418grb7\n",
      "PipelineRunId": "flow-dsjfk******jdskls",
      "Value": "{\\\"name\\\": \\\"model_flow_*********_node_**********_model\\\", \\\"location\\\": {\\\"name\\\": \\\"model_flow_**********_node_***********_model\\\", \\\"endpoint\\\": \\\"http://service.odps.aliyun.com/api\\\", \\\"project\\\": \\\"********\\\"}}",
      "ExpandedArtifactIndex": 0,
      "ExpandableArtifactName": "inputArtifact"
    }
  ]
}

Error codes

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

Change history

Change timeSummary of changesOperation
2024-07-24The internal configuration of the API is changed, but the call is not affectedView Change Details
2022-12-15The response structure of the API has changedView Change Details
2022-06-14Add OperationView Change Details