Universal CMDB REST API Reference

Note: To view the interactive REST API Reference documentation and to try executing the sample code for each REST API call, access CMS UI, and go to Help > REST API Reference.

Methods

[ Jump to Models ]

Table of Contents

Authenticate

ChangeReports

DataModel

DataModelci

DataModelrelatedCI

DataModelrelation

ExposeCI

History

ImpactAnalysis

Integration

MultipleCmdb

Ping

SampleDataModel

SampleTopologyQuery

Topology

TopologyQuery

Authenticate

Up
post /authenticate
This call returns a token based on user credentials. (authenticateUser)
This call returns a token based on user credentials.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

body AuthenticationDetails (optional)
Body Parameter

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

default

successful operation

ChangeReports

Up
post /changeReports/generate/all
Generates a change report on all attributes of the given CIs,generates a report that contains information about all attributes. (computeReportAll)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

body HistoryReportInput (optional)
Body Parameter

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

404

The server was not found.

500

A system error occurred

503

Server is busy handling other requests

Up
post /changeReports/generate/blacklist
This call generate a change report about the attributes of the given CIs, generates a report that contains no information about the attributes written in list "attributes". (computeReportWithBlacklist)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

body HistoryReportInput (optional)
Body Parameter

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

404

The server was not found.

500

A system error occurred

503

Server is busy handling other requests

Up
post /changeReports/generate/whitelist
Generates change report exclusively on the given attributes of the given CIs,generates a report that contains information just about the attributes written in list "attributes". (computeReportWithWhitelist)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

body HistoryReportInput (optional)
Body Parameter

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

404

The server was not found.

500

A system error occurred

503

Server is busy handling other requests

DataModel

Up
post /dataModel
This call creates entities as described by the payload. (create)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
Permission required The user that the token belongs to must have the required permissions for modifying the data inside UCMDB through the SDK.

Request body

body TopologyData (optional)
Body Parameter

Query parameters

isGlobalId (optional)
Query Parameter
forceTemporaryId (optional)
Query Parameter

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

successful operation.

400

Error while checking input

500

A system error occurred

DataModelci

Up
delete /dataModel/ci/{id}
This call deletes a CI. (deleteConfigurationItem)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
Permission required The user that the token belongs to must have the required permissions for deleting the data inside UCMDB through the SDK.

Path parameters

id (required)
Path Parameter — The string that represents the UCMDB ID of a configuration item.

Query parameters

isGlobalId (optional)
Query Parameter — The string that represents if the UCMDB ID is globalID.

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

400

Bad Request

404

Resources not found

500

Error while executing operation

Up
get /dataModel/ci/{id}
This call returns details of a CI. (getConfigurationItem)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
Permission required The user that the token belongs to must have the required permissions for viewing the data inside UCMDB through the SDK.

Path parameters

id (required)
Path Parameter — The string that represents the UCMDB ID of a configuration item.

Query parameters

isGlobalId (optional)
Query Parameter — The string that represents if the UCMDB ID is globalID.

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

400

Bad Request

404

Resources not found

500

Error while executing operation

Up
put /dataModel/ci/{id}
This call updates the details of a CI. (updateConfigurationItem)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
Permission required The user that the token belongs to must have the required permissions for updating the data inside UCMDB through the SDK.
You have to specify only the properties that you want to update. Do not specify all properties of the CI.
You cannot update the type or the ID of the CI.

Path parameters

id (required)
Path Parameter — The string that represents the UCMDB ID of a configuration item.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

body DataInConfigurationItem (optional)
Body Parameter

Query parameters

isGlobalId (optional)
Query Parameter — The string that represents if the UCMDB ID is globalID.

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

400

Bad Request

404

Resources not found

500

Error while executing operation

DataModelrelatedCI

Up
get /dataModel/relatedCI/{id}
This call returns the details of the CIs related to the specified CI. (getConfigurationItem)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
Permission required The user that the token belongs to must have the required permissions for viewing the data inside UCMDB through the SDK.

Path parameters

id (required)
Path Parameter — The string that represents the UCMDB ID of a configuration item.

