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:

 

 

  1. Input is an XML string sent as "POST attribute" with key "INPUT_DATA".

  2. The operation name "update"  should be sent as a "POST attribute" with key "OPERATION_NAME".

  3. The technician key should be sent as a "POST attribute" with key "TECHNICIAN_KEY".

Note:  

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

  • 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 )

 

 

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>

            <!-- Product Name/Type cannot be updated using Update Operations-->

            <!--parameter><name>CI Name</name><value>(empty)</value></parameter-->

            <!--parameter><name>CI Type</name><value>My Test Access1</value></parameter-->

            <!--parameter><name>Product Name</name><value>My Access Point1</value></parameter-->

            <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 value parameters -->

            <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>