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.