Query parameters

isGlobalId (optional)
Query Parameter — The string that represents if the UCMDB ID is globalID.
withIcons (optional)
Query Parameter

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

400

Bad Request

404

Resources not found

500

Error while executing operation

DataModelrelation

Up
delete /dataModel/relation/{id}
This call deletes a relation. (deleteRelation)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
Permission required The user that the token belongs to must have the required permissions for deleting the data inside UCMDB through the SDK.

Path parameters

id (required)
Path Parameter — The string that represents the UCMDB ID of a relation.

Query parameters

isGlobalId (optional)
Query Parameter — The string that represents if the UCMDB ID is globalID.

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

400

Bad Request

404

Resources not found

500

Error while executing operation

Up
get /dataModel/relation/{id}
This call returns the details of a relation. (getConfigurationItem)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
Permission required The user that the token belongs to must have the required permissions for viewing the data inside UCMDB through the SDK.

Path parameters

id (required)
Path Parameter — The string that represents the UCMDB ID of a relation.

Query parameters

isGlobalId (optional)
Query Parameter — The string that represents if the UCMDB ID is globalID.

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

400

Bad Request

404

Resources not found

500

Error while executing operation

Up
put /dataModel/relation/{id}
This call updates the details of a relation. (updateRelation)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
Permission required The user that the token belongs to must have the required permissions for updating the data inside UCMDB through the SDK.

Path parameters

id (required)
Path Parameter — The string that represents the UCMDB ID of a relation.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

body DataInRelation (optional)
Body Parameter

Query parameters

isGlobalId (optional)
Query Parameter — The string that represents if the UCMDB ID is globalID.

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

400

Bad Request

404

Resources not found

500

Error while executing operation

ExposeCI

Up
post /exposeCI/getInformation
REST APIs for exposing the cis information (getInformation)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
Permission required The user that the token belongs to must have the required permissions for related inside UCMDB through the SDK.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

body CIFilter (optional)
Body Parameter

Query parameters

isGlobalId (optional)
Query Parameter — Represents the Global IDs of the CIs. The following values are available:
*true. Adds the global_id column in the output with its values (if it does not already exist in the given layout).
false. Displays the Global IDs of the CIs in the output, if the global_id column exists in the layout. Or, if the global_id column does not exist in the layout, then the Global IDs of the CIs are not displayed in the output.

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

400

UCMDB exception

500

A system error occurred

History

Up
get /history/getChanges
Retrieve the list of changes occurred in the specified time frame. (getChanges)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
The method has 4 parameters, of which only 2 are mandatory: from & to. This two parameters represent the start and end time between which to retrieve history events. A third parameter: changeType is a list parameter, meaning that 0 or more values can be specified. Possible values are: ADD_OBJECT, UPDATE_OBJECT, REMOVE_OBJECT, ADD_LINK, UPDATE_LINK, REMOVE_LINK, ADD_RELATION, REMOVE_RELATION. If no value is specified for this parameter all events regardless of their type will be returned. The forth parameter: id it's als a list parameter and can have 0 or more values. It represents the ids of CIs for which we want history events.

Query parameters

from (required)
Query Parameter — The time from when to retrieve events as timestamp in ms. format: int64
to (required)
Query Parameter — The time until when to retrieve events as timestamp in ms. format: int64
changeType (optional)
Query Parameter — The type of events were interested in. Possible values are: ADD_OBJECT, UPDATE_OBJECT, REMOVE_OBJECT, ADD_LINK, UPDATE_LINK, REMOVE_LINK, ADD_RELATION, REMOVE_RELATION
id (optional)
Query Parameter — The list of UCMDB IDs for which history events should be retrieved.

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

400

Error while checking input

404

The server was not found or the value for changeType is not in the allowed domain.

500

A system error occurred

Up
post /history/getDataLayout
Return the layout at the specified date for the CIs that have one of the IDs provided. (getDataLayout)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

body DataLayoutReq (optional)
Body Parameter — The criteria for data layout. This criteria consists of date, ids and attributes.

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

