Create Device operation
The Create Device operation creates a device record.
The following table describes the elements of the <items> XML element and the adapter request. If not specified, the valid value for an element should be assumed to be a string.
Elements for the <items> XML element and adapter request for the Create Device operation
The following figure displays the sample adapter request for the Create Device operation.
Sample adapter request for the Create Device operation
<hp-service-manager-request>
<entity>configurationitem</entity>
<entity-type>device</entity-type>
<request>
<operation-name>create-device</operation-name>
<parameters>
<create-configuration-request>
<model>
<keys>
<configuration-item>
<value>NewDevice0001</value>
<type>String</type>
</configuration-item>
</keys>
<instance>
<configuration-item>
<value>NewDevice0001</value>
<type>String</type>
</configuration-item>
<configuration-item-type>
<value>device</value>
<type>String</type>
</configuration-item-type>
<status>
<value>status</value>
<type>String</type>
</status>
<vendor>
<value>Vendor name</value>
<type>String</type>
</vendor>
<parent-device>
<value>parent device</value>
<type>String</type>
</parent-device>
<model>
<value>model</value>
<type>String</type>
</model>
<serial-number>
<value>serial number</value>
<type>String</type>
</serial-number>
<location>
<value>location</value>
<type>String</type>
</location>
<contact-name>
<value>contact name</value>
<type>String</type>
</contact-name>
<part-number>
<value>part number</value>
<type>String</type>
</part-number>
<configuration-item-sub-type>
<value>cist</value>
<type>String</type>
</configuration-item-sub-type>
<location-code>
<value>location code</value>
<type>String</type>
</location-code>
<building>
<value>bulding</value>
<type>String</type>
</building>
<floor>
<value>floor</value>
<type>String</type>
</floor>
<room>
<value>room</value>
<type>String</type>
</room>
<system-down>
<value>true</value>
<type>Boolean</type>
</system-down>
<asset-tag>
<value>asset tag</value>
<type>String</type>
</asset-tag>
<critical>
<value>true</value>
<type>Boolean</type>
</critical>
<company>
<value>company</value>
<type>String</type>
</company>
<department>
<value>department</value>
<type>String</type>
</department>
<assignment-group>
<value>assignment</value>
<type>String</type>
</assignment-group>
</instance>
</model>
</create-configuration-request>
</parameters>
</request>
</hp-service-manager-request>
The following figure displays an adapter response for the Create Device operation.
Sample adapter response for the Create Device operation
<hp-service-manager-response>
<metadata>
<count>1</count>
</metadata>
<responses>
<response>
<metadata>
<count>1</count>
</metadata>
<item>
<metadata>
<status>success</status>
</metadata>
<parameters>
<model>
<keys>
<configuration-item>
<value>NewDevice0001</value>
<type>String</type>
</configuration-item>
</keys>
<instance>
<configuration-item>
<value>NewDevice0001</value>
<type>String</type>
</configuration-item>
<vendor>
<value>Vendor name</value>
<type>String</type>
</vendor>
<parent-device>
<value>parent device</value>
<type>String</type>
</parent-device>
<model>
<value>model</value>
<type>String</type>
</model>
<serial-number>
<value>serial number</value>
<type>String</type>
</serial-number>
<location>
<value>location</value>
<type>String</type>
</location>
<configuration-item-type>
<value>device</value>
<type>String</type>
</configuration-item-type>
<contact-name>
<value>contact name</value>
<type>String</type>
</contact-name>
<part-number>
<value>part number</value>
<type>String</type>
</part-number>
<status>
<value>status</value>
<type>String</type>
</status>
<configuration-item-sub-type>
<value>cist</value>
<type>String</type>
</configuration-item-sub-type>
<location-code>
<value>location code</value>
<type>String</type>
</location-code>
<building>
<value>bulding</value>
<type>String</type>
</building>
<floor>
<value>floor</value>
<type>String</type>
</floor>
<room>
<value>room</value>
<type>String</type>
</room>
<system-down>
<value>true</value>
<type>Boolean</type>
</system-down>
<asset-tag>
<value>asset tag</value>
<type>String</type>
</asset-tag>
<critical>
<value>true</value>
<type>Boolean</type>
</critical>
<company>
<value>company</value>
<type>String</type>
</company>
<department>
<value>department</value>
<type>String</type>
</department>
<assignment-group>
<value>assignment</value>
<type>String</type>
</assignment-group>
<uniquequery>logical.name="NewDevice0001"</uniquequery>
<recordid>NewDevice0001 - device - status</recordid>
</instance>
</model>
<messages>
<element>
<value>Configuration Item record added.</value>
</element>
</messages>
<status>SUCCESS</status>
<message>Success</message>
<schema-revision-date>2010.01.20 00:00:00</schema-revision-date>
<schema-revision-level>0</schema-revision-level>
<return-code>0</return-code>
</parameters>
</item>
</response>
</responses>
</hp-service-manager-response>
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*