<< Click to Display Table of Contents >> 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> |
参数描述 |
节点参数信息: 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为空。 |