使用匹配条件删除配置项



要使用匹配条件删除满足条件的配置项,使用以下URL:

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

假设您的ServiceDesk Plus运行在本地服务器的8080端口,则示例URL为:

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


关键参数:

  1. 操作名称 - 属性名称为:"OPERATION_NAME",值为:"delete"。

  2. 技术员密钥 - 属性名称为:"TECHNICIAN_KEY",值为:密钥的值。

 

注意:  

  • 参数: 结果格式(format - 可选项),用于指定返回信息的格式(值为xml或者json )

  • 如果不指定该参数,则API将返回JSON 格式的结果。

 

必需的参数:  

  • 使用该API,可以删除所有配置项。

  • 要删除唯一的记录,可使用<CI Type> 标记指定特定的配置项类型。

  • CI Name1 - 必填项. 配置项名称区分大小写。

  • 只能删除配置项及配置项的关系。


输入XML示例:

<?xml version="1.0" encoding="UTF-8"?>
<API version="1.0">
        <citype>
            <name>Switch Ports</name>
            <criterias>
                <criteria>
                   <parameter>  <name compOperator="CONTAINS">CI Name</name><value>1 (hp2650.csez.zohocorpin.com)</value></parameter>
                </criteria>
            </criterias>
        </citype>    
</API>

 


删除成功的应答:

<?xml version="1.0" encoding="UTF-8"?>
<API version="1.0">
        <response>
            <result>
                       <statuscode>200</statuscode>
                       <status>Success</status>
                       <message>Deleted successfully.</message>
                       <created-date>May 10, 2013 03:31 PM</created-date>
                       <records deleted="5">                       
                            <ci id="6919">1 (hp2650.csez.zohocorpin.com)</ci>
                            <ci id="6929">11 (hp2650.csez.zohocorpin.com)</ci>
                            <ci id="6939">21 (hp2650.csez.zohocorpin.com)</ci>
                            <ci id="6939">31 (hp2650.csez.zohocorpin.com)</ci>
                            <ci id="6939">41 (hp2650.csez.zohocorpin.com)</ci>
                       </records>

            <result>                   
        <response>

<API version="1.0">

 


删除失败的应答:



<?xml version="1.0" encoding="UTF-8"?>
<API locale="en" version="1.0">
<response>
<result>
            <statuscode>3018</statuscode>
            <status>No row matched to delete</status>
            <message>No row matched to delete</message>
</result>
</response>
</API>



删除打印机配置项的JSON格式的输出示例:

{
    "API": {
        "response": {
            "result": {
                "created-date": "May 10, 2013 03:41 PM",
                "records": {
                    "deleted": "6",
                    "ci": [
                        {
                            "content": "192.168.11.2",
                            "id": "1224"
                        },
                        {
                            "content": "192.168.11.23",
                            "id": "1220"
                        },
                        {
                            "content": "192.168.11.24",
                            "id": "1221"
                        },
                        {
                            "content": "192.168.11.25",
                            "id": "1222"
                        },
                        {
                            "content": "192.168.11.26",
                            "id": "1223"
                        },
                        {
                            "content": "192.168.11.29",
                            "id": "2401"
                        }
                    ]
                },
                "message": "Deleted successfully.",
                "status": "Success",
                "statuscode": "200"
            },
            "name": "delete"
        }
    },
    "version": "1.0"
}

 


SeviceDeskPlus - 帮助台和资产管理软件
Copyright © 2006-2017 卓豪(北京)技术有限公司版权所有