Variants

A Variant is a set of Config Units, typically grouped by a Space, which is copied from another set of Units, typically a Base, such that persistent relationships between the two sets are maintained. This copy operation is sometimes called "clone". At the API level it is a Create with an upstream source to copy.

Cloning each Config Unit maintains a reference to the original, upstream Config Unit, at the specific Revision that was copied, in both Unit fields and with a Link of UpdateType UpgradeUnit. Later, after changes have been made to the Upstream Config Unit (and potentially to the Variant as well), the Downstream Variant may be Upgraded to incorporate the changes.

For more details, see the guide.