Set node effective version¶

Switches the effective revision of the output block of the specified processing node.

HTTP
POST $CLOUDSIGMA_API_BASE/lineage/artifacts/{artifact_id}/nodes/{node_id}/effective-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/effective-revisions" \
  -H "X-API-Key: $CLOUDSIGMA_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "switches": [
      {"block_id": "block-001", "effective_revision_id": "rev-002"}
    ]
  }'

Parameter reference

Request body

Parameter	Type	Required	Description
`switches`	array	Required	The output block and target revision to switch.
`switches[].block_id`	string	Required	Output block ID.
`switches[].effective_revision_id`	string		The revision ID to be made effective.
`switches[].use_original`	boolean		Set the original content as the effective content.
`expected_effective_set_version`	integer		The expected effective revision set version.

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", "effective_set_version": 4}
}

Field reference

Field	Type	Description
`data.artifact_id`	string	Product ID.
`data.node_id`	string	Node ID.
`data.effective_set_version`	integer	The effective revision set version after switching.

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