Link entities for user-defined link - BlueCat Integrity - 9.4.0

Address Manager API Guide

Locale
English
Product name
BlueCat Integrity
Version
9.4.0

Establish a link between the specified source and destination Address Manager entities.

API method: PUT /v1/linkEntitiesEx

Example

{
    "linkType": "UniqueLinkTypeName",
    "sourceEntityId": 81253,
    "destinationEntityId": 23125
}
Example (with description)
{
    "linkType": "UniqueLinkTypeName",
    "description": "Description for the link",
    "sourceEntityId": 81253,
    "destinationEntityId": 23125
}
Starting in Address Manager v9.4.0, you can specify more than one destination link ids.
Example
{
    "linkType": "UniqueLinkTypeName",
    "sourceEntityId": 81253,
    "destinationEntityIds": [23125]
}
Example (with description)
{
    "linkType": "UniqueLinkTypeName",
    "description": "Description for the link",
    "sourceEntityId": 81253,
    "destinationEntityIds": [23125, 23126]
}
Parameters
  • linkType—enter a unique name for the user-defined link.
    Note:
    • You cannot enter a name that is a reserved link type name. For a list of reserved link type names, refer to Reference: Reserved link type names.
    • You cannot enter a name that begins with the prefix "BCN_".
  • description—(optional) enter a description for the user-defined link.
  • sourceEntityId—enter the source entity ID.
  • destinationEntityId— enter the destination entity ID.
  • destinationEntityIds— enter one or more destination entity IDs comma-separated inside square brackets. For example,
    "destinationEntityIds": [objectID1, objectID2, ..., objectIDN]
Note: In the case of a list of destination entity ids, all the created links will use the same description.