更新资产CI(工作站除外)

要更新配置项,请使用以下URL格式:

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

假设您正在使用端口号8080更新本地服务器中的配置项,则URL应指定为:

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

关键点:

  1. 输入是以密钥"INPUT_DATA"作为"POST attribute"发送的XML字符串。

  2. 操作名"update"应通过密钥"OPERATION_NAME"作为"POST attribute"发送。

  3. 技术员密钥应通过密钥"TECHNICIAN_KEY"作为"POST attribute"发送。

注意事项

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

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

  • 应答返回更新条目的CI-ID和CI名称。

  • CI属性全局属性定制的CI属性相应的CI类型可以被更新

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

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

  • 如果该字段为非英语,则可以在xml中给出相同的字段以更新数据。

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

  • 可以将过滤器与关系操作一起使用以更新资产。

  • 参数Result Format - Optional指定返回格式(XML或JSON),如果未指定返回格式,则API将以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>