<< Click to Display Table of Contents >> 1.17 设置权限(不会覆盖之前的权限设置) |
请求地址 |
http://ip:port/bi/api?action=setPermission&type=combine&token=xxxx |
|
请求消息 |
请求参数 |
请求参数:xmlData(必填) V9.3版本支持给多个资源批量设置权限: <?xml version="1.0" encoding="UTF-8"?> <info> <perm> <refs> <ref><type>Conn</type><path>test</path></ref> <ref><type>Query</type></ref> <ref><type>Editor</type></ref> <ref><type>db</type><path>93/更多排序</path></ref> <ref><type>db</type><path>93/编辑模</path></ref> </refs> <rperm> <r><type>user</type><name>test2_groupadmin</name></r> <r><type>group</type><name>ssas</name></r> <r><type>role</type><name>everyone_role</name></r> </rperm>
<wperm> <w><type>user</type><name>test2_groupadmin</name></w> <w><type>user</type><name>yhuser</name></w> <w><type>user</type><name>Ink</name></w> </wperm> </perm> </info> 给操作设置权限: <?xml version="1.0" encoding="UTF-8"?> <info> <perm> <ref><type>Query</type></ref> <rperm> <r><type>user</type><name>u2</name></r> </rperm> </perm> </info>
|
参数描述 |
参数为节点信息: 1)ref(必填):为要设置的节点 2)refs-ref-type(必填):为要设置的节点类型,包括资源类型和操作类型(见附录)。 3)refs-ref-path(选填):要设置的节点路径,选择资源类型时,ref-path必须填写;选择操作类型时,ref-path不用填写。 4)refs-rperm(选填):读权限 5)refs-rperm-r-type(设置读权限时必填):可读取这个节点的类型,包括三种:user,group,role。 6)refs-rperm-r-name(设置读权限时必填):可读取这个节点的用户、组或者角色的名称。 7)refs-rperm-r-parent(选填):可读取这个节点的组的路径。 8)refs-wperm(选填):写权限 9)refs-wperm-w-type(设置写权限时必填):可编辑这个节点的类型,包括三种:user,group,role。 10) refs-wperm-w-name(设置写权限时必填):可编辑这个节点的用户,组,或者角色的名称。 11)refs- wperm-w-parent(选填):可编辑这个节点的组的路径。 说明: 1) rperm,wperm 至少选填一项,且都可能包含多个子节点。 2) 操作不能设置写权限。 3) 此方法不会覆盖掉之前的权限设置。 |
|
示例 |
function setPermission() { var xml = getXml(); $.post("http://" + ip + ":" + port + "/" + project + "/api?action=setPermission&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> 多个资源: <?xml version="1.0" encoding="UTF-8"?> <results> <result> <level>1</level> <message>操作成功。</message> </result> <result> <level>1</level> <message>操作成功。</message> </result> <result> <level>1</level> <message>操作成功。</message> </result> <result> <level>1</level> <message>操作成功。</message> </result> <result> <level>1</level> <message>操作成功。</message> </result> </results> 2) 操作失败 单个资源/单个操作: <?xml version="1.0" encoding="UTF-8"?> <results> <result> <level>6</level> <message>安全设置中包含不存在的用户、组或角色:admin1。</message> </result> </results> 多个资源: <?xml version="1.0" encoding="UTF-8"?> <results> <result> <level>1</level> <message>操作成功。</message> </result> <result> <level>1</level> <message>操作成功。</message> </result> <result> <level>1</level> <message>操作成功。</message> </result> <result> <level>1</level> <message>操作成功。</message> </result> <result> <level>6</level> <message>资源或操作“93/编辑模”找不到。</message> </result> </results> |
结果描述 |
响应结果信息为xml,直接parse即可。 1)level 返回类型,不同数值代表不同返回状态,见附录。 2)message为接口操作结果信息。 |