400

Error while checking input

404

The server was not found or the value for changeType is not in the allowed domain.

500

A system error occurred

Up
get /history/getRemovedCIs
Returns the list of CIs removed in the specified time frame. (getRemovedCis)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.

Query parameters

from (required)
Query Parameter — The time from when to retrieve events as timestamp in ms. format: int64
to (required)
Query Parameter — The time until when to retrieve events as timestamp in ms. format: int64
ciType (required)
Query Parameter — CI Type

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

400

Error while checking input

404

The server was not found.

500

A system error occurred

ImpactAnalysis

Up
post /impactAnalysis
Runs an impact analysis on the given definition. (runAnalysis)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
To check the available [severity] levels, see the output of GET /impactAnalysis/severities.
The impact definition should specify at least one trigger CI, and optionally a list of propertiesand a list of bundles. If no list of bundles is specified, All Bundles option is assumed by default.Each trigger CI should contain the triggerId and a severity. Severities have fixed naming, for thepossible inputs please use impactAnalysis/severities

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

body ImpactDefinition (optional)
Body Parameter

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

400

Bad Request

500

Error while executing operation

Integration

Up
get /integration/integrationpoints
Get all details of all integration points. (getAllIP)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

404

Integration point was not found.

500

A system error occurred

Up
get /integration/integrationpoints/{integrationId}
Get brief statistics of the integration point. (getIPBriefStatistics)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.

Path parameters

integrationId (required)
Path Parameter — The string that represents the integration point name.

Query parameters

detail (required)
Query Parameter — True to get all details of the integration point, false to get basic information of the integration point. default: false

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

400

Bad request,input is not valid.

404

Integration point was not found.

500

A system error occurred

Up
patch /integration/integrationpoints/{integrationId}/jobs/{jobId}
Synchronize the specified integration job under an active integration point. Available for integration jobs under active integration point only. (operateIntegrationJob)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
Permission required The user that the token belongs to must have the required permissions for Run Discovery and integrations inside UCMDB through the SDK.

Path parameters

integrationId (required)
Path Parameter — The string that represents the integration point name.
jobId (required)
Path Parameter — The string that represents the job name.

Consumes

This API call consumes the following media types via the Content-Type request header:

Query parameters

operationtype (required)
Query Parameter — Valid operation type values: population_full, population_delta, push_full, push_delta.

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

401

Unauthorized to access

404

Resources not found

500

Error while executing operation

Up
get /integration/integrationpoints/{integrationId}/connectionstatus
Test connection of an integration point. (testIPConnection)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.

Path parameters

integrationId (required)
Path Parameter — The string that represents the integration point name.

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

404

Resources not found

500

Error while executing operation or test connection failed

Up
patch /integration/integrationpoints/{integrationId}
Activate or deactivate an integration point. (updateIntegrationPoint)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
Permission required The user that the token belongs to must have the required permissions for Run Discovery and integrations inside UCMDB through the SDK.

Path parameters

integrationId (required)
Path Parameter — The string that represents the integration point name.

Consumes

This API call consumes the following media types via the Content-Type request header:

Query parameters

enabled (required)
Query Parameter — True to activate an integration point, false to deactivate an integration point.

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

401

Unauthorized to access

404

integration point not found

500

Error while executing operation

MultipleCmdb

Up
post /multipleCmdb/convertToGlobalIds
Convert ucmdb ids to global ids (convertToGlobalIds)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
Permission required The user that the token belongs to must have the required permissions for related inside UCMDB through the SDK.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

body string (required)
Body Parameter — List of ucmdb ids

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation.Response contains mapping between ucmdb ids and global ids

400

Error in checking input. Most likely the input is not valid

500

A system error has occurred

Up
post /multipleCmdb/convertToUcmdbIds
Convert global ids to ucmdb ids (convertToUcmdbIds)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
Permission required The user that the token belongs to must have the required permissions for related inside UCMDB through the SDK.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

body string (required)
Body Parameter — List of global ids

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation.Response contains mapping between global ids and ucmdb ids

400

