Endpoint Summary
The following REST endpoints are used in the ServiceNow integration.
A POST is used the first time a resource is created. PATCH is used for any updates to that resource. This ensures that opIntegration only edits the attributes it is responsible for.
| Endpoint | Purpose |
|---|---|
| api/now/table/cmdb_ci_linux_server | Represents a Linux server. |
/api/now/table/cmdb_ci_win_server | Represents a Windows server. |
/api/now/table/cmdb_ci_spkg | Represents a software package. |
| /api/now/table/cmdb_software_instance | Represents a mapping between a server and a software package. Both the server and the software package need to be have been created in advance. |
| /api/now/table/core_company | Represents a company. Once a company name is created, it is used in server.cpu_manufacturer and software.manufacturer. |
Sample JSON Documents
cmdb_ci_linux_server
{
"model_number" : "VMware, Inc. VMware Virtual Platform",
"cpu_count" : 2,
"manufacturer" : "VMware, Inc.",
"first_discovered" : "2018-04-09 13:01:15",
"dns_domain" : "us-west-1.compute.internal",
"virtual" : true,
"mac_address" : "00:0c:29:bf:a5:20",
"cpu_core_count" : 2,
"default_gateway" : "192.168.88.254",
"cpu_manufacturer" : "Intel",
"disk_space" : 81920,
"cpu_type" : "",
"last_discovered" : "2018-04-30 02:40:08",
"ip_address" : "192.168.88.15",
"cpu_core_thread" : 2,
"serial_number" : "VMware-56 4d 4f 4d 53 e4 b8 fb-f8 ce ab 91 e7 bf a5 20",
"cpu_speed" : 3600,
"os_address_width" : "64",
"os_domain" : "us-west-1.compute.internal",
"gl_account" : "",
"chassis_type" : "Virtual",
"host_name" : "odem",
"ram" : 3088228,
"discovery_source" : "Open-AudIT API v1",
"name" : "odem",
"cd_rom" : false,
"cpu_name" : "Intel Core i7-7700 CPU @ 3.60GHz",
"asset_tag" : "",
"os_version" : "6.9",
"os" : "CentOS release 6.9 (Final)",
"sys_domain" : "us-west-1.compute.internal",
"fqdn" : "ip-192-168-88-15.us-west-1.compute.internal"
}
cmdb_ci_win_server
This contains exactly the same fields as cmbd_ci_linux_server, with the addition of os_service_pack
{
"os_service_pack": "1"
}
cmdb_ci_spkg
{
"last_discovered" : "2018-04-19 20:31:11",
"discovery_source" : "Open-AudIT API v1",
"manufacturer" : "",
"name" : "dhclient",
"version" : "4.1.1-53.P1.el6.centos.3",
"first_discovered" : "2018-04-16 20:31:11"
}
cmdb_ci_software_instance
{
"software" : "54176db0dbc11300a584d8c0cf961916",
"installed_on" : "d3176db0dbc11300a584d8c0cf9619cb"
}
core_company
{
"name" : "Intel"
}