Get Configuration Item Relationship

Retrieves detailed information about all configuration item (CI) relationships by using the unique identifier of a CI record.

Special Access Rules

To query a configuration item relationship, you must have the following user permissions:

IT Service Configuration Item Type Manager
IT Service Configuration Item Owner
IT Service Configuration Item Type Reader

Request

JSON example

This example is a sample request to retrieve all relationships for a specific configuration item.

1query GetCIRelationships {
2  getCIRelationships(id: "6545401") {
3    createdOn
4    developerName
5    id
6    relation
7    source
8    sourceName
9    target
10    targetName
11  }
12}

Properties

Name	Type	Description	Required or Optional	Available Version
`id`	String	The unique identifier of the Configuration Item whose relationships are to be retrieved.	Required	66.0

Response

JSON example

This example is a sample response from the getCIRelationships query.

1{
2  "data": {
3    "getCIRelationships": [
4      {
5        "createdOn": "1775194238352",
6        "developerName": "SD_AIFr",
7        "id": "1175502",
8        "relation": "Allocated From",
9        "source": "6545402",
10        "sourceName": "testingapplication2",
11        "target": "6545401",
12        "targetName": "testingbase2"
13      }
14    ]
15  }
16}

Properties

Name	Type	Description	Available Version
`createdOn`	String	The date and time the record was created.	68.0
`developerName`	String	Developer name of the configuration item.	66.0
`id`	Integer	Unique ID of this relationship record.	66.0
`relation`	String	Name of the relationship type.	66.0
`source`	Integer	ID of the parent configuration item.	66.0
`sourceName`	String	Display name of the parent configuration item.	66.0
`target`	int	ID of the child configuration item.	66.0
`targetName`	String	Display name of the child configuration item.	66.0