1.51 判断用户,分组,角色是否存在

<< Click to Display Table of Contents >>

当前位置:  系统集成 > WebAPI 

1.51 判断用户,分组,角色是否存在

Previous pageReturn to chapter overviewNext page

支持的版本: 8.5.1及以后

请求地址

http://ip:port/bi/api?action=checkNode&token=xxxx

请求消息

请求参数

请求参数:xmlData(必填)

用户:

<?xml version="1.0" encoding="UTF-8"?>

<ref>

  <type>user</type>

  <path>g1/u1</path>

</ref>

或者

<?xml version="1.0" encoding="UTF-8"?>

<ref>

  <type>user</type>

  <name>u2</name>

</ref>

分组:

<?xml version="1.0" encoding="UTF-8"?>

<ref>

  <type>group</type>

  <path>g1/g1-1</path>

</ref>

角色:

<?xml version="1.0" encoding="UTF-8"?>

<ref>

  <type>role</type>

  <path>r1</path>

</ref>

或者

<?xml version="1.0" encoding="UTF-8"?>

<ref>

  <type>role</type>

  <name>r1</name>

</ref>

参数描述

节点参数信息:

1) type(必填):节点类型,包括三种:用户、组和角色。

2) path(必填):节点完整路径

3) name(必填):节点名称

备注:name和path只能存在一个

示例

function checkNode() {

        var xml = getXml();

        $.post("http://" + ip + ":" + port + "/" + project + "/api?action=checkNode&token=xxxx",

           {xmlData : xml},

           function(result) {

           writeXml(result);

        });

     }

响应消息

响应结果

操作成功

1)获取用户响应

<?xml version="1.0" encoding="UTF-8"?>

<results>

   <result>

       <exist>true</exist>

       <path>g1/u1</path>

   </result>

</results>

备注:当用户有多个分组时,path只显示其中一个分组;

或者

<?xml version="1.0" encoding="UTF-8"?>

<results>

   <result>

       <exist>true</exist>

       <path>u2</path>

   </result>

</results>

2)获取分组响应:

<?xml version="1.0" encoding="UTF-8"?>

<results>

   <result>

       <exist>true</exist>

       <path>g1/g1-1</path>

   </result>

</results>

3) 获取角色响应:

<?xml version="1.0" encoding="UTF-8"?>

<results>

   <result>

       <exist>true</exist>

       <path>r1</path>

   </result>

</results>

操作失败

<?xml version="1.0" encoding="UTF-8"?>

<results>

   <result>

       <exist>false</exist>

       <path></path>

   </result>

</results>

结果描述

响应结果信息为xml,直接parse即可。

1) asset 为返回的节点信息。

2) user,group,role:分别对应用户,组,角色信息。

3) exist 返回结果,true表示:存在,false表示:不存在

4) path 返回用户,组,角色的路径。若不存在时,path为空。