Skip to main content
Version: Next

Well-known Relations between Catalog Entities

This section lists a number of well known entity relation types, that have defined semantics. They can be attached to catalog entities and consumed by plugins as needed.

If you are looking to extend the set of relations, see Extending the model.

Relations

This is a (non-exhaustive) list of relations that are known to be in active use.

Each relation has a source (implicitly: the entity that holds the relation), a target (the entity to which the source has a relation), and a type that tells what relation the source has with the target. The relation is directional; there are commonly pairs of relation types and the entity at the other end will have the opposite relation in the opposite direction (e.g. when querying for A, you will see A.ownedBy.B, and when querying B, you will see B.ownerOf.A).

ownedBy and ownerOf

An ownership relation where the owner is usually an organizational entity (User or Group), and the other entity can be anything.

In Backstage, the owner of an entity is the singular entity (commonly a team) that bears ultimate responsibility for the entity, and has the authority and capability to develop and maintain it. They will be the point of contact if something goes wrong, or if features are to be requested. The main purpose of this relation is for display purposes in Backstage, so that people looking at catalog entities can get an understanding of to whom this entity belongs. It is not to be used by automated processes to for example assign authorization in runtime systems. There may be others that also develop or otherwise touch the entity, but there will always be one ultimate owner.

This relation is commonly generated based on spec.owner of the owned entity, where present.

providesApi and apiProvidedBy

A relation with an API entity, typically from a Component.

These relations express that a component exposes an API - meaning that it hosts callable endpoints from which you can consume that API.

This relation is commonly generated based on spec.providesApis of the component or system in question.

consumesApi and apiConsumedBy

A relation with an API entity, typically from a Component.

These relations express that a component consumes an API - meaning that it depends on endpoints of the API.

This relation is commonly generated based on spec.consumesApis of the component or system in question.

dependsOn and dependencyOf

A relation denoting a dependency on another entity.

This relation is a general expression of being in need of that other entity for an entity to function. It can for example be used to express that a website component needs a library component as part of its build, or that a service component uses a persistent storage resource.

This relation is commonly generated based on spec.dependsOn of the component or resource in question.

parentOf and childOf

A parent/child relation to build up a tree, used for example to describe the organizational structure between Groups.

This relation is commonly based on spec.parent and/or spec.children.

memberOf and hasMember

A membership relation, typically for Users in Groups.

This relation is commonly based on spec.memberOf.

partOf and hasPart

A relation with a Domain, System or Component entity, typically from a Component, API, System, or Domain,

These relations express that a component belongs to a larger component; a component, API or resource belongs to a system; that a system is grouped under a domain; or that a domain belongs to a larger domain.

This relation is commonly based on spec.system or spec.domain.