要使用标准获取（获得）CI 的详细信息，请使用以下 URL 格式：
http://<hostname>:<port>/api/cmdb/ci/
假设您要读取与端口号为 8080 的本地服务器相关联的 CI 的详细信息（使用某种形式的标准），则 URL 应为
http://localhost:8080/api/cmdb/ci/
关键字
输入是一个 XML 字符串，作为 “POST attribute”发送，关键字为 “INPUT_DATA”。
操作名称 “read”应作为 “POST attribute”发送，关键字为 “OPERATION_NAME”。
技术员密钥应以 “POST attribute”的形式发送，其关键字为 “TECHNICIAN_KEY”。
注意: 参数结果格式 - 可选。指定返回格式（XML 或 JSON） 如果未指定结果格式，API 将以 JSON 格式返回输出。 |
<API version="1.0" locale="en">
<citype>
<name>Windows Workstation</name>
<criterias>
<criteria>
<parameter>
<name compOperator="START WITH">CI Type</name>
<!-- Can give Non english values in the parameter names as well as in the data-->
<value>Windows Workstation</value>
</parameter>
<reloperator>OR</reloperator>
<parameter>
<name compOperator="CONTAINS">CI Name</name>
<value>sdp</value>
</parameter>
</criteria>
</criterias>
<returnFields>
<name>CI Name</name>
<name>CI Type</name>
<name>Business Impact</name>
<name>Site</name>
<name>Description</name>
</returnFields>
<sortparameters sortOrder="desc">
<name>CI Name</name>
<name>Site</name>
</sortparameters>
<!-- If the total number pages is 100, we can give the navigation from 50 to 50 -->
<range>
<startindex>1</startindex>
<limit>50</limit>
</range>
</citype>
</API>
注意：如果未提及 CI 类型，则只会获取并列出与常用字段相关的属性。
通过关系运算符 (OR) 使用条件获取 CI 详细信息
<?xml version="1.0" encoding="UTF-8"?>
<API version="1.0">
<citype>
<name>Workstation</name>
<criterias>
<criteria>
<parameter>
<name compOperator="IS">Acquisition Date</name>
<value>2011-12-30</value>
</parameter>
</criteria>
</criterias>
<returnFields>
<!-- Syntax to return all available column(s). <name>*</name> -->
<name>CI Name</name>
<name>CI Type</name>
<name>Owned By</name>
<name>Site</name>
<name>Description</name>
<name>Acquisition Date</name>
<name>Warranty Expiry Date</name>
<name>Expiry Date</name>
<name>Asset Tag</name>
<name>Serial Number</name>
<name>Barcode</name>
<name>Product Name</name>
<name>Resource State</name>
<name>Vendor</name>
<name>Location</name>
<name>Mac Address</name>
<name>WS UDF Date</name>
<name>WS UDF Num</name>
<name>WS UDF Multi</name>
<name>WS UDF String</name>
<name>Sites</name>
</returnFields>
<sortFields sortOrder="desc">
<name>Product Name</name>
</sortFields>
</citype>
</API>
XML 响应示例（截断）
<?xml version="1.0" encoding="UTF-8"?>
<API locale="en" version="1.0">
<response>
<range>
<startindex>40</startindex>
<limit>50</limit>
</range>
<result>
<statuscode>200</statuscode>
<status>Success</status>
<message>Successfully fetched.</message>
<created-date>May 10, 2013 12:52 PM</created-date>
<field-names>
<name type="String">CI Name</name>
<name type="String">CI Type</name>
<name type="String">Site</name>
<name type="String">Description</name>
</field-names>
<field-values totalRecords="14">
<record>
<value>21 (hp2650.csez.zohocorpin.com)</value>
<value>Switch Ports</value>
<value>(null)</value>
<value>Created while scanning..</value>
</record>
<!--
Truncated
.
.
.
-->
<record>
<value>10 (hp2650.csez.zohocorpin.com)</value>
<value>Switch Ports</value>
<value>(null)</value>
<value>Created while scanning..</value>
</record>
<record>
<value>1 (hp2650.csez.zohocorpin.com)</value>
<value>Switch Ports</value>
<value>(null)</value>
<value>Created while scanning..</value>
</record>
</field-values>
</result>
</response>
</API>
JSON 响应示例
{"API":{"locale":"en","response":{"":{"result":{"created-date":"May 10, 2013 12:55 PM","field-names":{"name":[{"type":"String","content":"CI Name"},{"type":"String","content":"CI Type"},{"type":"String","content":"Site"},{"type":"String","content":"Description"}]},"message":"Successfully fetched.","field-values":{"record":[{"value":["21 (hp2650.csez.zohocorpin.com)","Switch Ports","(null)","Created while scanning.."]},{"value":["20 (hp2650.csez.zohocorpin.com)","Switch Ports","(null)","Created while scanning.."]},{"value":["2 (hp2650.csez.zohocorpin.com)","Switch Ports","(null)","Created while scanning.."]},{"value":["19 (hp2650.csez.zohocorpin.com)","Switch Ports","(null)","Created while scanning.."]},{"value":["18 (hp2650.csez.zohocorpin.com)","Switch Ports","(null)","Created while scanning.."]},{"value":["17 (hp2650.csez.zohocorpin.com)","Switch Ports","(null)","Created while scanning.."]},{"value":["16 (hp2650.csez.zohocorpin.com)","Switch Ports","(null)","Created while scanning.."]},{"value":["15 (hp2650.csez.zohocorpin.com)","Switch Ports","(null)","Created while scanning.."]},{"value":["14 (hp2650.csez.zohocorpin.com)","Switch Ports","(null)","Created while scanning.."]},{"value":["13 (hp2650.csez.zohocorpin.com)","Switch Ports","(null)","Created while scanning.."]},{"value":["12 (hp2650.csez.zohocorpin.com)","Switch Ports","(null)","Created while scanning.."]},{"value":["11 (hp2650.csez.zohocorpin.com)","Switch Ports","(null)","Created while scanning.."]},{"value":["10 (hp2650.csez.zohocorpin.com)","Switch Ports","(null)","Created while scanning.."]},{"value":["1 (hp2650.csez.zohocorpin.com)","Switch Ports","(null)","Created while scanning.."]}],"totalRecords":"14"},"status":"Success","statuscode":"200"},"range":{"limit":"50","startindex":"40"},"name":"read"}},"version":"1.0"}} |