Restoring tagged versions

You can restore any of the tagged versions of a stream by using the Restore button Restore icon.png in the Version history panel. See Version history for more information.

When clicking the Restore button, the restoring tagged version of the stream is imported as a stream with the same name as the current version of the stream. See Importing streams in the interface | Importing a stream with the same name as an existing stream for more information.

Note!

A tagged version of a stream cannot be restored if:

It is the Autosaved version of the stream. See Version history | Autosaved version for more information.
It is the only tagged version of the stream.

The Restore button in the Version history panel

Once the Restore button is clicked, you will be prompted to confirm the restoration of the tagged version. If you want to tag a new version to the version that is being restored of the stream, you can enter a version tag and description.

Note!

If the current configuration of the stream has the Autosaved tag, restoring a tagged version will overwrite the Autosaved version. See Version history | Autosaved version.

The prompt to confirm restoring the tagged version

Click Restore to confirm the restoration.

If the new stream being restored does not contain all of the functions/node present in the existing stream, a Warning: Function(s) missing dialog appears. The dialog lists the missing functions and their function/node IDs.

An example of a warning if the restoring version has missing functions from the current configuration of the stream

You can take one of the following actions:

Button	Action	Description

Button	Action	Description
Restore anyway	Proceeds with the restoration	The tagged version of the stream is restored despite missing functions. Note! If any of the removed functions are stateful (for example, Data aggregator, Deduplicate, or functions that use persistent stores), their state may become orphaned. In some cases, you can roll back to a previous stream version and re‑attach to this state; in others, the state is no longer visible in the UI and only expires after its configured TTL. Use this option with care in stateful streams and validate rollback and state access in a non‑production environment first. Improvements to make it easier to re‑attach orphaned state to restored functions are planned for a future release.
Cancel	Aborts the restoration	No changes are made.

Once the tagged version has been restored successfully, a notification appears.

The notification when a tagged version is restored successfully