<< Click to Display Table of Contents >> 1.56 给一个角色同时添加多个用户/组,保留该角色原来的用户/组 |
版本:9.1
请求地址 |
http://ip:port/bi/api?action=setAuthentication&type=combine&token=xxxx |
|
请求消息 |
请求参数 |
请求参数:xmlData(必填) <?xml version="1.0" encoding="UTF-8"?> <info> <authentication> <type>role</type> <name>test_role</name> <users> <user> <name>test1</name> </user> <user> <name>test2</name> </user> </users> <groups> <group> <name>管理组-1</name> <parent>管理组</parent> </group> <group> <name>测试组</name> <parent>测试组1/测试组2</parent> </group> </groups> </authentication> </info> |
参数描述 |
1)authentication-type(必填):需要设置的节点类型,只有一个选项:role。 2)authentication-name(必填):需要设置节点的名称。 3)users(选填):需要给角色添加用户。 4)users-user-name(添加用户时必填):需要添加用户的名称。 5)groups(选填):需要给角色添加组。 6)groups-group-name(添加分组时必填):需要添加分组的名称。 7)groups-group-parent(添加分组时选填):需要添加分组的路径。 说明: 1)users、groups至少选填一项。 2)此方法不会覆盖原有的用户/组,在原有的基础上新增用户/组。 |
|
示例 |
function setAuthentication() { var xml = getXml(); $.post("http://" + ip + ":" + port + "/" + project + "/api?action=setAuthentication&type=combine&token=xxxx", {xmlData : xml}, function(result) { writeXml(result); }); } |
|
响应消息 |
响应结果 |
1)操作成功 <?xml version="1.0" encoding="UTF-8"?> <results> <result> <level>1</level> <message>操作成功。</message> </result> </results> 2)操作失败 <?xml version="1.0" encoding="UTF-8"?> <results> <result> <level>6</level> <message>安全设置中包含不存在的用户、组或角色:test1</message> </result> </results> |
结果描述 |
响应结果信息为xml,直接parse即可。 1)level 返回类型,不同数值代表不同返回状态,见附录。 2)message为接口操作结果信息。 |