Settings API - Generic relationships schema table
Generic relationships (builtin:monitoredentities.generic.relation)
Looking for topology extraction support? Find the topology model help page here.
Entity types can be related to each other. The relationship registry contains rules by which relationships between related entities are automatically established.
| Schema ID | Schema groups | Scope |
|---|---|---|
builtin:monitoredentities.generic.relation |
| environment |
| GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:monitoredentities.generic.relation |
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:monitoredentities.generic.relation | |
| Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:monitoredentities.generic.relation |
Authentication
To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.
Parameters
| Property | Type | Description | Required |
|---|---|---|---|
Enabledenabled | boolean | Enables or disables the relationship | required |
Source filterssources | Set<SourceFilter> | Specify all sources which should be evaluated for this relationship rule. The relationship is only created when any of the filters match. | required |
Created bycreatedBy | text | The user or extension that created this relationship. | required |
Source type namefromType | text | Define an entity type as the source of the relationship. | required |
Role of source typefromRole | text | Specify a role for the source entity. If both source and destination type are the same, referring different roles will allow identification of a relationships direction. If role is left blank, any role of the source type is considered for the relationship. | optional |
Type of relationshiptypeOfRelation | enum | Type of the relationship between the Source Type and the Destination Type
| required |
Destination typetoType | text | Define an entity type as the destination of the relationship. You can choose the same type as the source type. In this case you also may assign different roles for source and destination for having directed relationships. | required |
Role of destination typetoRole | text | Specify a role for the destination entity. If both source and destination type are the same, referring different roles will allow identification of a relationships direction. If role is left blank, any role of the destination type is considered for the relationship. | optional |
The SourceFilter object
| Property | Type | Description | Required |
|---|---|---|---|
Datasource typesourceType | enum | Specify the source type of the filter to identify which data source should be evaluated.
| required |
Conditioncondition | text | Specify a filter that needs to match in order for the extraction to happen. Two different filters are supported: | required |
Mapping RulesmappingRules | Set<MappingRule> | Specify all properties which should be compared. If all mapping rules match a relationship between entities will be created. | required |
The MappingRule object
| Property | Type | Description | Required |
|---|---|---|---|
Source propertysourceProperty | text | The case-sensitive name of a property of the source type. | required |
Source NormalizationsourceTransformation | enum | Normalize text or leave it as-is?
| required |
Destination propertydestinationProperty | text | The case-sensitive name of a property of the destination type. | required |
Destination NormalizationdestinationTransformation | enum | Normalize text or leave it as-is?
| required |