Skip to main content
Matrix42 Self-Service Help Center

Rest API – CI Relationships

How to create, update and search Configuration Items (CI) Relationships in FireScope SDDM using the REST API.


The REST API allows you to work with Configuration Items (CI) Relationships in FireScope SDDM using a REST client in lieu of the SDDM user interface.

  • Search
  • Create or Update
  • Retrieve and Delete are not implemented


Not implemented.

Searching provides for the ability to return multiple results in a single call using various filter criteria. To accomplish this, a GET request is sent with a parameter search=true. Every other field besides account is optional and is used to further filter the results. Pagination is mandatory and accomplished using the page and size parameters. The JSON response will wrap the result list and also display the page and the size. The size in the response represents the number of results actually returned, not the size in the request. The response does not contain a count of the total number of pages or the total number of records for performance reasons. The client is expected to keep querying, increasing the page each time, until the result size is less than the requested size, indicating no more results.


Note: Don’t forget to change the domain name (localhost) and query parameter (searchaccount, servicegroup, page and size ) values to match your environment and data.

Search Parameter Descriptions

Parameter Description Type Default Required
account Name of the SDDM Account. String   Yes
search Enable searching by setting to true. Setting to false will revert functionality to retrieving a single result. Boolean FALSE Yes
page Indicates which result set is being returned starting at zero and increasing until there are no more results Number 0 Yes
size Indicates how many results are returned in a single page. A max of 250 results is supported. Number 100 Yes
servicegroup Filter the results by a Service Group’s exact name. String   No

Example Search Response

   "account_id": "firescope",
   "entity": "ci_relationship",
   "page": 0,
   "size": 2,
   "results": [
         "account_id": "firescope", 
          "ci_relationship_category_id": "Network", 
          "ci_relationship_type_id": "contains",
         "pending_delete": True, 
          "port": 19234, 
          "protocol_name": "", 
          "protocol_type": "TCP", 
          "servicegroupid": "Ordering",
         "source_ci": "esx1", 
         "status": 1,
         "target_ci": ""
      }, { 
         "account_id": "firescope", 
          "ci_relationship_category_id": "Application", 
          "ci_relationship_type_id": "related",
         "pending_delete": False, 
          "port": 80, 
          "protocol_name": "http", 
          "protocol_type": "TCP", 
          "servicegroupid": "Ordering",
         "source_ci": "", 
          "status": 0,
         "target_ci": ""

Create or Update

Not implemented

Property Descriptions

The following table provides information about all required and optional properties available for a CI Relationship.

Property Description Type Default Value Required
account_id Name of the SDDM Account. String   Yes
ci_relationship_category_id Name of the category this relationship falls into:
String   Yes
ci_relationship_type_id The type of relationship indicates whether it is a parent/child relation or just a normal relationship.
String   Yes
pending_delete Whether the relationship has been marked for deletion and awaiting user approval. Boolean False Yes
port The port associated with this relationship. Usually this indicates the target server’s listening port. Number   Yes
protocol_name The application protocol name associated with this traffic. For example, http, ldap, etc. String   No
protocol_type The transport layer protocol. Either UDP or TCP. String   Yes
servicegroupid Name of the Service Group associated with the CI. String   Yes
source_ci The originating CI of the relationship. Example:
{“edge_device_id” : “Datacenter East”, “ci” : “”}
Object   Yes
status Status of the relationship:
0 = Pending
1 = Approved
2 = Rejected
Number  0 Yes
target_ci The destination CI of the relationship. Example:
{“edge_device_id” : “Datacenter East”, “ci” : “”}
Object   Yes


Not implemented

  • Was this article helpful?