Rerun processing node with specified output version¶

Rerun the node using the specified output revision.

HTTP
POST $CLOUDSIGMA_API_BASE/lineage/artifacts/{artifact_id}/nodes/{node_id}/output-emissions/{target_output_emission_id}/rerun-with-revisions

Before you call this API¶

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

Request¶

Input examples

Shell
curl -X POST "$CLOUDSIGMA_API_BASE/lineage/artifacts/$ARTIFACT_ID/nodes/$NODE_ID/output-emissions/$TARGET_OUTPUT_EMISSION_ID/rerun-with-revisions" \
  -H "X-API-Key: $CLOUDSIGMA_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "rerun_downstream_with_revisions",
    "source_effective_set_version": 4,
    "selected_revisions_json": {"block-001": {"revision_id": "rev-002"}}
  }'

Parameter reference

Request body

Field	Type	Description
`mode`	string	Rerun mode; when provided, it must be rerun_downstream_with_revisions.
`source_effective_set_version`	integer	Source effective revision set version.
`selected_revisions_json`	object	The selected revision collection.

Successful response¶

When the request is successful, the data of this operation is returned. Just because the write or run request has been accepted does not mean that the subsequent processing has been completed; please confirm the result based on the return status or subsequent query.

The response fields are as follows.

Response example

JSON
{
  "code": "OK",
  "msg": "OK",
  "data": {"artifact_id": "art-001", "node_id": "node-001", "rerun_id": "rerun-001", "status": "submitted"}
}

Field reference

Field	Type	Description
`data.artifact_id`	string	Product ID.
`data.node_id`	string	Node ID.
`data.rerun_id`	string	Rerun ID.
`data.branch_id`	string	New branch ID.
`data.case_id`	string	Processing case ID.
`data.status`	string	Rerun status.

Error response¶

Response example

JSON
{
  "code": "ErrParamInvalid",
  "msg": "请求参数无效",
  "data": null
}

Field reference

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

Last updated on Sep 15, 2026