View node rerun plan¶

Check available modes, affected nodes, and verification results for reruns from the specified node. Create a rerun only if the plan passes verification.

HTTP
GET $CLOUDSIGMA_API_BASE/workflow/v2/workflow-apps/{workflow_id}/executions/{execution_id}/nodes/{node_key}/rerun-plan

Before you call this API¶

Configure the regional API endpoint and authentication, and select the target workspace.

First query the job node and confirm the node key to be used as the starting point for re-running.

Request¶

Input examples

Shell
curl "$CLOUDSIGMA_API_BASE/workflow/v2/workflow-apps/$WORKFLOW_ID/executions/$EXECUTION_ID/nodes/$NODE_KEY/rerun-plan" \
  -H "X-API-Key: $CLOUDSIGMA_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

Parameter reference

Query parameters

Field	Type	Description
`workflow_id`	string	Workflow ID.
`execution_id`	string	Source job ID.
`node_key`	string	The node key to start the rerun from.
`source_node_execution_id`	string	Used when selecting from multiple node execution candidates.

Successful response¶

Response example

JSON
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "plan": {
      "workflow_id": "wf-001",
      "source_execution_id": "exec-001",
      "node_key": "root.load",
      "source_node_execution_id": "node-exec-001",
      "rerun_contract_hash": "rgh-001",
      "available_modes": ["continue_from_node"],
      "validation": {
        "ok": true
      },
      "candidates": []
    }
  }
}

Field reference

Field	Type	Description
`code`	string	`OK` when successful.
`msg`	string	`OK` when successful.
`data.plan.workflow_id`	string	Workflow ID.
`data.plan.source_execution_id`	string	Source job ID.
`data.plan.node_key`	string	The node key of the rerun starting point.
`data.plan.source_node_execution_id`	string	Selected source node execution ID.
`data.plan.rerun_contract_hash`	string	Plan contract hash; can be used when created to prevent the use of expired plans.
`data.plan.available_modes`	string[]	Can be used to create rerun patterns.
`data.plan.affected_downstream_nodes[]`	array	Affected downstream nodes; only returned if there is a value.
`data.plan.validation.ok`	boolean	Whether the plan passes the verification.
`data.plan.validation.code`	string	Error code when verification fails; only returned if there is a value.
`data.plan.validation.message`	string	Error message when verification fails; only returned if there is a value.
`data.plan.validation.reasons`	string[]	Reasons when verification fails; only returned if there is a value.
`data.plan.candidates[]`	array	Source node execution candidates; only returned if there are multiple candidates.

Error response¶

Response example

JSON
{
  "code": "ErrNotFound",
  "msg": "资源不存在",
  "data": null
}

Field reference

Field	Type	Description
`code`	string	Error code.
`msg`	string	Readable error message.
`data`	null	`null` in an error response.

Follow-up operations¶

Save rerun_contract_hash, and then rerun from the specified node.

Last updated on Sep 15, 2026