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

<< Click to Display Table of Contents >>

当前位置:  部署与集成 > WebAPI 

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

复制链接

支持的版本: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>

参数描述

节点参数信息:

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

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

name(必填):节点名称

注意:name和path只能存在一个。

示例

function checkNode() {

       var xml = getXml();

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

          {xmlData : xml},

          function(result) {

          writeXml(result);

       });

    }

响应消息

响应结果

操作成功

获取用户响应

<?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>

获取分组响应:

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

<results>

  <result>

      <exist>true</exist>

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

  </result>

</results>

获取角色响应:

<?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即可。

asset 为返回的节点信息。

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

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

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