Aliases
Aliases are references to entities in external systems. They are organized by alias type, with each type containing a list of alias entry definitions.
To remove an alias, simply update or upsert a catalog entity with the alias type and an empty array []
as the value instead of any entry identifiers. Omitted alias types will not be affected.
The key in the object is the distinct alias type.
Example
{
"github_repo": [
{
"identifier": "671150935",
"name": "get-dx/payment-processing",
"url": "https://github.com/get-dx/payment-processing"
}
],
"pagerduty_service": [
{
"identifier": "P123ABC",
"name": "Payment Service"
}
]
}
Possible Alias Types
Name | System | Supports URLs? |
---|---|---|
ado_repository |
Azure Dev Ops | Yes |
backstage_component |
Backstage | |
bitbucket_server_repository |
Bitbucket Server | Yes |
bitbucket_repository |
Bitbucket | Yes |
bugsnag_project |
Bugsnag | |
datadog_monitor |
DataDog | |
datadog_slo |
DataDog | |
datadog_service |
DataDog | |
dx_deployment_service |
DX | |
dynatrace_entity |
Dynatrace | |
dynatrace_slo |
Dynatrace | |
firehydrant_service |
Firehydrant | |
github_repo |
Github | Yes |
gitlab_repo |
Gitlab | Yes |
incident_io_service |
Incident IO | |
opsgenie_service |
OpsGenie | |
pagerduty_service |
Pagerduty | |
rollbar_project |
Rollbar | |
sentry_project |
Sentry | |
snyk_project |
Snyk | |
sonarcloud_project |
Sonarcloud | |
sonarqube_project |
Sonarqube |
Properties
Key | Type | Description |
---|---|---|
identifier |
string | The external system’s unique identifier for the item. |
name |
string | The display name of the item in the system. |
url |
string | When supported by the alias type, this will be a link to the item in the third-party system. |