AssetExplorer

    Add Software CI


    To add software asset CI use the following URL format:

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


    Assuming you are adding an software asset 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 "add"  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:  

    • Technician having SDAdmin role can perform add operations on admin CIs like Business Service, Department etc.

    • CI-ID of the newly added entry is returned along with the CI Name in the response.

    • Technicians can add more than one CI(s) using the <record> </record> tags.

    • CI Attributes, Global Attributes and custom CI Attributes for the corresponding CI Type can be added.

    • All asset additional attributes can be added

    • Parameter Result Format - Optional. specifies the return format ( XML or JSON )

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

     

    Note: Attributes for other default CI Types like Cluster, Document, IT Service, Network,Switch Ports and Datacenter can be added by referring the CI Type details page.


    Sample Input for adding Software CI

     

    <?xml version="1.0" encoding="UTF-8"?>
    <API version="1.0" locale="en">
        <records>
        <record>
            <parameter><name>Name</name><value>zenity-1</value></parameter>
            <parameter><name>CI Type</name><value>Database</value></parameter>
            <parameter><name>Site</name><value>Japan</value></parameter>
            <parameter><name>Description</name><value>Adding a software instance</value></parameter>
            <parameter><name>Software</name><value>zenity</value></parameter>
            <parameter><name>Workstation</name><value>nprasanna-0157.csez.zohocorpin.com</value></parameter>
            <parameter><name>Installation Path</name><value>C:\AdventNet\ME\SSL Reports</value></parameter>
            <parameter><name>Version</name><value>1.0.0</value></parameter>
            <parameter><name>Installed On</name><value>2011-01-28</value></parameter>
            <parameter><name>License Key</name><value>SADD-DSDS-SK90-KSAL</value></parameter>
        </record>
        <record>
            <parameter><name>Name</name><value>Accelerometer</value></parameter>
            <parameter><name>CI Type</name><value>Web Server</value></parameter>
            <parameter><name>Site</name><value>China</value></parameter>
            <parameter><name>Description</name><value>Adding a software instance</value></parameter>
            <parameter><name>Software</name><value>Apache Tomcat 6.0.18</value></parameter>
            <parameter><name>Workstation</name><value>nprasanna-0157.csez.zohocorpin.com</value></parameter>
            <parameter><name>Installation Path</name><value>C:\Program Files\Apache\Apache Tomcat</value></parameter>
            <parameter><name>Version</name><value>6.0.10</value></parameter>
            <parameter><name>Installed On</name><value>2013-01-28</value></parameter>
            <parameter><name>License Key</name><value>SAADD-DSDS-SK90-KSAL</value></parameter>
        </record>
        </records>
    </API>

     


     

    Copyright © 2017, ZOHO Corp. All Rights Reserved.