Error in checking input. Most likely the input is not valid

500

A system error has occurred

Ping

Up
get /ping
Provides information about REST API services availability. (ping)
Provides information about REST API services availability.

Query parameters

restrictToWriter (optional)
Query Parameter — [boolean] - only returns available status if the server is in writer mode, if the server is reader return UNAVAILABLE status
restrictToReader (optional)
Query Parameter — [boolean] - only returns available status if the server is in reader mode, if the server is writer return UNAVAILABLE status

Responses

200

Server Up

503

Server Down

SampleDataModel

Up
get /sampleDataModel
This call returns an example of data model structure that will be used in Data-In operations. (getSampleInput)

Return type

TopologyData

Example data

Content-Type: application/json
{
  "cis" : [ {
    "type" : "node or composition",
    "properties" : "{\"name\":\"Test1\"}",
    "ucmdbId" : "4dc01bee04c76cc0ac4bb069f46e8b56"
  }, {
    "type" : "node or composition",
    "properties" : "{\"name\":\"Test1\"}",
    "ucmdbId" : "4dc01bee04c76cc0ac4bb069f46e8b56"
  } ],
  "relations" : [ {
    "end1Id" : "end1Id",
    "end2Id" : "end2Id",
    "type" : "node or composition",
    "properties" : "{\"name\":\"Test1\"}",
    "ucmdbId" : "4dc01bee04c76cc0ac4bb069f46e8b56"
  }, {
    "end1Id" : "end1Id",
    "end2Id" : "end2Id",
    "type" : "node or composition",
    "properties" : "{\"name\":\"Test1\"}",
    "ucmdbId" : "4dc01bee04c76cc0ac4bb069f46e8b56"
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

successful operation TopologyData

SampleTopologyQuery

Up
get /sampleTopologyQuery
REST API to execute topology queries (getSampleInput)
This call returns an example of the structure of an ad hoc TQL query. This structure can be used for future query related calls.

Return type

TopologyQuery

Example data

Content-Type: application/json
{
  "nodes" : [ {
    "layout" : [ "layout", "layout" ],
    "linkConditions" : [ {
      "minCardinality" : "minCardinality",
      "logicalOperator" : "and",
      "linkIdentifier" : "linkIdentifier",
      "conditions" : [ null, null ],
      "maxCardinality" : "maxCardinality"
    }, {
      "minCardinality" : "minCardinality",
      "logicalOperator" : "and",
      "linkIdentifier" : "linkIdentifier",
      "conditions" : [ null, null ],
      "maxCardinality" : "maxCardinality"
    } ],
    "visible" : true,
    "queryIdentifier" : "queryIdentifier",
    "ids" : [ "ids", "ids" ],
    "attributeConditions" : [ {
      "not" : true,
      "logicalOperator" : "and",
      "attribute" : "attribute",
      "conditions" : [ null, null ],
      "value" : "{}",
      "operator" : "isNull"
    }, {
      "not" : true,
      "logicalOperator" : "and",
      "attribute" : "attribute",
      "conditions" : [ null, null ],
      "value" : "{}",
      "operator" : "isNull"
    } ],
    "type" : "type",
    "includeSubtypes" : true
  }, {
    "layout" : [ "layout", "layout" ],
    "linkConditions" : [ {
      "minCardinality" : "minCardinality",
      "logicalOperator" : "and",
      "linkIdentifier" : "linkIdentifier",
      "conditions" : [ null, null ],
      "maxCardinality" : "maxCardinality"
    }, {
      "minCardinality" : "minCardinality",
      "logicalOperator" : "and",
      "linkIdentifier" : "linkIdentifier",
      "conditions" : [ null, null ],
      "maxCardinality" : "maxCardinality"
    } ],
    "visible" : true,
    "queryIdentifier" : "queryIdentifier",
    "ids" : [ "ids", "ids" ],
    "attributeConditions" : [ {
      "not" : true,
      "logicalOperator" : "and",
      "attribute" : "attribute",
      "conditions" : [ null, null ],
      "value" : "{}",
      "operator" : "isNull"
    }, {
      "not" : true,
      "logicalOperator" : "and",
      "attribute" : "attribute",
      "conditions" : [ null, null ],
      "value" : "{}",
      "operator" : "isNull"
    } ],
    "type" : "type",
    "includeSubtypes" : true
  } ],
  "relations" : [ {
    "layout" : [ "layout", "layout" ],
    "visible" : true,
    "queryIdentifier" : "queryIdentifier",
    "attributeConditions" : [ {
      "not" : true,
      "logicalOperator" : "and",
      "attribute" : "attribute",
      "conditions" : [ null, null ],
      "value" : "{}",
      "operator" : "isNull"
    }, {
      "not" : true,
      "logicalOperator" : "and",
      "attribute" : "attribute",
      "conditions" : [ null, null ],
      "value" : "{}",
      "operator" : "isNull"
    } ],
    "from" : "from",
    "to" : "to",
    "type" : "type",
    "includeSubtypes" : true
  }, {
    "layout" : [ "layout", "layout" ],
    "visible" : true,
    "queryIdentifier" : "queryIdentifier",
    "attributeConditions" : [ {
      "not" : true,
      "logicalOperator" : "and",
      "attribute" : "attribute",
      "conditions" : [ null, null ],
      "value" : "{}",
      "operator" : "isNull"
    }, {
      "not" : true,
      "logicalOperator" : "and",
      "attribute" : "attribute",
      "conditions" : [ null, null ],
      "value" : "{}",
      "operator" : "isNull"
    } ],
    "from" : "from",
    "to" : "to",
    "type" : "type",
    "includeSubtypes" : true
  } ]
}

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

successful operation TopologyQuery

Topology

Up
post /topology
Executes the query stored in CMDB with the given name. (executeQueryByName)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
Permission required The user that the token belongs to must have the required permissions for executing the TQL query inside UCMDB through the SDK.

Request body

body string (required)
Body Parameter — The name of the query to be calculated

Query parameters

chunkSize (optional)
Query Parameter — integer value that represents the chunk size of the result.

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

500

A system error occurred

Up
get /topology/result/{id}/{chunkNumber}
This call retrieves a chunk from a chunked TQL query result. (getQueryResponse)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
Permission required The user that the token belongs to must have the required permissions for executing the TQL queries by definition inside UCMDB through the SDK.
The user that created the result ID token must be the same as the one querying it.

Path parameters

id (required)
Path Parameter — The string that represents a token that identifies this resultId, retrieved from an execute query call when the resultSize bigger than chunkNumber.
chunkNumber (required)
Path Parameter — integer value that represents the chunk size of the result.

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

400

Invalid input

Up
delete /topology/result/{id}
This call deletes a chunked TQL query result from memory. (releaseChunk)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
Permission required The user that the token belongs to must have the required permissions for executing the TQL queries by definition inside UCMDB through the SDK.
The user that created the result ID token must be the same one that deletes it.

Path parameters

id (required)
Path Parameter — The string that represents a token that identifies this resultId, retrieved from an execute query call when the resultSize bigger than chunkNumber.

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

400

Invalid input

TopologyQuery

Up
post /topologyQuery
execute query by definition. (executeQuery)
Header required Authorization: Bearer (token) ,(token) is the token that is returned by the Authentication call.
Permission required The user that the token belongs to must have the required permissions for executing TQL queries by definition inside UCMDB through the SDK.
The visible attribute above specifies whether to return this node in the results or not.
The includeSubtypes attribute specifies whether to include the subtypes of this node type or not.
The layout attribute specifies which attributes of the objects will be returned (default: none).
The attributeConditions attribute specifies conditions on the properties of the objects or relationships. You can use simple attributes (name, operator, or value) or complex attributes (a logical operator and a list of attributes that are joined by that logical operator).
The linkConditions attribute specifies conditions on the links that the object participates into. You need to specify the link’s temporary ID and the cardinality. You can also use complex conditions that are made of a logical operator and a list of conditions.
The not property on the conditions specifies whether to negate the condition. If this property is unspecified, the default value is false.

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

body TopologyQuery (optional)
Body Parameter

Query parameters

chunkSize (optional)
Query Parameter

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful operation

404

The server was not found.

500

A system error occurred

503

Server is busy handling other requests

Models

[ Jump to Methods ]

Table of Contents

  1. AttributeCondition -
  2. AuthenticationDetails -
  3. CIFilter -
  4. Condition -
  5. DataInConfigurationItem -
  6. DataInRelation -
  7. DataLayoutReq -
  8. Filtering -
  9. HistoryReportInput -
  10. ImpactDefinition -
  11. LinkCondition -
  12. QueryNode -
  13. QueryRelationship -
  14. ReqEntry -
  15. SortElement -
  16. TopologyData -
  17. TopologyQuery -
  18. Trigger -

AttributeCondition - Up

attribute (optional)
operator (optional)
String One of the following strings: isNull, equals, isNotEqualTo, like, greaterThan, greaterThanOrEqual, lessThan, lessThanOrEqual, in, containsAny, contains. If this is unspecified, the default value is equals.
Enum:
isNull
equals
isNotEqualTo
like
greaterThan
greaterThanOrEqual
lessThan
lessThanOrEqual
in
containsAny
contains
inIgnoreCase
equalsCaseInsensitive
likeCaseInsensitive
changedInLast
unchangedInLast
occursWithinHours
occursAfterHours
value (optional)
not (optional)
logicalOperator (optional)
String The string that represents a logic operator, which can be "and" or "or".
Enum:
and
or
conditions (optional)
array[AttributeCondition] List of attribute Condition.

AuthenticationDetails - Up

username
String login user of UCMDB
password
String password of the login user
clientContext (optional)
Integer client context id, this is optional format: int32

CIFilter - Up

type
String The CI Type. This field cannot be empty or missing.
layout
array[String] The columns that will be displayed in the output. This field cannot be empty or missing.
includeSubtypes (optional)
sortBy (optional)
array[SortElement] A list of sorting conditions containing the name of the column after which the data will be sort, and the order in which the data is displayed. The order field can have the following values: ASC, or DESC.
filtering (optional)
Filtering The conditions used to filter the data.

Condition - Up

column (optional)
value (optional)
filteringAttributeCondOperator (optional)
Enum:
IS_NULL
EQUALS
NOT_EQUALS
GREATER
GREATER_OR_EQUAL
LESS
LESS_OR_EQUAL
IN
IN_IGNORE_CASE
CONTAINS
CONTAINS_ANY
EQUALS_CASE_INSENSITIVE
LIKE
LIKE_CASE_INSENSITIVE
CHANGED_IN_LAST
UNCHANGED_IN_LAST
OCCURS_WITHIN_HOURS
OCCURS_AFTER_HOURS

DataInConfigurationItem - Up

ucmdbId
String The string that represents a temporary ID or UCMDB ID of the objects.
type
String The string that represents the name of a valid CI Type or relation Type from the UCMDB. You have to use the name of the Type, not the display name. The name of the Type can be found inside the CI Type Manager.
properties
map[String, Object] [ucmdb_cit_prop]:[ucmdb_cit_prop_value], [ucmdb_cit_prop] is the valid property name of the CI Type or relation Type. You have to use the name of the property, not its display name.[ucmdb_cit_prop_value] is the property value, which can be integer, string, Boolean, long, double, ISO8601 date, or a list of values depending on the property data type.

DataInRelation - Up

ucmdbId
String The string that represents a temporary ID or UCMDB ID of the objects.
type
String The string that represents the name of a valid CI Type or relation Type from the UCMDB. You have to use the name of the Type, not the display name. The name of the Type can be found inside the CI Type Manager.
properties
map[String, Object] [ucmdb_cit_prop]:[ucmdb_cit_prop_value], [ucmdb_cit_prop] is the valid property name of the CI Type or relation Type. You have to use the name of the property, not its display name.[ucmdb_cit_prop_value] is the property value, which can be integer, string, Boolean, long, double, ISO8601 date, or a list of values depending on the property data type.
end1Id (optional)
end2Id (optional)

DataLayoutReq - Up

data (optional)
layout (optional)

Filtering - Up

logicalOperator (optional)
Enum:
and
or
conditions (optional)

HistoryReportInput - Up

dateFrom
Date represents the date from which changes of attributes should be taken into consideration at the generated report format: date-time
dateTo
Date represents the limit date to which changes of attributes should be taken into consideration at the generated report. format: date-time
viewName
String is a view that has as result some CIs on which report will be based on.
attributes (optional)
array[String] is a list of attributes which should or should not appear in the generated report, this is not required when call API to generate a report that contains information about all attributes.

ImpactDefinition - Up

bundles (optional)
array[String] (Optional) Specify the bundles of rules used to run the analysis. If you do not specify a list of bundles, all bundles are used by default
triggerCIs
array[Trigger] Specify the CIs that are triggered for this impact analysis (as an array of trigger CIs). At least one trigger CI should be specified. Each trigger CI has two fields:triggerId: [ucmdb_id]The string that represents the CI's ID in UCMDB ; severity: [severity]The string that represents the severity at which the trigger CI is affected.
properties (optional)
array[String] (Optional) Specify the properties to be fetched for each affected CI that is identified by the impact analysis (as an array of strings - names). If not specified, no extra property will be fetched. The CI type and the UCMDB ID are fetched by default.

LinkCondition - Up

linkIdentifier (optional)
String The string that represents a temporary ID of the objects. This temporary object ID can be used for referring to the object inside this payload. For example, you can specify the two ends of a relationship, or use the relationship temp ID inside the link conditions.
minCardinality (optional)
String The string that represents the cardinality of a relationship end, which can be a number, *, or UNBOUNDED.
maxCardinality (optional)
String The string that represents the cardinality of a relationship end, which can be a number, *, or UNBOUNDED.
logicalOperator (optional)
String The string that represents a logic operator, which can be "and" or "or".
Enum:
and
or
conditions (optional)
array[LinkCondition] List of link condition.

QueryNode - Up

linkConditions (optional)
type (optional)
String The string that represents the name of a valid CI Type from the UCMDB. You have to use the name of the CI Type, not the display name. The name of the CI Type can be found inside the CI Type Manager.
queryIdentifier (optional)
String The string that represents a temporary ID of the objects. This temporary object ID can be used for referring to the object inside this payload. For example, you can specify the two ends of a relationship, or use the relationship temp ID inside the link conditions.
visible (optional)
includeSubtypes (optional)
layout (optional)
array[String] List of ucmdb_cit_prop (ucmdb_cit_prop represents the valid property name of the CI Type. You can get the name and the list of all properties of a CI Type from the CI Type Manager.).
attributeConditions (optional)
array[AttributeCondition] List of attribute Condition.
ids (optional)
array[String] List of ucmdb id.

QueryRelationship - Up

type (optional)
String The string that represents the name of a valid CI Type from the UCMDB. You have to use the name of the CI Type, not the display name. The name of the CI Type can be found inside the CI Type Manager.
queryIdentifier (optional)
String The string that represents a temporary ID of the objects. This temporary object ID can be used for referring to the object inside this payload. For example, you can specify the two ends of a relationship, or use the relationship temp ID inside the link conditions.
visible (optional)
includeSubtypes (optional)
layout (optional)
array[String] List of ucmdb_cit_prop (ucmdb_cit_prop represents the valid property name of the CI Type. You can get the name and the list of all properties of a CI Type from the CI Type Manager.).
attributeConditions (optional)
array[AttributeCondition] List of attribute Condition.
from (optional)
to (optional)

ReqEntry - Up

valid (optional)
date (optional)
Long format: int64
ciIDs (optional)

SortElement - Up

attribute (optional)
order (optional)
Enum:
ASC
DESC

TopologyData - Up

cis (optional)
relations (optional)

TopologyQuery - Up

nodes (optional)
relations (optional)

Trigger - Up

triggerId (optional)
severity (optional)