更新工作站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输入示例:(可以使用相同的字段集更新工作站)

?xml version="1.0" encoding="UTF-8"?>
<API version="1.0" >
<citype>
<name>Windows Workstation</name>
<criterias>
<criteria>
<parameter>
<name compOperator="IS">CI Name</name>
<value>sdp-w2k3-13</value>
</parameter>
</criteria>
</criterias>
<newvalue>
<record>
<!-- Product Name/Type cannot be updated using Update Operations-->
<!--parameter><name>Product Name</name><value>Unknown Server</value></parameter-->
<parameter><name>Site</name><value>China</value></parameter>
<parameter><name>Asset Tag</name><value>MY RES TAG_1</value></parameter>
<parameter><name>Asset State</name><value>In use</value></parameter>
<parameter><name>Asset Serial No.</name><value>KIJH-KPOJ-IOO9-IO98_1</value></parameter>
<parameter><name>Cost</name><value>1223.98</value></parameter>
<parameter><name>Vendor</name><value>HP</value></parameter>
<parameter><name>Expiry Date</name><value>2012-08-23</value></parameter>
<parameter><name>Warranty Expiry Date</name><value>2012-08-23</value></parameter>
<parameter><name>Acquisition Date</name><value>2002-8-23</value></parameter>
<parameter><name>Location</name><value>Beijing</value></parameter>
<parameter><name>Business Impact</name><value>High</value></parameter>
<parameter><name>Description</name><value>Beijing\r\nAXL_EXT</value></parameter>
<parameter><name>Barcode</name><value>101001100010101_1</value></parameter>

<!-- Inventory data -->
<parameter><name>Service Tag</name><value>AXL90OSASASD_1</value></parameter>
<parameter><name>Total Memory</name><value>2024</value></parameter>
<parameter><name>Virtual Memory</name><value>2024</value></parameter>
<parameter><name>OS</name><value>Microsoft Windows XP Professional 2010</value></parameter>
<parameter><name>Service Pack</name><value>Microsoft Windows XP Professional 2010</value></parameter>
<parameter><name>Disk space</name><value>22</value></parameter>
<parameter><name>Manufacturer</name><value>HP</value></parameter>
<parameter><name>Is Virtual</name><value>true</value></parameter>
<parameter><name>Monitor Type</name><value>LG 360_EXT</value></parameter>
<parameter><name>Monitor Manufacturer</name><value>LCD Flat monitor_EXT</value></parameter>
<parameter><name>Monitor Serial Number</name><value>AADSD90KL88767_EDXT</value></parameter>
<parameter><name>Mouse Type</name><value>LOGITECH_EXT</value></parameter>
<parameter><name>Mouse Manufacturer</name><value>Microsoft Corporation</value></parameter>
<parameter><name>Mouse Serial Number</name><value>MOUSE_AADSD90KL88767_EXT</value></parameter>
<parameter><name>Keyboard Type</name><value>LG 480_EXT</value></parameter>
<parameter><name>Keyboard Manufacturer</name><value>Microsoft Corporation</value></parameter>
<parameter><name>Keyboard Serial Number</name><value>KBD_AADSD90KL88767_EXT</value></parameter>

<!-- Asset Additional fields -->
<parameter><name>Asset Data</name><value>My data\r\nTextas_EXT</value></parameter>
<parameter><name>Asset Date</name><value>2012-09-23</value></parameter>
<parameter><name>Asset Number</name><value>987654321</value></parameter>

<!-- Workstation Additional fields -->
<parameter><name>WS Data</name><value>My data\r\nTextas_EXT</value></parameter>
<parameter><name>WS Date</name><value>2013-09-23</value></parameter>
<parameter><name>WS Number</name><value>987654321</value></parameter>

<!-- Ownership details -->
<multi-valued-parameter name="Assign Ownership">
<record>
<parameter><name>Department</name><value>Finance</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>2013-09-21</value></parameter>
<parameter><name>End Date</name><value>2013-09-21</value></parameter>
</record>
</multi-valued-parameter>

<multi-valued-parameter name="Network Details">
<record>
<parameter><name>DHCP Server</name><value>www.dbexplorer.com_bak</value></parameter>
<parameter><name>IP Address</name><value>192.168.112.200</value></parameter>
<parameter><name>MAC Address</name><value>AS2.168.112.200</value></parameter>
<parameter><name>NIC</name><value>MY NIC_BAK</value></parameter>
<parameter><name>Network</name><value>192.168.112.255</value></parameter>
</record>
<record>
<parameter><name>DHCP Server</name><value>www.dbexplorer1.com_BAK</value></parameter>
<parameter><name>IP Address</name><value>192.168.112.255</value></parameter>
<parameter><name>MAC Address</name><value>AS2.168.112.255</value></parameter>
<parameter><name>NIC</name><value>MY NIC-1_BAK</value></parameter>
<parameter><name>Network</name><value>192.168.112.100</value></parameter>
</record>
</multi-valued-parameter>
<multi-valued-parameter name="Processor Details">
<record>
<parameter><name>Processor Count</name><value>2</value></parameter>
<parameter><name>Processor Type</name><value>Intel Inside 2</value></parameter>
<parameter><name>Processor Speed</name><value>2025</value></parameter>
<parameter><name>Processor Manufacturer</name><value>SSL Corporation_BAK</value></parameter>
</record>
<record>
<parameter><name>Processor Count</name><value>2</value></parameter>
<parameter><name>Processor Type</name><value>Intel Inside 2</value></parameter>
<parameter><name>Processor Speed</name><value>4025</value></parameter>
<parameter><name>Processor Manufacturer</name><value>SSL Corporation (India)_bak</value></parameter>
</record>
</multi-valued-parameter>
</record>
</newvalue>
</citype>
</API>