<< Click to Display Table of Contents >> 1.81给用户添加/删除组复制链接 |
支持的版本:10.0及以后
请求地址 |
http://ip:port/bi/api?action= setUsersGroups&token=xxxx |
|
请求消息 |
请求参数 |
请求参数:xmlData(必填) <?xml version="1.0" encoding="UTF-8"?> <info> <type>add</type> <users> <user> <name>test1</name> </user> <user> <name>test1</name> </user> </users> <groups> <group> <name>测试组</name> <parent>测试组1/测试组2</parent> </group> <group> <name>a组</name> <parent>a组1</parent> </group> </groups> </info> |
参数描述 |
•type:add表示给用户添加组,delete表示给用户移除组,移除组只是移除这部分用户和这些组的关联关系,不会删除组。 •users:需要配置组的用户。 •users-user-name:配置需要设置组的用户的用户名。 •groups:需要给users中的用户添加/移除的组。 •goups-group-parent:配置需要添加/移除的组的上级分组,如果这个分组直接处于根目录则此项填空。 •groups-group-name:配置需要添加/移除的组的名称。 |
|
示例 |
function setUsersGroups() { var xml = getXml(); $.post("http://" + ip + ":" + port + "/" + project + "/api?action=setUsersGroups&token=xxxx", {xmlData : xml}, function(result) { writeXml(result); }); } |
|
响应消息 |
响应结果 |
•操作成功 <?xml version="1.0" encoding="UTF-8"?> <results> <result> <level>1</level> <message>配置成功</message> </result> </results> •操作失败,用户/组重复 <?xml version="1.0" encoding="UTF-8"?> <results> <result> <level>6</level> <message>配置失败,用户{0}重复</message> </result> </results> •操作失败,不存在需要配置的用户 <?xml version="1.0" encoding="UTF-8"?> <results> <result> <level>6</level> <message>配置失败,用户{0}不存在</message> </result> </results> •操作失败,不存在的组路径 <?xml version="1.0" encoding="UTF-8"?> <results> <result> <level>6</level> <message>配置失败,路径{0}不存在</message> </result> </results> •配置失败,不存在的组 <?xml version="1.0" encoding="UTF-8"?> <results> <result> <level>6</level> <message>配置失败,目标路径下不存在组{0}</message> </result> </results> |
结果描述 |
响应结果信息为xml,直接parse即可。 •level 返回类型,不同数值代表不同返回状态,见附录。 •message为接口操作结果信息。 |