Update Asset CIs (other than Workstation)

To update a CI use the following URL format:

http://<servername>:<portnumber>/api/cmdb/ci/

Assuming you are updating a CI in the local server with port number 8080, the URL should be given as:

http://localhost:8080/api/cmdb/ci

Keypoints:

Input is an XML string sent as "POST attribute" with key "INPUT_DATA".
The operation name "update" should be sent as a "POST attribute" with key "OPERATION_NAME".
The technician key should be sent as a "POST attribute" with key "TECHNICIAN_KEY".

Note:

Technician having Asset update role can perform these operations.
CI-ID of the updated entry is returned along with the CI Name in the response.
CI Attributes, Global Attributes and custom CI Attributes for the corresponding CI Type can be updated
All workstation additional fields can be updated for workstation/server.
All asset additional attributes can be updated.
If the field is non-english, same can be given in the xml to update the data.
All asset additional attributes can be updated.
Can use the filters with relational operations for updating assets.
Parameter Result Format - Optional. specifies the return format ( XML or JSON )

If no result format specified then API will return output in JSON format.

Sample XML for updating Access Point:

Note: Since, all IT Assets share the same attributes as like of Access Point, refer this xml to update other IT Assets as well.

Note:

Since all IT Assets share the attributes similar to that Access Point, refer this xml to update other IT Assets as well.

<?xml version="1.0" encoding="UTF-8"?>
<API version="1.0" >
    <citype>
        <name>Access Point</name>
        <criterias>
            <criteria>
                <parameter>
                    <name compOperator="IS">CI Name</name>
                    <value>192.168.112.33</value>
                </parameter>
            </criteria>
        </criterias>
        <newvalue>
        <record>
            
            
            
            
            <parameter><name>Site</name><value>chennai</value></parameter>
            <parameter><name>Asset Tag</name><value>MY RES TAG-1</value></parameter>
            <parameter><name>Serial Number</name><value>KIJH-KPOJ-IOO9-IO98-EXT</value></parameter>
            <parameter><name>Barcode</name><value>MY BAR CODE</value></parameter>
            <parameter><name>Cost</name><value>68884.98</value></parameter>
            <parameter><name>Vendor</name><value>Zoho Corp</value></parameter>
            <parameter><name>Expiry Date</name><value>2011-08-23</value></parameter>
            <parameter><name>Warranty Expiry Date</name><value>2011-08-23</value></parameter>
            <parameter><name>Acquisition Date</name><value>2011-09-23</value></parameter>
            <parameter><name>Location</name><value>Porur</value></parameter>
            <parameter><name>Asset State</name><value>In Use</value></parameter>
            <parameter><name>Business Impact</name><value>high</value></parameter>
            <parameter><name>Description</name><value>Mydescription</value></parameter>

            
            <multi-valued-parameter name="Assign Ownership">
                <record>
                   <parameter><name>Associate to Asset</name><value>sdp-w2k3-13</value></parameter>
                   <parameter><name>Department's site</name><value>Pleasanton,CA</value></parameter>
                </record>
            </multi-valued-parameter>
            <multi-valued-parameter name="Asset Lease Information">
                <record>
                   <parameter><name>Start Date</name><value>2010-09-21</value></parameter>
                   <parameter><name>End Date</name><value>2011-09-21</value></parameter>
                </record>
            </multi-valued-parameter>
        </record>
        </newvalue>
    </citype>
</API>