Virtual server response processor example

reference brazil Updated Sep 10, 2026 2 min read response-processor-example.md
Raw file servicenow.com

The Create_Virtual_Server_Response_Processor script, which is available by default in Cloud Provisioning and Governance, is the response processor that handles the creation of AWS virtual machine CIs.

Create Virtual Server

The Create_Virtual_Server_Response_Processor resource processor script is available by default on the Virtual Server resource block. Its job is to create a virtual server record in the Virtual Machine Instance [cmdb_ci_vm_instance] table when a new virtual server is provisioned.

All response processors have this first line with these common parameters:

JavaScript
function processResponse(response, cloudServiceAccountId, ldc, correlationId,step, requestorContext) {

This brings in the response from the cloud provider and the important information, such as the account ID, that is required for the new CI. All of these parameters are required for all response processors.

Line 10 parses the response into JSON so that the system can process it. The information is held in the vmResponse variable:

JavaScript
var vmResponse = global.JSON.parse(response);

Whenever you create or edit a response processor, you must know which inputs are required for the CI type. Line 11 handles one of the necessary inputs, the hardware ID, that the CMDB record requires:

JavaScript
var hardwareId = vmResponse.hardwareId;

Line 39 shows the information that the system requires to identify the new virtual server and related CIs for storage in the CMDB. In this case, the service account object ID identifies the account associated with the virtual server, the datacenter object ID identifies the datacenter in which the virtual server lives, and the virtual machine instance object ID identifies the virtual server itself. This identification code block prevents the creation of duplicate CIs.

JavaScript
var vmInfo = {    "cmdb_ci_vm_instance": {      "validator": "virtual_machine_create_update_validator",      "validator_overrides": {},      "identification": {        "cmdb_ci_cloud_service_account": {          "criterion": {            "object_id": cloudServiceAccountId          }        },        "cmdb_ci_aws_datacenter": {          "criterion": {            "object_id": ldc          }        },        "cmdb_ci_vm_instance": {          "criterion": {            "object_id": vmResponse.nodeId          }        }      },

Attributes are populated into the fields on in the cmdb_ci_vm_instance table. These attributes are defined in line 61:

Shell
"attributes": {  "name": vmResponse.nodeName,  "object_id": vmResponse.nodeId,  "state": status_map[vmResponse.state],  "dns_suffix": vmResponse.dnsSuffix,  "cpus": vmCPUs,  "memory": vmMemory,  "disks": vmResponse.volumes.length,  "disks_size": "",  "nics": vmResponse.networkInterfaces.length,  "terminated_on": "",  "termination_protection": "",  "ip_address": vmPubIPAddr,  "assigned_to": reqContext.userId,  "assignment_group": reqContext.groupId},

References to other CIs can also be included in the response processor. In this case, the OS template is identified by the object ID of the service account and the datacenter, along with the actual OS template.

Shell
"references": {  "cmdb_ci_os_template": {    "identification": {      "cmdb_ci_cloud_service_account": {        "criterion": {          "object_id": cloudServiceAccountId        }      },      "cmdb_ci_aws_datacenter": {        "criterion": {          "object_id": ldc        }      },      "cmdb_ci_os_template": {        "criterion": {          "object_id": imageIdTrim        }      }    },

The following code block adds the object ID of the OS image to the attributes list. This information is then populated into the virtual server CMDB record.

Text
"attributes": {  "object_id": imageIdTrim}

This code block performs additional identification on the Compute template (the hardware type) and then add it to the attributes:

Shell
"cmdb_ci_compute_template": {  "identification": {    "cmdb_ci_cloud_service_account": {      "criterion": {        "object_id": cloudServiceAccountId      }    },    "cmdb_ci_aws_datacenter": {      "criterion": {        "object_id": ldc      }    },    "cmdb_ci_compute_template": {      "criterion": {        "object_id": vmResponse.hardwareId      }    }  },  "attributes": {    "object_id": vmResponse.hardwareId,    "name": vmResponse.hardwareId  }}

Additional code sections make the relationship with network interfaces and identify any storage attached to the virtual server.

This mandatory code block pushes the data to the CMDB and returns the JSON string:

JavaScript
cloudModelString.push(vmInfo);return global.JSON.stringify(cloudModelString);

Parent Topic:Configure a response processor

Search documentation
Search document titles and file paths on the brazil branch