更新资产 CI（工作站除外）

更新资产 CI（工作站除外）

要更新 CI，请使用以下 URL 格式：

 

 

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

假设您更新的是本地服务器中端口号为 8080 的 CI，URL 应为

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

关键字：

 

 

  1. 输入是一个 XML 字符串，作为 “POST attribute ”发送，关键字为 “INPUT_DATA”。

  2. 操作名称 “update”应作为 “POST attribute ”发送，关键字为 “OPERATION_NAME”。

  3. 技术员密钥应以 “POST attribute ”的形式发送，其关键字为 “TECHNICIAN_KEY”。

注意:  

如果未指定结果格式，API 将以 JSON 格式返回输出。

  • 具有资产更新角色的技术人员可以执行这些操作。

  • 更新条目的 CI-ID 会连同 CI 名称一起在响应中返回。

  • 可更新相应 CI 类型的 CI 属性、全局属性和自定义 CI 属性

  • 可更新工作站/服务器的所有工作站附加字段。

  • 可更新所有资产附加属性。

  • 如果字段是非英文的，可在 xml 中给出相同的字段以更新数据。

  • 可更新所有资产附加属性。

  • 可使用带有关系操作的过滤器更新资产。

  • 参数结果格式 - 可选。指定返回格式（XML 或 JSON）

 

 

更新接入点的 XML 示例：

 

 

注：由于所有 IT 资产都具有与接入点相同的属性，因此也可参考此 xml 更新其他 IT 资产。

注意:  

  • 由于所有 IT 资产都具有与该接入点类似的属性，因此也可参考此 xml 更新其他 IT 资产。

 

 

 

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